Conector ActiveCampaign

Conectați contul ActiveCampaign la Brevo prin Tajo pentru migrarea completă a contactelor, sincronizarea pipeline-ului de oferte, maparea automatizărilor și date de marketing unificate pe ambele platforme.

Prezentare generală

Funcționalități

• Migrare contacte - Migrați contacte cu câmpuri personalizate, etichete și apartenența la liste
• Sincronizare pipeline oferte - Sincronizați etapele ofertelor, valorile și proprietarii pentru urmărirea veniturilor
• Mapare automatizări - Mapați automatizările ActiveCampaign la declanșatoarele de flux de lucru Brevo
• Urmărire evenimente - Sincronizați urmărirea site-ului și evenimentele personalizate pentru segmentare comportamentală
• Sincronizare liste și etichete - Replicați structurile listelor și segmentele bazate pe etichete în Brevo
• Integrare e-commerce - Sincronizați Deep Data (comenzi, clienți, coșuri) la Brevo
• Sincronizare obiecte personalizate - Mapați obiectele personalizate ActiveCampaign la atributele Brevo
• Sincronizare scoruri - Transferați scorurile de lead și contact la atributele Brevo

Cerințe preliminare

Înainte de a începe, asigurați-vă că aveți:

1. Un cont ActiveCampaign (Lite, Plus, Professional sau Enterprise)
2. URL API și cheie API din Settings > Developer
3. Un cont Brevo cu acces API
4. Un cont Tajo

Autentificare

Autentificare cu cheie API

ActiveCampaign utilizează o cheie API transmisă ca antet sau parametru de interogare.

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

Găsiți URL-ul API și cheia în ActiveCampaign Settings > Developer.

Configurare

Configurare de bază

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

Mapare câmpuri

Mapați câmpurile ActiveCampaign la atributele de contact Brevo:

Mapare câmpuri personalizate

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

Puncte finale API

Contacte

Oferte

Automatizări

E-commerce (Deep Data)

Urmărire evenimente

Evenimente

Evenimente contacte

Evenimente oferte

Evenimente automatizări

Exemple de cod

Inițializare conector

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

Migrare contacte la 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
// }

Urmărire evenimente personalizate

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

Limite de rată

Limite de rată API ActiveCampaign:

Limite suplimentare:

• Import în bloc: 250 contacte per lot
• Frecvență import în bloc: 1 import la un moment dat
• Urmărire evenimente: 2 cereri/secundă
• Limită zilnică: Fără limită zilnică explicită (bazată pe rată)

Depanare

Probleme frecvente

Modul de depanare

Activați jurnalizarea verbosă:

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

Testare conexiune

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

Bune practici

1. Utilizați punctul final de sincronizare contacte - Utilizați /contact/sync pentru operații upsert în loc de creare/actualizare separate
2. Mapați câmpurile după ID - ID-urile câmpurilor personalizate sunt stabile; etichetele se pot schimba
3. Păstrați apartenența la liste - Migrați atribuirile listelor împreună cu datele contactelor
4. Sincronizați pipeline-urile de oferte - Mapați etapele pipeline-ului pentru raportare CRM consistentă
5. Implementați urmărirea evenimentelor - Utilizați urmărirea site-ului pentru date comportamentale în Brevo
6. Importuri în lot - Utilizați import în bloc pentru seturi de date mai mari de 1.000 de contacte

Securitate

• Autentificare cu cheie API - Acces bazat pe token prin antetul Api-Token
• Verificare webhook - Validați intervalele IP sursă ale webhook-urilor
• Criptare TLS - Toate comunicațiile API criptate prin HTTPS
• Acces la nivel de cont - Cheia API oferă acces complet la cont; utilizați cu grijă
• Restricții IP - Disponibile pe planurile Enterprise

Resurse conexe

• Documentație API ActiveCampaign
• Ghid Webhook ActiveCampaign
• Conector Mailchimp
• Conector Brevo
• Skill Sincronizare clienți