ActiveCampaign-kobling

Koble ActiveCampaign-kontoen din til Brevo via Tajo for omfattende kontaktmigrering, synkronisering av avtalepipeline, automatiseringsmapping og enhetlige markedsføringsdata på tvers av begge plattformene.

Oversikt

Funksjoner

• Kontaktmigrering - Migrer kontakter med egendefinerte felt, tagger og listemedlemskap
• Synkronisering av avtalepipeline - Synkroniser avtalesteg, verdier og eiere for inntektssporing
• Automatiseringsmapping - Mapp ActiveCampaign-automatiseringer til Brevo-arbeidsflytutløsere
• Hendelsessporing - Synkroniser nettstedssporing og egendefinerte hendelser for atferdssegmentering
• Liste- og tag-synkronisering - Replikér listestrukturer og tag-baserte segmenter i Brevo
• E-handelsintegrasjon - Synkroniser Deep Data (ordrer, kunder, handlekurver) til Brevo
• Synkronisering av egendefinerte objekter - Mapp ActiveCampaign egendefinerte objekter til Brevo-attributter
• Score-synkronisering - Overfør lead- og kontaktscoringer til Brevo-attributter

Forutsetninger

Før du begynner, sørg for at du har:

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

Autentisering

API-nøkkelautentisering

ActiveCampaign bruker en API-nøkkel som sendes som en header eller en query-parameter.

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

Finn API-URL-en og -nøkkelen din i ActiveCampaign Settings > Developer.

Konfigurasjon

Grunnleggende oppsett

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

    # Synkroniseringsalternativer
    sync:
      contacts: true
      deals: true
      automations: true
      events: true
      ecommerce: true

    # Listemapping til Brevo
    list_mapping:
      "Main List": 50
      "Newsletter": 51
      "Customers": 52

Feltmapping

Mapp ActiveCampaign-felt til Brevo-kontaktattributter:

Mapping av egendefinerte felt

field_mapping:
  # Standardfelt
  email: email
  firstName: FIRSTNAME
  lastName: LASTNAME
  phone: SMS

  # Engasjementsfelt
  score: LEAD_SCORE
  rating: ENGAGEMENT_RATING

  # Avtalefelt
  deals.value: DEAL_VALUE
  deals.stage: DEAL_STAGE
  deals.owner: DEAL_OWNER

  # Egendefinerte felt
  fieldValues.company: COMPANY_NAME
  fieldValues.industry: INDUSTRY
  fieldValues.plan_tier: PLAN_TIER

API-endepunkter

Kontakter

Avtaler

Automatiseringer

E-handel (Deep Data)

Hendelsessporing

Hendelser

Kontakthendelser

Avtalehendelser

Automatiseringshendelser

Kodeeksempler

Initialiser kobling

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

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

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

Migrer kontakter til Brevo

// Fullstendig kontaktmigrering med egendefinerte felt og tagger
await tajo.connectors.sync('activecampaign', {
  type: 'full',
  resources: ['contacts', 'deals', 'events'],
  options: {
    includeTags: true,
    includeCustomFields: true,
    includeScores: true,
    includeListMemberships: true
  }
});

// Sjekk synkroniseringsstatus
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 egendefinerte hendelser

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

Ratebegrensninger

ActiveCampaign API-ratebegrensninger:

Ytterligere grenser:

• Bulkimport: 250 kontakter per batch
• Bulkimportfrekvens: 1 import om gangen
• Hendelsessporing: 2 forespørsler/sekund
• Daglig grense: Ingen eksplisitt daglig grense (kun rate-basert)

Feilsøking

Vanlige problemer

Feilsøkingsmodus

Aktiver utvidet logging:

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

Test tilkobling

tajo connectors test activecampaign
# ✓ API-tilkobling vellykket
# ✓ Kontakter lesbare
# ✓ Avtaler lesbare
# ✓ Automatiseringer tilgjengelig
# ✓ Hendelsessporing aktivert

Beste praksis

1. Bruk kontaktsynkroniseringsendepunktet - Bruk /contact/sync for upsert-operasjoner i stedet for separate opprett/oppdater
2. Mapp felt etter ID - Egendefinerte felt-ID-er er stabile; etiketter kan endres
3. Bevar listemedlemskap - Migrer listetilordninger sammen med kontaktdata
4. Synkroniser avtalepipeliner - Mapp pipelinesteg for konsistent CRM-rapportering
5. Implementer hendelsessporing - Bruk nettstedssporing for atferdsdata i Brevo
6. Batch-imports - Bruk bulkimport for datasett større enn 1 000 kontakter

Sikkerhet

• API-nøkkelautentisering - Token-basert tilgang via Api-Token-header
• Webhook-verifisering - Valider webhook-kildens IP-områder
• TLS-kryptering - All API-kommunikasjon kryptert via HTTPS
• Tilgang på kontonivå - API-nøkkelen gir full kontotilgang; bruk med forsiktighet
• IP-restriksjoner - Tilgjengelig på Enterprise-planer

Relaterte ressurser

• ActiveCampaign API-dokumentasjon
• ActiveCampaign Webhook-veiledning
• Mailchimp-kobling
• Brevo-kobling
• Customer Sync-ferdighet