ActiveCampaign Connector

Poveži račun ActiveCampaign z Brevo prek Tajo za celovito migracijo stikov, sinhronizacijo prodajnega cevovoda, preslikavo avtomatizacij in poenotenje marketinških podatkov na obeh platformah.

Pregled

Funkcionalnosti

• Migracija stikov – prenesi stike s polji po meri, oznakami in članstvami v seznamih
• Sinhronizacija prodajnega cevovoda – sinhroniziraj faze poslov, vrednosti in lastnike za sledenje prihodkov
• Preslikava avtomatizacij – preslikaj avtomatizacije ActiveCampaign v sprožilce delovnih tokov Brevo
• Sledenje dogodkom – sinhroniziraj sledenje spletnim mestom in dogodke po meri za vedenjsko segmentacijo
• Sinhronizacija seznamov in oznak – replicira strukture seznamov in segmente na osnovi oznak v Brevo
• Integracija e-trgovine – sinhroniziraj podatke Deep Data (naročila, stranke, košarice) v Brevo
• Sinhronizacija predmetov po meri – preslikaj predmete po meri ActiveCampaign v atribute Brevo
• Sinhronizacija točk – prenesi točke potencialnih strank in stikov v atribute Brevo

Predpogoji

Preden začneš, se prepričaj, da imaš:

1. Račun ActiveCampaign (Lite, Plus, Professional ali Enterprise)
2. URL API in ključ API iz Settings > Developer
3. Brevo račun z dostopom do API
4. Tajo račun

Avtentikacija

Avtentikacija z API ključem

ActiveCampaign uporablja ključ API, ki se posreduje kot glava ali parameter poizvedbe.

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

Najdi URL API in ključ v ActiveCampaign Settings > Developer.

Konfiguracija

Osnovna nastavitev

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

Preslikava polj

Preslikaj polja ActiveCampaign v atribute stikov Brevo:

Preslikava polj po meri

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

Končne točke API

Stiki

Posli

Avtomatizacije

E-trgovina (Deep Data)

Sledenje dogodkom

Dogodki

Dogodki stikov

Dogodki poslov

Dogodki avtomatizacij

Primeri kode

Inicializacija konektorja

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

Migracija stikov v 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
// }

Sledenje dogodkom po meri

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

Omejitve hitrosti

Omejitve hitrosti API za ActiveCampaign:

Dodatne omejitve:

• Množičen uvoz: 250 stikov na paket
• Pogostost množičnega uvoza: 1 uvoz naenkrat
• Sledenje dogodkom: 2 zahtevka/sekundo
• Dnevna omejitev: Ni izrecne dnevne omejitve (samo omejitev hitrosti)

Odpravljanje težav

Pogoste težave

Način odpravljanja napak

Omogoči podrobno beleženje:

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

Preizkus povezave

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

Najboljše prakse

1. Uporabi končno točko sinhronizacije stikov – za operacije upsert namesto ločenega ustvarjanja/posodabljanja uporabi /contact/sync
2. Preslikuj polja po ID-ju – ID-ji polj po meri so stabilni; oznake se lahko spremenijo
3. Ohrani članstva v seznamih – skupaj s podatki stikov prenesi dodelitve seznamov
4. Sinhroniziraj prodajne cevovode – za dosledno poročanje CRM preslikaj faze cevovoda
5. Implementiraj sledenje dogodkov – za vedenjske podatke v Brevo uporabi sledenje spletnim mestom
6. Paketni uvozi – za nabore podatkov večje od 1.000 stikov uporabi množičen uvoz

Varnost

• Avtentikacija z API ključem – dostop na osnovi žetonov prek glave Api-Token
• Preverjanje webhooks – preverjanje izvornih IP obsegov webhooks
• TLS šifriranje – vsa komunikacija API šifrirana prek HTTPS
• Dostop na ravni računa – API ključ zagotavlja popoln dostop do računa; ravnaj previdno
• Omejitve IP – na voljo pri planih Enterprise

Povezani viri

• ActiveCampaign API dokumentacija
• Vodnik za webhook ActiveCampaign
• Mailchimp Connector
• Brevo Connector
• Customer Sync Skill