ActiveCampaign Bağlayıcısı

Kapsamlı kişi taşıma, fırsat hattı senkronizasyonu, otomasyon eşleme ve her iki platformda birleşik pazarlama verileri için ActiveCampaign hesabınızı Tajo aracılığıyla Brevo’ya bağlayın.

Genel Bakış

Özellikler

• Kişi taşıma - Özel alanlar, etiketler ve liste üyelikleri ile kişileri taşıyın
• Fırsat hattı senkronizasyonu - Gelir takibi için fırsat aşamalarını, değerlerini ve sahiplerini senkronize edin
• Otomasyon eşleme - ActiveCampaign otomasyonlarını Brevo iş akışı tetikleyicilerine eşleyin
• Olay takibi - Davranışsal segmentasyon için site takibi ve özel olayları senkronize edin
• Liste ve etiket senkronizasyonu - Liste yapılarını ve etiket tabanlı segmentleri Brevo’da kopyalayın
• E-ticaret entegrasyonu - Deep Data’yı (siparişler, müşteriler, sepetler) Brevo’ya senkronize edin
• Özel nesne senkronizasyonu - ActiveCampaign özel nesnelerini Brevo özniteliklerine eşleyin
• Skor senkronizasyonu - Aday ve kişi puanlarını Brevo özniteliklerine aktarın

Ön Koşullar

Başlamadan önce sahip olmanız gerekenler:

1. Bir ActiveCampaign hesabı (Lite, Plus, Professional veya Enterprise)
2. Settings > Developer bölümünden API URL ve API anahtarı
3. API erişimi olan bir Brevo hesabı
4. Bir Tajo hesabı

Kimlik Doğrulama

API Anahtar Kimlik Doğrulaması

ActiveCampaign, başlık veya sorgu parametresi olarak iletilen bir API anahtarı kullanır.

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

API URL’nizi ve anahtarınızı ActiveCampaign Settings > Developer bölümünde bulun.

Yapılandırma

Temel Kurulum

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

Alan Eşleme

ActiveCampaign alanlarını Brevo kişi özniteliklerine eşleyin:

Özel Alan Eşleme

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 Uç Noktaları

Kişiler

Fırsatlar

Otomasyonlar

E-ticaret (Deep Data)

Olay Takibi

Olaylar

Kişi Olayları

Fırsat Olayları

Otomasyon Olayları

Kod Örnekleri

Bağlayıcıyı Başlat

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

Kişileri Brevo’ya Taşı

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

Özel Olayları Takip Et

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

Hız Limitleri

ActiveCampaign API hız limitleri:

Ek limitler:

• Toplu içe aktarma: Toplu başına 250 kişi
• Toplu içe aktarma sıklığı: Aynı anda 1 içe aktarma
• Olay takibi: 2 istek/saniye
• Günlük limit: Açık günlük limit yok (yalnızca hız tabanlı)

Sorun Giderme

Sık Karşılaşılan Sorunlar

Hata Ayıklama Modu

Ayrıntılı günlüklemeyi etkinleştirin:

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

Bağlantıyı Test Et

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

En İyi Uygulamalar

1. Kişi senkronizasyon uç noktasını kullanın - Ayrı oluşturma/güncelleme yerine upsert işlemleri için /contact/sync kullanın
2. Alanları kimliğe göre eşleyin - Özel alan kimlikleri sabittir; etiketler değişebilir
3. Liste üyeliklerini koruyun - Kişi verileriyle birlikte liste atamalarını taşıyın
4. Fırsat hatlarını senkronize edin - Tutarlı CRM raporlaması için hat aşamalarını eşleyin
5. Olay takibi uygulayın - Brevo’da davranışsal veriler için site takibi kullanın
6. Toplu içe aktarmalar - 1.000’den fazla kişi içeren veri kümeleri için toplu içe aktarma kullanın

Güvenlik

• API Anahtar Kimlik Doğrulaması - Api-Token başlığı üzerinden belirteç tabanlı erişim
• Webhook doğrulama - Webhook kaynak IP aralıklarını doğrulayın
• TLS şifrelemesi - Tüm API iletişimi HTTPS aracılığıyla şifrelenir
• Hesap seviyesi erişim - API anahtarı tam hesap erişimi sağlar; dikkatli kullanın
• IP kısıtlamaları - Enterprise planlarda mevcuttur

İlgili Kaynaklar

• ActiveCampaign API Dokümantasyonu
• ActiveCampaign Webhook Rehberi
• Mailchimp Bağlayıcısı
• Brevo Bağlayıcısı
• Müşteri Senkronizasyon Yeteneği