Mailchimp-connector

Verbind je Mailchimp-account met Brevo via Tajo voor naadloze audience-migratie, campagnedatasynchronisatie en uniforme marketingautomatisering over beide platforms.

Overzicht

Functies

• Audience-sync - Migreer en synchroniseer Mailchimp-audiences met Brevo-contactlijsten
• Campagnedata - Synchroniseer campagneprestatiedata voor uniforme rapportage
• Automation-migratie - Koppel Mailchimp-automatiseringen aan Brevo-workflows
• Engagement-metrics - Synchroniseer opens, clicks en bounce-data naar Brevo-attributen
• Segmentkoppeling - Repliceer Mailchimp-segmenten als Brevo-lijsten of -segmenten
• E-commercedata - Synchroniseer store-, product- en orderdata uit Mailchimp e-commerce
• Tag-sync - Koppel Mailchimp-tags aan Brevo-contactattributen of -lijsten
• Templatemigratie - Exporteer Mailchimp-templates voor gebruik in Brevo-campagnes

Vereisten

Voordat je begint, zorg dat je beschikt over:

1. Een Mailchimp-account (Free, Essentials, Standard of Premium)
2. Een Mailchimp API-sleutel of OAuth-app
3. Een Brevo-account met API-toegang
4. Een Tajo-account

Authenticatie

API-sleutel-authenticatie

Genereer een API-sleutel via Mailchimp Account > Extras > API Keys.

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

De {dc}-datacenterprefix is het laatste deel van je API-sleutel (bijv. us21).

OAuth 2.0

Voor multi-account-integraties:

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

Configuratie

Basisopzet

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

Veldmapping

Koppel Mailchimp-mergevelden aan Brevo-contactattributen:

Custom merge field-mapping

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

API-endpoints

Audiences (lists)

Campagnes

Automatiseringen

E-commerce

Events

Campagne-events

Abonnee-events

E-commerce-events

Codevoorbeelden

Connector initialiseren

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
});

Audiences migreren naar 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
// }

Campagne-engagementdata synchroniseren

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

Ratelimits

Mailchimp Marketing API-ratelimits:

Probleemoplossing

Veelvoorkomende problemen

Debugmodus

Activeer uitgebreide logging:

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

Verbinding testen

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

Best practices

1. Gebruik batch-operaties - Gebruik batch-subscribe/unsubscribe voor bulkupdates
2. Behoud abonnementsstatus - Respecteer toestemming tijdens migratie
3. Koppel merge-velden eerst - Maak overeenkomstige Brevo-attributen vóór de sync
4. Synchroniseer engagementdata - Importeer open/click-rates voor historische segmentatie
5. Handel compliancestatussen correct af - Respecteer AVG en permanente verwijderstatussen
6. Gebruik incremental sync - Synchroniseer alleen wijzigingen sinds de laatste sync om API-verbruik te beperken

Beveiliging

• API-sleutel-authenticatie - Secret key meegegeven als HTTP Basic Auth-wachtwoord
• OAuth 2.0 - Tokengebaseerde autorisatie voor multi-accounttoegang
• TLS-encryptie - Alle API-communicatie versleuteld via HTTPS
• Webhook-verificatie - Valideer webhook-bron met shared secret
• Datacenter-isolatie - Data opgeslagen in regiospecifieke datacenters

Gerelateerde resources

• Mailchimp Marketing API Reference
• Mailchimp API Guides
• Brevo-connector
• ActiveCampaign-connector
• Customer Sync-skill