ActiveCampaign konnektor

Csatlakoztasd az ActiveCampaign fiókodat a Brevóhoz a Tajo segítségével átfogó kapcsolat-migrációhoz, üzleti csővezeték-szinkronizáláshoz, automatizálás-leképezéshez és egységesített marketingadatokhoz mindkét platformon.

Áttekintés

Funkciók

• Kapcsolat-migráció – Kapcsolatok migrálása egyéni mezőkkel, címkékkel és listatagságokkal
• Üzleti csővezeték-szinkronizáció – Üzleti szakaszok, értékek és tulajdonosok szinkronizálása bevételkövetéshez
• Automatizálás-leképezés – ActiveCampaign automatizálások leképezése Brevo munkafolyamat-kiváltókhoz
• Esemény-követés – Webhelykövető és egyéni események szinkronizálása viselkedési szegmentáláshoz
• Lista és címke szinkronizáció – Listastruktúrák és címke alapú szegmensek másolása a Brevóba
• E-kereskedelmi integráció – Deep Data (rendelések, ügyfelek, kosarak) szinkronizálása a Brevóba
• Egyéni objektum szinkronizáció – ActiveCampaign egyéni objektumok leképezése Brevo attribútumokhoz
• Pontszám szinkronizáció – Lead és kapcsolat pontszámok átadása Brevo attribútumokhoz

Előfeltételek

Mielőtt elkezdenéd, győződj meg róla, hogy rendelkezel:

1. Egy ActiveCampaign fiókkal (Lite, Plus, Professional vagy Enterprise)
2. API URL-lel és API kulccsal a Beállítások > Fejlesztő menüből
3. Egy Brevo fiókkal API-hozzáféréssel
4. Egy Tajo fiókkal

Hitelesítés

API kulcs hitelesítés

Az ActiveCampaign API kulcsot fejlécként vagy lekérdezési paraméterként ad meg.

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

Az API URL-t és kulcsot az ActiveCampaign Beállítások > Fejlesztő menüben találod.

Konfiguráció

Alapbeállítás

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

Mezőleképezés

Képezd le az ActiveCampaign mezőket Brevo kapcsolat-attribútumokhoz:

Egyéni mezőleképezés

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 végpontok

Kapcsolatok

Üzletek

Automatizálások

E-kereskedelem (Deep Data)

Esemény-követés

Események

Kapcsolat-események

Üzleti események

Automatizálási események

Kódpéldák

A konnektor inicializálása

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

Kapcsolatok migrálása a Brevóba

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

Egyéni események követése

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

Ráta-korlátok

Az ActiveCampaign API ráta-korlátjai:

További korlátok:

• Tömeges importálás: 250 kapcsolat kötegenkénr
• Tömeges importálás gyakorisága: Egyszerre 1 importálás
• Esemény-követés: 2 kérés/másodperc
• Napi korlát: Nincs explicit napi korlát (csak ráta alapú)

Hibaelhárítás

Gyakori problémák

Hibakeresési mód

Engedélyezd a részletes naplózást:

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

Kapcsolat tesztelése

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

Legjobb gyakorlatok

1. Használd a kapcsolat-szinkronizáló végpontot – A /contact/sync-et használd upsert műveletekhez külön létrehozás/frissítés helyett
2. Mezők leképezése azonosítóval – Az egyéni mező azonosítók stabilak; a feliratok változhatnak
3. Őrizd meg a listatagságokat – A listahozzárendeléseket a kapcsolat-adatokkal együtt migráld
4. Szinkronizálj üzleti csővezetékeket – Képezd le a csővezeték-szakaszokat a konzisztens CRM riportoláshoz
5. Implementálj esemény-követést – Használj webhely-követést viselkedési adatokhoz a Brevóban
6. Kötegelj importálásokat – Használj tömeges importálást 1 000 kapcsolatnál nagyobb adatkészletekhez

Biztonság

• API kulcs hitelesítés – Token alapú hozzáférés Api-Token fejléccen keresztül
• Webhook-ellenőrzés – Webhook forrás IP-tartományok validálása
• TLS titkosítás – Minden API kommunikáció HTTPS-en keresztül titkosítva
• Fiók szintű hozzáférés – Az API kulcs teljes fiók-hozzáférést biztosít; körültekintően használd
• IP korlátozások – Enterprise csomagokon elérhető

Kapcsolódó források

• ActiveCampaign API dokumentáció
• ActiveCampaign Webhook útmutató
• Mailchimp konnektor
• Brevo konnektor
• Ügyfél-szinkronizáció Skill