ActiveCampaign Connector

Forbind din ActiveCampaign-konto til Brevo via Tajo for omfattende kontaktmigrering, synkronisering af deal-pipelines, automatiseringsmapping og forenede marketingdata på tværs af begge platforme.

Oversigt

Funktioner

• Kontaktmigrering - Migrér kontakter med brugerdefinerede felter, tags og listemedlemskaber
• Synkronisering af deal-pipeline - Synkronisér dealfaser, værdier og ejere til omsætningssporing
• Automatiseringsmapping - Knyt ActiveCampaign-automatiseringer til Brevo-workflow-triggere
• Hændelsessporing - Synkronisér site-tracking og brugerdefinerede hændelser til adfærdssegmentering
• Liste- og tagsynkronisering - Replicér listestrukturer og tagbaserede segmenter i Brevo
• E-handelsintegration - Synkronisér Deep Data (ordrer, kunder, kurve) til Brevo
• Synkronisering af brugerdefinerede objekter - Knyt ActiveCampaign-brugerdefinerede objekter til Brevo-attributter
• Score-synkronisering - Overfør lead- og kontaktscores til Brevo-attributter

Forudsætninger

Før du begynder, skal du sikre dig, at du har:

1. En ActiveCampaign-konto (Lite, Plus, Professional eller Enterprise)
2. API URL og API-nøgle fra Settings > Developer
3. En Brevo-konto med API-adgang
4. En Tajo-konto

Autentifikation

API-nøgle-autentifikation

ActiveCampaign bruger en API-nøgle sendt som en header eller query-parameter.

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

Find din API-URL og -nøgle i ActiveCampaign Settings > Developer.

Konfiguration

Grundlæggende opsætning

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

Feltmapping

Knyt ActiveCampaign-felter til Brevo-kontaktattributter:

Brugerdefineret feltmapping

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-endpoints

Kontakter

Deals

Automatiseringer

E-handel (Deep Data)

Hændelsessporing

Hændelser

Kontakthændelser

Deal-hændelser

Automatiseringshændelser

Kodeeksempler

Initialisér konnektor

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

Migrér kontakter til 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
// }

Spor brugerdefinerede hændelser

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

Ratebegrænsninger

ActiveCampaign API-ratebegrænsninger:

Yderligere grænser:

• Bulk-import: 250 kontakter per batch
• Bulk-importfrekvens: 1 import ad gangen
• Hændelsessporing: 2 forespørgsler/sekund
• Daglig grænse: Ingen eksplicit daglig grænse (kun ratebaseret)

Fejlfinding

Almindelige problemer

Fejlfindingstilstand

Aktivér udførlig logning:

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

Test forbindelse

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

Best practices

1. Brug contact sync-endpoint - Brug /contact/sync til upsert-operationer i stedet for separat opret/opdatér
2. Map felter efter id - Brugerdefinerede felt-id’er er stabile; labels kan ændres
3. Bevar listemedlemskaber - Migrér listetildelinger sammen med kontaktdata
4. Synkronisér deal-pipelines - Map pipeline-faser til konsekvent CRM-rapportering
5. Implementér hændelsessporing - Brug site-tracking til adfærdsdata i Brevo
6. Batch-importer - Brug bulk-import til datasæt større end 1.000 kontakter

Sikkerhed

• API-nøgle-autentifikation - Tokenbaseret adgang via Api-Token-header
• Webhook-verifikation - Validér webhook-kildens IP-intervaller
• TLS-kryptering - Al API-kommunikation krypteret via HTTPS
• Adgang på kontoniveau - API-nøglen giver fuld kontoadgang; brug med omtanke
• IP-restriktioner - Tilgængelig på Enterprise-planer

Relaterede ressourcer

• ActiveCampaign API-dokumentation
• ActiveCampaign Webhook-guide
• Mailchimp Connector
• Brevo Connector
• Customer Sync Skill