Connecteur Mailchimp

Connectez votre compte Mailchimp à Brevo via Tajo pour une migration fluide des audiences, la synchronisation des données de campagnes, et une automatisation marketing unifiée sur les deux plateformes.

Vue d’ensemble

Fonctionnalités

• Synchronisation d’audiences - Migration et synchronisation des audiences Mailchimp avec les listes de contacts Brevo
• Données de campagnes - Synchronisation des données de performance des campagnes pour un reporting unifié
• Migration d’automatisations - Mappage des automatisations Mailchimp vers les workflows Brevo
• Métriques d’engagement - Synchronisation des ouvertures, clics et rebonds vers les attributs Brevo
• Mappage de segments - Réplication des segments Mailchimp en tant que listes ou segments Brevo
• Données e-commerce - Synchronisation des données de boutique, produits et commandes depuis Mailchimp e-commerce
• Synchronisation des tags - Mappage des tags Mailchimp vers les attributs ou listes de contacts Brevo
• Migration de templates - Export des templates Mailchimp pour utilisation dans les campagnes Brevo

Prérequis

Avant de commencer, assurez-vous d’avoir :

1. Un compte Mailchimp (Free, Essentials, Standard ou Premium)
2. Une clé API Mailchimp ou une application OAuth
3. Un compte Brevo avec accès API
4. Un compte Tajo

Authentification

Authentification par clé API

Générez une clé API depuis Mailchimp Account > Extras > API Keys.

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

Le préfixe de data center {dc} est la dernière partie de votre clé API (ex. us21).

OAuth 2.0

Pour les intégrations multi-comptes :

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

# Échange de jeton
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}"

Configuration

Configuration de base

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

    # Options de synchronisation des données
    sync:
      audiences: true
      campaigns: true
      automations: true
      ecommerce: true

    # Mappage audience vers liste Brevo
    audience_mapping:
      "Main Audience": 40
      "Newsletter": 41
      "Customers": 42

Mappage de champs

Mappez les merge fields Mailchimp aux attributs de contact Brevo :

Mappage personnalisé des merge fields

field_mapping:
  # Champs standards
  email_address: email
  FNAME: FIRSTNAME
  LNAME: LASTNAME
  PHONE: SMS

  # Métriques d'engagement
  stats.avg_open_rate: AVG_OPEN_RATE
  stats.avg_click_rate: AVG_CLICK_RATE
  member_rating: ENGAGEMENT_SCORE

  # Champs e-commerce
  ecommerce_data.total_revenue: TOTAL_REVENUE
  ecommerce_data.number_of_orders: ORDER_COUNT

  # Merge fields personnalisés
  MMERGE5: COMPANY_NAME
  MMERGE6: CUSTOMER_TYPE

Endpoints API

Audiences (Listes)

Campagnes

Automatisations

E-commerce

Événements

Événements de campagne

Événements d’abonné

Événements e-commerce

Exemples de code

Initialiser le connecteur

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

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

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

Migrer les audiences vers Brevo

// Migration complète d'audience de Mailchimp vers Brevo
await tajo.connectors.sync('mailchimp', {
  type: 'full',
  resources: ['audiences', 'campaigns', 'ecommerce'],
  options: {
    preserveTags: true,
    migrateSegments: true,
    includeUnsubscribed: false
  }
});

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

Synchroniser les données d’engagement des campagnes

// Synchroniser la performance des campagnes vers les attributs Brevo
await tajo.connectors.sync('mailchimp', {
  type: 'incremental',
  resources: ['campaigns'],
  options: {
    syncEngagement: true,
    updateContactMetrics: true,
    since: '2024-01-01'
  }
});

Limites de taux

Limites de taux de l’API Marketing Mailchimp :

Dépannage

Problèmes courants

Mode debug

Activer la journalisation détaillée :

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

Tester la connexion

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

Bonnes pratiques

1. Utilisez les opérations batch - Utilisez l’abonnement/désabonnement en batch pour les mises à jour en masse
2. Préservez le statut d’abonné - Respectez le consentement d’abonnement pendant la migration
3. Mappez les merge fields en premier - Créez les attributs Brevo correspondants avant la synchronisation
4. Synchronisez les données d’engagement - Importez les taux d’ouverture/clic pour la segmentation historique
5. Gérez les états de conformité - Respectez le RGPD et les états de suppression permanente
6. Utilisez la synchronisation incrémentielle - Synchronisez uniquement les changements depuis la dernière synchronisation pour réduire l’utilisation API

Sécurité

• Authentification par clé API - Clé secrète transmise comme mot de passe HTTP Basic Auth
• OAuth 2.0 - Autorisation par jetons pour l’accès multi-comptes
• Chiffrement TLS - Toutes les communications API chiffrées via HTTPS
• Vérification de webhook - Validation de la source des webhooks avec un secret partagé
• Isolation des data centers - Données stockées dans des data centers spécifiques à la région

Ressources liées

• Référence API Mailchimp Marketing
• Guides API Mailchimp
• Connecteur Brevo
• Connecteur ActiveCampaign
• Compétence de synchronisation client