ActiveCampaign Connector

Verbinde dein ActiveCampaign-Konto über Tajo mit Brevo für eine umfassende Kontaktmigration, Deal-Pipeline-Synchronisation, Automations-Mapping und plattformübergreifend einheitliche Marketingdaten.

Überblick

Funktionen

• Kontaktmigration - Migriere Kontakte inklusive Custom Fields, Tags und Listenmitgliedschaften
• Deal-Pipeline-Synchronisation - Synchronisiere Deal-Phasen, -Werte und -Verantwortliche für das Umsatz-Tracking
• Automations-Mapping - Ordne ActiveCampaign-Automationen den Brevo-Workflow-Triggern zu
• Event-Tracking - Synchronisiere Site-Tracking und Custom Events für eine verhaltensbasierte Segmentierung
• Listen- und Tag-Synchronisation - Repliziere Listenstrukturen und tag-basierte Segmente in Brevo
• E-Commerce-Integration - Synchronisiere Deep Data (Orders, Customers, Carts) zu Brevo
• Custom-Object-Sync - Ordne ActiveCampaign-Custom-Objects den Brevo-Attributen zu
• Score-Synchronisation - Übertrage Lead- und Kontakt-Scores in Brevo-Attribute

Voraussetzungen

Bevor du beginnst, stelle sicher, dass du Folgendes hast:

1. Ein ActiveCampaign-Konto (Lite, Plus, Professional oder Enterprise)
2. API-URL und API-Schlüssel aus Settings > Developer
3. Ein Brevo-Konto mit API-Zugriff
4. Ein Tajo-Konto

Authentifizierung

API-Schlüssel-Authentifizierung

ActiveCampaign nutzt einen API-Schlüssel, der als Header oder Query-Parameter übergeben wird.

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

Du findest deine API-URL und deinen API-Schlüssel in den ActiveCampaign-Einstellungen unter Settings > Developer.

Konfiguration

Grundeinrichtung

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

Feldzuordnung

Ordne ActiveCampaign-Felder den Brevo-Kontaktattributen zu:

Zuordnung benutzerdefinierter Felder

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

API-Endpunkte

Kontakte

Deals

Automationen

E-Commerce (Deep Data)

Event-Tracking

Events

Kontakt-Events

Deal-Events

Automation-Events

Code-Beispiele

Connector initialisieren

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

Kontakte zu Brevo migrieren

// 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
// }

Custom Events tracken

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

Rate Limits

Rate Limits der ActiveCampaign-API:

Weitere Limits:

• Bulk-Import: 250 Kontakte pro Batch
• Bulk-Import-Frequenz: 1 Import gleichzeitig
• Event-Tracking: 2 Anfragen/Sekunde
• Tageslimit: Kein explizites Tageslimit (nur ratenbasiert)

Fehlerbehebung

Häufige Probleme

Debug-Modus

Ausführliches Logging aktivieren:

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

Verbindung testen

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

Best Practices

1. Contact-Sync-Endpoint nutzen - Verwende /contact/sync für Upsert-Operationen statt getrennter Create-/Update-Aufrufe
2. Felder per ID zuordnen - IDs von Custom Fields sind stabil; Labels können sich ändern
3. Listenmitgliedschaften bewahren - Migriere Listenzuordnungen gemeinsam mit den Kontaktdaten
4. Deal-Pipelines synchronisieren - Ordne Pipeline-Phasen für ein konsistentes CRM-Reporting zu
5. Event-Tracking umsetzen - Nutze Site-Tracking, um verhaltensbasierte Daten in Brevo zu erhalten
6. Batch-Importe verwenden - Nutze Bulk-Import für Datensätze mit mehr als 1.000 Kontakten

Sicherheit

• API-Schlüssel-Authentifizierung - Token-basierter Zugriff über den Api-Token-Header
• Webhook-Verifizierung - Prüfe die Quell-IP-Bereiche von Webhooks
• TLS-Verschlüsselung - Die gesamte API-Kommunikation wird via HTTPS verschlüsselt
• Zugriff auf Kontoebene - Der API-Schlüssel bietet vollen Kontozugriff; gehe sorgsam damit um
• IP-Beschränkungen - Verfügbar in Enterprise-Plänen

Verwandte Ressourcen

• ActiveCampaign API-Dokumentation
• ActiveCampaign Webhook-Leitfaden
• Mailchimp Connector
• Brevo Connector
• Customer-Sync-Skill