Conector de Mailchimp

Conecta tu cuenta de Mailchimp con Brevo a través de Tajo para una migración fluida de audiencias, sincronización de datos de campañas y automatización de marketing unificada entre ambas plataformas.

Resumen

Funcionalidades

• Sincronización de audiencias - Migra y sincroniza las audiencias de Mailchimp con las listas de contactos de Brevo
• Datos de campaña - Sincroniza los datos de rendimiento de campañas para un reporting unificado
• Migración de automatizaciones - Asocia las automatizaciones de Mailchimp con workflows de Brevo
• Métricas de engagement - Sincroniza aperturas, clics y rebotes como atributos de Brevo
• Mapeo de segmentos - Replica los segmentos de Mailchimp como listas o segmentos de Brevo
• Datos eCommerce - Sincroniza datos de tienda, producto y pedidos desde Mailchimp eCommerce
• Sincronización de etiquetas - Asocia etiquetas de Mailchimp con atributos de contacto o listas de Brevo
• Migración de plantillas - Exporta plantillas de Mailchimp para usarlas en campañas de Brevo

Requisitos previos

Antes de empezar, asegúrate de tener:

1. Una cuenta de Mailchimp (Free, Essentials, Standard o Premium)
2. Una clave API o una app OAuth de Mailchimp
3. Una cuenta de Brevo con acceso a la API
4. Una cuenta de Tajo

Autenticación

Autenticación con clave API

Genera una clave API desde Mailchimp Account > Extras > API Keys.

curl https://{dc}.api.mailchimp.com/3.0/ping \
  --user "anystring:{api_key}" \
  -H "Content-Type: application/json"

El prefijo de data center {dc} es la última parte de tu clave API (por ejemplo, us21).

OAuth 2.0

Para integraciones multi-cuenta:

# Authorization URL
https://login.mailchimp.com/oauth2/authorize?
  response_type=code&
  client_id={client_id}&
  redirect_uri={redirect_uri}

# Token exchange
curl -X POST https://login.mailchimp.com/oauth2/token \
  -d "grant_type=authorization_code" \
  -d "client_id={client_id}" \
  -d "client_secret={client_secret}" \
  -d "redirect_uri={redirect_uri}" \
  -d "code={auth_code}"

Configuración

Configuración básica

connectors:
  mailchimp:
    enabled: true
    api_key: "${MAILCHIMP_API_KEY}"
    data_center: "us21"

    # Data sync options
    sync:
      audiences: true
      campaigns: true
      automations: true
      ecommerce: true

    # Audience to Brevo list mapping
    audience_mapping:
      "Main Audience": 40
      "Newsletter": 41
      "Customers": 42

Asignación de campos

Asocia los merge fields de Mailchimp con los atributos de contacto de Brevo:

Asignación de merge fields personalizados

field_mapping:
  # Standard fields
  email_address: email
  FNAME: FIRSTNAME
  LNAME: LASTNAME
  PHONE: SMS

  # Engagement metrics
  stats.avg_open_rate: AVG_OPEN_RATE
  stats.avg_click_rate: AVG_CLICK_RATE
  member_rating: ENGAGEMENT_SCORE

  # E-commerce fields
  ecommerce_data.total_revenue: TOTAL_REVENUE
  ecommerce_data.number_of_orders: ORDER_COUNT

  # Custom merge fields
  MMERGE5: COMPANY_NAME
  MMERGE6: CUSTOMER_TYPE

Endpoints de la API

Audiencias (listas)

Campañas

Automatizaciones

eCommerce

Eventos

Eventos de campaña

Eventos de suscriptor

Eventos eCommerce

Ejemplos de código

Inicializar el conector

import { TajoClient } from '@tajo/sdk';

const tajo = new TajoClient({
  apiKey: process.env.TAJO_API_KEY,
  brevoApiKey: process.env.BREVO_API_KEY
});

// Connect Mailchimp
await tajo.connectors.connect('mailchimp', {
  apiKey: process.env.MAILCHIMP_API_KEY
});

Migrar audiencias a Brevo

// Full audience migration from Mailchimp to Brevo
await tajo.connectors.sync('mailchimp', {
  type: 'full',
  resources: ['audiences', 'campaigns', 'ecommerce'],
  options: {
    preserveTags: true,
    migrateSegments: true,
    includeUnsubscribed: false
  }
});

// Check migration status
const status = await tajo.connectors.status('mailchimp');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-01-15T10:30:00Z',
//   contactsMigrated: 52000,
//   campaignsSynced: 245,
//   segmentsMapped: 18
// }

Sincronizar datos de engagement de campañas

// Sync campaign performance to Brevo attributes
await tajo.connectors.sync('mailchimp', {
  type: 'incremental',
  resources: ['campaigns'],
  options: {
    syncEngagement: true,
    updateContactMetrics: true,
    since: '2024-01-01'
  }
});

Límites de velocidad

Límites de velocidad de la Marketing API de Mailchimp:

Resolución de problemas

Problemas habituales

Modo depuración

Activa el registro detallado:

connectors:
  mailchimp:
    debug: true
    log_level: verbose
    log_api_calls: true

Probar la conexión

tajo connectors test mailchimp
# ✓ API connection successful
# ✓ Audiences readable
# ✓ Campaigns readable
# ✓ E-commerce data accessible
# ✓ Webhook configured

Buenas prácticas

1. Usa operaciones por lote - Usa batch subscribe/unsubscribe para actualizaciones masivas
2. Preserva el estado del suscriptor - Respeta el consentimiento de suscripción durante la migración
3. Asocia primero los merge fields - Crea los atributos correspondientes en Brevo antes de sincronizar
4. Sincroniza datos de engagement - Importa tasas de apertura/clic para segmentación histórica
5. Gestiona los estados de cumplimiento - Respeta los estados de RGPD y eliminación permanente
6. Usa sincronización incremental - Sincroniza solo los cambios desde la última sincronización para reducir el uso de la API

Seguridad

• Autenticación con clave API - Clave secreta enviada como contraseña de HTTP Basic Auth
• OAuth 2.0 - Autorización basada en tokens para acceso multi-cuenta
• Cifrado TLS - Toda la comunicación con la API se cifra vía HTTPS
• Verificación de webhooks - Valida el origen del webhook con un secreto compartido
• Aislamiento por data center - Datos almacenados en data centers específicos por región

Recursos relacionados

• Referencia de la Marketing API de Mailchimp
• Guías de la API de Mailchimp
• Conector de Brevo
• Conector de ActiveCampaign
• Skill de sincronización de clientes