Conector Mailchimp

Conecte sua conta Mailchimp ao Brevo via Tajo para migração de audiência sem atrito, sincronização de dados de campanha e automação de marketing unificada entre as duas plataformas.

Visão geral

Recursos

• Sincronização de audiência - Migre e sincronize audiências do Mailchimp com listas de contato do Brevo
• Dados de campanha - Sincronize dados de desempenho de campanha para relatórios unificados
• Migração de automações - Mapeie automações do Mailchimp para workflows do Brevo
• Métricas de engajamento - Sincronize dados de abertura, clique e bounce para atributos do Brevo
• Mapeamento de segmentos - Replique segmentos do Mailchimp como listas ou segmentos do Brevo
• Dados de e-commerce - Sincronize dados de loja, produto e pedido do Mailchimp e-commerce
• Sincronização de tags - Mapeie tags do Mailchimp para atributos ou listas de contato do Brevo
• Migração de templates - Exporte templates do Mailchimp para uso em campanhas do Brevo

Pré-requisitos

Antes de começar, certifique-se de ter:

1. Uma conta Mailchimp (Free, Essentials, Standard ou Premium)
2. Uma chave API do Mailchimp ou app OAuth
3. Uma conta Brevo com acesso à API
4. Uma conta Tajo

Autenticação

Autenticação por chave API

Gere uma chave API em Mailchimp Account > Extras > API Keys.

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

O prefixo de data center {dc} é a última parte da sua chave API (por exemplo, us21).

OAuth 2.0

Para integrações multi-conta:

# 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}"

Configuração

Configuração 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

Mapeamento de campos

Mapeie merge fields do Mailchimp para atributos de contato do Brevo:

Mapeamento 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 da API

Audiências (Listas)

Campanhas

Automações

E-commerce

Eventos

Eventos de campanha

Eventos de assinante

Eventos de e-commerce

Exemplos de código

Inicializar o 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 audiências para o 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 dados de engajamento de campanha

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

Limites de taxa

Limites de taxa da Mailchimp Marketing API:

Solução de problemas

Problemas comuns

Modo de depuração

Ative o log detalhado:

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

Testar conexão

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

Melhores práticas

1. Use operações em lote - Use subscribe/unsubscribe em lote para atualizações em massa
2. Preserve o status do assinante - Respeite o consentimento de inscrição durante a migração
3. Mapeie merge fields primeiro - Crie os atributos correspondentes no Brevo antes de sincronizar
4. Sincronize dados de engajamento - Importe taxas de abertura/clique para segmentação histórica
5. Trate estados de conformidade - Respeite estados GDPR e de exclusão permanente
6. Use sincronização incremental - Sincronize apenas alterações desde a última sincronização para reduzir o uso da API

Segurança

• Autenticação por chave API - Chave secreta passada como senha HTTP Basic Auth
• OAuth 2.0 - Autorização baseada em token para acesso multi-conta
• Criptografia TLS - Toda comunicação com a API é criptografada via HTTPS
• Verificação de webhook - Valide a origem do webhook com segredo compartilhado
• Isolamento de data center - Dados armazenados em data centers regionais específicos

Recursos relacionados

• Referência da Mailchimp Marketing API
• Guias da API do Mailchimp
• Conector Brevo
• Conector ActiveCampaign
• Skill de sincronização de clientes