ActiveCampaign-koppling

Anslut ditt ActiveCampaign-konto till Brevo via Tajo för omfattande migrering av kontakter, synkronisering av affärspipeline, mappning av automationer och enhetlig marknadsföringsdata över båda plattformarna.

Översikt

Funktioner

• Kontaktmigrering - Migrera kontakter med anpassade fält, taggar och listmedlemskap
• Synk av affärspipeline - Synka affärsstadier, värden och ägare för intäktsspårning
• Mappning av automationer - Mappa ActiveCampaign-automationer till triggers i Brevo-flöden
• Händelsespårning - Synka webbplatsspårning och anpassade händelser för beteendebaserad segmentering
• List- och taggsynk - Replikera liststrukturer och taggbaserade segment i Brevo
• E-handelsintegration - Synka Deep Data (ordrar, kunder, kundvagnar) till Brevo
• Synk av anpassade objekt - Mappa ActiveCampaigns anpassade objekt till Brevo-attribut
• Poängsynk - Överför lead- och kontaktpoäng till Brevo-attribut

Förutsättningar

Innan du börjar, se till att du har:

1. Ett ActiveCampaign-konto (Lite, Plus, Professional eller Enterprise)
2. API-URL och API-nyckel från Settings > Developer
3. Ett Brevo-konto med API-åtkomst
4. Ett Tajo-konto

Autentisering

API-nyckelautentisering

ActiveCampaign använder en API-nyckel som skickas som header eller query-parameter.

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

Hitta din API-URL och nyckel under ActiveCampaign Settings > Developer.

Konfiguration

Grundläggande konfiguration

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

Fältmappning

Mappa ActiveCampaign-fält till Brevo-kontaktattribut:

Anpassad fältmappning

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-ändpunkter

Kontakter

Affärer

Automationer

E-handel (Deep Data)

Händelsespårning

Händelser

Kontakthändelser

Affärshändelser

Automationshändelser

Kodexempel

Initiera kopplingen

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

Migrera kontakter till 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
// }

Spåra anpassade händelser

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

API-gränser

Rate limits för ActiveCampaign API:

Ytterligare gränser:

• Bulkimport: 250 kontakter per batch
• Frekvens för bulkimport: 1 import i taget
• Händelsespårning: 2 förfrågningar/sekund
• Daglig gräns: Ingen explicit daglig gräns (endast ratebaserad)

Felsökning

Vanliga problem

Debug-läge

Aktivera utförlig loggning:

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

Testa anslutningen

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

Bästa praxis

1. Använd ändpunkten contact sync - Använd /contact/sync för upsert-operationer istället för separat skapa/uppdatera
2. Mappa fält efter ID - ID:n för anpassade fält är stabila; etiketter kan ändras
3. Bevara listmedlemskap - Migrera listtilldelningar tillsammans med kontaktdatan
4. Synka affärspipelines - Mappa pipeline-stadier för konsekvent CRM-rapportering
5. Implementera händelsespårning - Använd webbplatsspårning för beteendedata i Brevo
6. Batcha importer - Använd bulkimport för datamängder större än 1 000 kontakter

Säkerhet

• API-nyckelautentisering - Tokenbaserad åtkomst via Api-Token-headern
• Webhook-verifiering - Validera webhook-källans IP-intervall
• TLS-kryptering - All API-kommunikation krypteras via HTTPS
• Åtkomst på kontonivå - API-nyckeln ger fullständig kontoåtkomst; använd med försiktighet
• IP-begränsningar - Tillgängligt på Enterprise-planer

Relaterade resurser

• ActiveCampaign API-dokumentation
• ActiveCampaign Webhook-guide
• Mailchimp-koppling
• Brevo-koppling
• Skill för kundsynk