ActiveCampaign konektor

Prepoj svoj účet ActiveCampaign s Brevo cez Tajo pre komplexnú migráciu kontaktov, synchronizáciu pipeline obchodov, mapovanie automatizácií a zjednotené marketingové dáta naprieč oboma platformami.

Prehľad

Funkcie

• Migrácia kontaktov - Migruj kontakty s vlastnými poľami, tagmi a členstvami v zozname
• Synchronizácia pipeline obchodov - Synchronizuj fázy obchodov, hodnoty a majiteľov pre sledovanie príjmov
• Mapovanie automatizácií - Mapuj automatizácie ActiveCampaign na triggery workflowov Brevo
• Sledovanie udalostí - Synchronizuj sledovanie stránok a vlastné udalosti pre behaviorálnu segmentáciu
• Synchronizácia zoznamov a tagov - Replikuj štruktúry zoznamov a segmenty na základe tagov v Brevo
• E-commerce integrácia - Synchronizuj Deep Data (objednávky, zákazníci, košíky) do Brevo
• Synchronizácia vlastných objektov - Mapuj vlastné objekty ActiveCampaign na atribúty Brevo
• Synchronizácia skóre - Prenášaj skóre leadov a kontaktov do atribútov Brevo

Predpoklady

Predtým, než začneš, uisti sa, že máš:

1. Účet ActiveCampaign (Lite, Plus, Professional alebo Enterprise)
2. API URL a API kľúč z Settings > Developer
3. Brevo účet s API prístupom
4. Tajo účet

Autentifikácia

Autentifikácia API kľúčom

ActiveCampaign používa API kľúč prenášaný ako hlavička alebo parameter dopytu.

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

Nájdi svoju API URL a kľúč v ActiveCampaign Settings > Developer.

Konfigurácia

Základné nastavenie

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

Mapovanie polí

Namapuj polia ActiveCampaign na atribúty kontaktov Brevo:

Mapovanie vlastných polí

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 endpointy

Kontakty

Obchody

Automatizácie

E-commerce (Deep Data)

Sledovanie udalostí

Udalosti

Udalosti kontaktov

Udalosti obchodov

Udalosti automatizácií

Ukážky kódu

Inicializácia konektora

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ácia kontaktov do 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
// }

Sledovanie vlastných udalostí

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

Obmedzenia rýchlosti

Limity rýchlosti ActiveCampaign API:

Ďalšie limity:

• Hromadný import: 250 kontaktov na dávku
• Frekvencia hromadného importu: 1 import naraz
• Sledovanie udalostí: 2 požiadavky/sekundu
• Denný limit: Žiadny explicitný denný limit (iba na základe rýchlosti)

Riešenie problémov

Bežné problémy

Debug režim

Zapni verbose logovanie:

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

Test pripojenia

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

Odporúčané postupy

1. Použi endpoint synchronizácie kontaktov - Použi /contact/sync pre upsert operácie namiesto samostatného vytvárania/aktualizácie
2. Mapuj polia podľa ID - ID vlastných polí sú stabilné; labely sa môžu meniť
3. Zachovaj členstvá v zoznamoch - Migruj priradenia zoznamov spolu s dátami kontaktov
4. Synchronizuj pipeline obchodov - Mapuj fázy pipeline pre konzistentné CRM reportovanie
5. Implementuj sledovanie udalostí - Použi sledovanie stránok pre behaviorálne dáta v Brevo
6. Dávkové importy - Použi hromadný import pre datasety väčšie ako 1 000 kontaktov

Bezpečnosť

• Autentifikácia API kľúčom - Prístup na základe tokenov cez hlavičku Api-Token
• Overenie webhookov - Validuj rozsahy IP zdrojov webhookov
• TLS šifrovanie - Všetka API komunikácia šifrovaná cez HTTPS
• Prístup na úrovni účtu - API kľúč poskytuje plný prístup k účtu; použi opatrne
• IP obmedzenia - Dostupné v plánoch Enterprise

Súvisiace zdroje

• ActiveCampaign API dokumentácia
• ActiveCampaign Webhook sprievodca
• Mailchimp konektor
• Brevo konektor
• Customer Sync skill