ActiveCampaign konektor

Poveži svoj ActiveCampaign nalog sa Brevo putem Tajo za sveobuhvatnu migraciju kontakata, sinhronizaciju pipeline-a poslova, mapiranje automatizacija i unifikovane marketing podatke na obe platforme.

Pregled

Karakteristike

• Migracija kontakata - Migracija kontakata sa prilagođenim poljima, tagovima i članstvima na listama
• Sinhronizacija pipeline-a poslova - Sinhronizacija faza poslova, vrednosti i vlasnika za praćenje prihoda
• Mapiranje automatizacija - Mapiranje ActiveCampaign automatizacija na Brevo okidače tokova rada
• Praćenje događaja - Sinhronizacija praćenja sajta i prilagođenih događaja za bihevioralnu segmentaciju
• Sinhronizacija lista i tagova - Replikacija struktura lista i segmenata zasnovanih na tagovima u Brevo
• E-commerce integracija - Sinhronizacija Deep Data (porudžbine, kupci, korpe) u Brevo
• Sinhronizacija prilagođenih objekata - Mapiranje ActiveCampaign prilagođenih objekata na Brevo atribute
• Sinhronizacija rezultata - Prenos rezultata potencijalnih i kontakata na Brevo atribute

Preduslovi

Pre nego što započneš, proveri da imaš:

1. ActiveCampaign nalog (Lite, Plus, Professional ili Enterprise)
2. API URL i API ključ iz Settings > Developer
3. Brevo nalog sa API pristupom
4. Tajo nalog

Autentifikacija

Autentifikacija API ključem

ActiveCampaign koristi API ključ prosleđen kao header ili query parametar.

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

Pronađi API URL i ključ u ActiveCampaign Settings > Developer.

Konfiguracija

Osnovno podešavanje

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

Mapiranje polja

Mapiranje ActiveCampaign polja na Brevo atribute kontakta:

Mapiranje prilagođenih polja

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 endpointi

Kontakti

Poslovi

Automatizacije

E-commerce (Deep Data)

Praćenje događaja

Događaji

Događaji kontakata

Događaji poslova

Događaji automatizacija

Primeri koda

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

Migracija kontakata u 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
// }

Praćenje prilagođenih događaja

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

Ograničenja brzine

Ograničenja brzine ActiveCampaign API-ja:

Dodatna ograničenja:

• Bulk uvoz: 250 kontakata po batch-u
• Učestalost bulk uvoza: 1 uvoz istovremeno
• Praćenje događaja: 2 zahteva/sekundi
• Dnevni limit: Nema eksplicitnog dnevnog limita (samo na osnovu brzine)

Rešavanje problema

Česti problemi

Debug režim

Uključi detaljno logovanje:

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

Testiraj vezu

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

Najbolje prakse

1. Koristi endpoint za sinhronizaciju kontakta - Koristi /contact/sync za upsert operacije umesto odvojenog kreiranja/ažuriranja
2. Mapiraj polja po ID-u - ID-ovi prilagođenih polja su stabilni; oznake se mogu menjati
3. Sačuvaj članstva na listama - Migriraj dodele lista zajedno sa podacima o kontaktima
4. Sinhronizuj pipeline-ove poslova - Mapiraj faze pipeline-a za konzistentno CRM izveštavanje
5. Implementiraj praćenje događaja - Koristi praćenje sajta za bihevioralne podatke u Brevo
6. Batch uvoz - Koristi bulk uvoz za skupove podataka veće od 1.000 kontakata

Bezbednost

• Autentifikacija API ključem - Pristup zasnovan na tokenima putem Api-Token headera
• Verifikacija webhook-ova - Validiraj IP opsege izvora webhook-ova
• TLS enkripcija - Sva API komunikacija enkriptovana putem HTTPS
• Pristup na nivou naloga - API ključ pruža pun pristup nalogu; koristiti pažljivo
• IP ograničenja - Dostupno na Enterprise planovima

Povezani resursi

• ActiveCampaign API dokumentacija
• ActiveCampaign Webhook vodič
• Mailchimp konektor
• Brevo konektor
• Customer Sync veština