Connecteur ActiveCampaign

Connectez votre compte ActiveCampaign à Brevo via Tajo pour une migration complète des contacts, une synchronisation du pipeline de transactions, un mappage des automatisations et des données marketing unifiées sur les deux plateformes.

Vue d’ensemble

Fonctionnalités

• Migration des contacts, Migrez les contacts avec leurs champs personnalisés, tags et abonnements aux listes
• Synchronisation du pipeline de transactions, Synchronisez étapes, montants et propriétaires pour le suivi des revenus
• Mappage des automatisations, Mappez les automatisations ActiveCampaign vers les déclencheurs de workflow Brevo
• Suivi des événements, Synchronisez le site tracking et les événements personnalisés pour la segmentation comportementale
• Synchronisation des listes et tags, Répliquez les structures de listes et les segments basés sur les tags dans Brevo
• Intégration e-commerce, Synchronisez les Deep Data (commandes, clients, paniers) vers Brevo
• Synchronisation d’objets personnalisés, Mappez les objets personnalisés ActiveCampaign vers des attributs Brevo
• Synchronisation des scores, Transférez les scores de lead et de contact vers des attributs Brevo

Prérequis

Avant de commencer, assurez-vous de disposer de :

1. Un compte ActiveCampaign (Lite, Plus, Professional ou Enterprise)
2. L’URL API et la clé API depuis Settings > Developer
3. Un compte Brevo avec accès API
4. Un compte Tajo

Authentification

Authentification par clé API

ActiveCampaign utilise une clé API transmise dans un en-tête ou en paramètre de requête.

curl "https://{account}.api-us1.com/api/3/contacts" \
  -H "Api-Token: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Retrouvez votre URL API et votre clé dans ActiveCampaign Settings > Developer.

Configuration

Configuration de base

connectors:
  activecampaign:
    enabled: true
    api_url: "https://yourcompany.api-us1.com"
    api_key: "${AC_API_KEY}"

    # Data sync options
    sync:
      contacts: true
      deals: true
      automations: true
      events: true
      ecommerce: true

    # List mapping to Brevo
    list_mapping:
      "Main List": 50
      "Newsletter": 51
      "Customers": 52

Mappage des champs

Mappez les champs ActiveCampaign vers les attributs de contact Brevo :

Mappage des champs personnalisés

field_mapping:
  # Standard fields
  email: email
  firstName: FIRSTNAME
  lastName: LASTNAME
  phone: SMS

  # Engagement fields
  score: LEAD_SCORE
  rating: ENGAGEMENT_RATING

  # Deal fields
  deals.value: DEAL_VALUE
  deals.stage: DEAL_STAGE
  deals.owner: DEAL_OWNER

  # Custom fields
  fieldValues.company: COMPANY_NAME
  fieldValues.industry: INDUSTRY
  fieldValues.plan_tier: PLAN_TIER

Endpoints API

Contacts

Transactions

Automatisations

E-commerce (Deep Data)

Suivi d’événements

Événements

Événements de contact

Événements de transaction

Événements d’automatisation

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

// Connect ActiveCampaign
await tajo.connectors.connect('activecampaign', {
  apiUrl: process.env.AC_API_URL,
  apiKey: process.env.AC_API_KEY
});

Migrer les contacts vers Brevo

// Full contact migration with custom fields and tags
await tajo.connectors.sync('activecampaign', {
  type: 'full',
  resources: ['contacts', 'deals', 'events'],
  options: {
    includeTags: true,
    includeCustomFields: true,
    includeScores: true,
    includeListMemberships: true
  }
});

// Check sync status
const status = await tajo.connectors.status('activecampaign');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-01-15T10:30:00Z',
//   contactsMigrated: 28000,
//   dealsSynced: 4500,
//   eventsSynced: 120000
// }

Suivre des événements personnalisés

// Forward ActiveCampaign events to Brevo
await tajo.activecampaign.trackEvent({
  email: '[email protected]',
  event: 'product_demo_requested',
  eventData: {
    product: 'Enterprise Plan',
    source: 'website'
  }
});

Limites de débit

Limites de débit de l’API ActiveCampaign :

Limites supplémentaires :

• Import en masse : 250 contacts par lot
• Fréquence d’import en masse : 1 import à la fois
• Suivi d’événements : 2 requêtes/seconde
• Limite quotidienne : aucune limite quotidienne explicite (uniquement basée sur le débit)

Dépannage

Problèmes courants

Mode débogage

Activez la journalisation détaillée :

connectors:
  activecampaign:
    debug: true
    log_level: verbose
    log_webhooks: true

Tester la connexion

tajo connectors test activecampaign
# ✓ API connection successful
# ✓ Contacts readable
# ✓ Deals readable
# ✓ Automations accessible
# ✓ Event tracking enabled

Bonnes pratiques

1. Utilisez l’endpoint contact sync, Utilisez /contact/sync pour les opérations upsert plutôt que création/mise à jour séparées
2. Mappez les champs par ID, Les IDs de champ personnalisé sont stables ; les labels peuvent changer
3. Préservez les abonnements aux listes, Migrez les affectations de listes avec les données de contact
4. Synchronisez les pipelines de transactions, Mappez les étapes de pipeline pour un reporting CRM cohérent
5. Implémentez le suivi d’événements, Utilisez le site tracking pour les données comportementales dans Brevo
6. Imports par lot, Utilisez l’import en masse pour les jeux de données de plus de 1 000 contacts

Sécurité

• Authentification par clé API, Accès par jeton via l’en-tête Api-Token
• Vérification des webhooks, Validez les plages d’IP sources des webhooks
• Chiffrement TLS, Toutes les communications API chiffrées via HTTPS
• Accès au niveau du compte, La clé API offre un accès complet au compte ; à utiliser avec précaution
• Restrictions d’IP, Disponibles sur les plans Enterprise

Ressources associées

• Documentation de l’API ActiveCampaign
• Guide des webhooks ActiveCampaign
• Connecteur Mailchimp
• Connecteur Brevo
• Skill Customer Sync