Konektor ActiveCampaign

Hubungkan akun ActiveCampaign Anda ke Brevo melalui Tajo untuk migrasi kontak menyeluruh, sinkronisasi pipeline deal, pemetaan otomatisasi, dan data marketing terpadu di kedua platform.

Ikhtisar

Fitur

• Migrasi kontak - Migrasikan kontak beserta custom field, tag, dan keanggotaan list
• Sinkronisasi pipeline deal - Sinkronkan tahap deal, nilai, dan pemilik untuk pelacakan pendapatan
• Pemetaan otomatisasi - Petakan otomatisasi ActiveCampaign ke trigger alur kerja Brevo
• Pelacakan event - Sinkronkan site tracking dan custom event untuk segmentasi berbasis perilaku
• Sinkronisasi list dan tag - Replikasikan struktur list dan segmen berbasis tag di Brevo
• Integrasi e-commerce - Sinkronkan Deep Data (pesanan, pelanggan, keranjang) ke Brevo
• Sinkronisasi custom object - Petakan custom object ActiveCampaign ke atribut Brevo
• Sinkronisasi skor - Transfer skor lead dan kontak ke atribut Brevo

Prasyarat

Sebelum memulai, pastikan Anda memiliki:

1. Akun ActiveCampaign (Lite, Plus, Professional, atau Enterprise)
2. API URL dan API key dari Settings > Developer
3. Akun Brevo dengan akses API
4. Akun Tajo

Autentikasi

Autentikasi API key

ActiveCampaign menggunakan API key yang dikirim sebagai header atau parameter query.

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

Temukan API URL dan key Anda di ActiveCampaign Settings > Developer.

Konfigurasi

Setup dasar

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

Pemetaan field

Petakan field ActiveCampaign ke atribut kontak Brevo:

Pemetaan custom field

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

Endpoint API

Kontak

Deal

Otomatisasi

E-commerce (Deep Data)

Pelacakan event

Event

Event kontak

Event deal

Event otomatisasi

Contoh kode

Inisialisasi konektor

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

Migrasikan kontak ke 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
// }

Lacak custom event

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

Batas rate

Batas rate API ActiveCampaign:

Batas tambahan:

• Impor massal: 250 kontak per batch
• Frekuensi impor massal: 1 impor pada satu waktu
• Pelacakan event: 2 permintaan/detik
• Batas harian: Tidak ada batas harian eksplisit (hanya berbasis rate)

Pemecahan masalah

Masalah umum

Mode debug

Aktifkan logging terperinci:

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

Uji koneksi

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

Praktik terbaik

1. Gunakan endpoint contact sync - Gunakan /contact/sync untuk operasi upsert alih-alih create/update terpisah
2. Petakan field berdasarkan ID - ID custom field bersifat stabil; label bisa berubah
3. Pertahankan keanggotaan list - Migrasikan penetapan list bersama data kontak
4. Sinkronkan pipeline deal - Petakan tahap pipeline agar pelaporan CRM konsisten
5. Terapkan pelacakan event - Gunakan site tracking untuk data perilaku di Brevo
6. Impor secara batch - Gunakan impor massal untuk dataset lebih besar dari 1.000 kontak

Keamanan

• Autentikasi API key - Akses berbasis token melalui header Api-Token
• Verifikasi webhook - Validasi rentang IP sumber webhook
• Enkripsi TLS - Semua komunikasi API dienkripsi melalui HTTPS
• Akses tingkat akun - API key memberikan akses penuh ke akun; gunakan dengan hati-hati
• Pembatasan IP - Tersedia pada paket Enterprise

Sumber terkait

• Dokumentasi API ActiveCampaign
• Panduan Webhook ActiveCampaign
• Konektor Mailchimp
• Konektor Brevo
• Skill Customer Sync