ActiveCampaign Connector

เชื่อมต่อบัญชี ActiveCampaign ของคุณกับ Brevo ผ่าน Tajo เพื่อการโยกย้ายผู้ติดต่อที่ครอบคลุม การซิงค์ deal pipeline การแมประบบอัตโนมัติ และข้อมูลการตลาดที่รวมกันทั้งสองแพลตฟอร์ม

ภาพรวม

ฟีเจอร์

• การโยกย้ายผู้ติดต่อ - โยกย้ายผู้ติดต่อพร้อม custom fields tags และ list memberships
• การซิงค์ deal pipeline - ซิงค์ deal stages ค่า และเจ้าของสำหรับการติดตามรายได้
• การแมประบบอัตโนมัติ - แมป ActiveCampaign automations กับ Brevo workflow triggers
• การติดตามเหตุการณ์ - ซิงค์ site tracking และ custom events สำหรับ behavioral segmentation
• การซิงค์ list และ tag - จำลองโครงสร้าง list และ segments ที่ใช้ tag ใน Brevo
• การผสานรวม e-commerce - ซิงค์ Deep Data (คำสั่งซื้อ ลูกค้า carts) กับ Brevo
• การซิงค์ custom objects - แมป ActiveCampaign custom objects กับแอตทริบิวต์ Brevo
• การซิงค์คะแนน - โอน lead และ contact scores ไปยังแอตทริบิวต์ Brevo

ข้อกำหนดเบื้องต้น

ก่อนเริ่มต้น ตรวจสอบให้แน่ใจว่าคุณมี:

1. บัญชี ActiveCampaign (Lite, Plus, Professional หรือ Enterprise)
2. API URL และ API key จาก Settings > Developer
3. บัญชี Brevo ที่มีสิทธิ์เข้าถึง API
4. บัญชี Tajo

การยืนยันตัวตน

การยืนยันตัวตนด้วย API Key

ActiveCampaign ใช้ API key ที่ส่งเป็น header หรือ query parameter

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

พบ API URL และ key ของคุณใน ActiveCampaign Settings > Developer

การกำหนดค่า

การตั้งค่าพื้นฐาน

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

การแมปฟิลด์

แมปฟิลด์ ActiveCampaign กับแอตทริบิวต์ผู้ติดต่อ Brevo:

การแมป Custom Fields

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 Endpoints

ผู้ติดต่อ

Deals

ระบบอัตโนมัติ

E-commerce (Deep Data)

การติดตามเหตุการณ์

เหตุการณ์

เหตุการณ์ผู้ติดต่อ

เหตุการณ์ Deal

เหตุการณ์ระบบอัตโนมัติ

ตัวอย่างโค้ด

เริ่มต้น Connector

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

โยกย้ายผู้ติดต่อไปยัง 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
// }

ติดตาม Custom Events

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

ขีดจำกัดอัตรา

Rate limits ของ ActiveCampaign API:

ขีดจำกัดเพิ่มเติม:

• Bulk import: 250 ผู้ติดต่อต่อ batch
• ความถี่ bulk import: 1 import ในคราวเดียว
• Event tracking: 2 คำขอ/วินาที
• ขีดจำกัดรายวัน: ไม่มีขีดจำกัดรายวันที่ชัดเจน (ขึ้นอยู่กับอัตราเท่านั้น)

การแก้ไขปัญหา

ปัญหาทั่วไป

โหมด Debug

เปิดใช้งาน verbose logging:

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

ทดสอบการเชื่อมต่อ

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

แนวทางปฏิบัติที่ดีที่สุด

1. ใช้ contact sync endpoint - ใช้ /contact/sync สำหรับ upsert operations แทนการสร้าง/อัปเดตแยกกัน
2. แมปฟิลด์โดย ID - Custom field IDs มีความเสถียร labels สามารถเปลี่ยนได้
3. รักษา list memberships - โยกย้าย list assignments พร้อมข้อมูลผู้ติดต่อ
4. ซิงค์ deal pipelines - แมป pipeline stages สำหรับการรายงาน CRM ที่สม่ำเสมอ
5. ใช้ event tracking - ใช้ site tracking สำหรับข้อมูลพฤติกรรมใน Brevo
6. Batch imports - ใช้ bulk import สำหรับ datasets ขนาดใหญ่กว่า 1,000 ผู้ติดต่อ

ความปลอดภัย

• การยืนยันตัวตนด้วย API Key - การเข้าถึงแบบ token ผ่าน header Api-Token
• การตรวจสอบ webhook - ตรวจสอบ source IP ranges ของ webhook
• การเข้ารหัส TLS - การสื่อสาร API ทั้งหมดเข้ารหัสผ่าน HTTPS
• การเข้าถึงระดับบัญชี - API key ให้สิทธิ์เข้าถึงบัญชีทั้งหมด ใช้ด้วยความระมัดระวัง
• การจำกัด IP - มีสำหรับแผน Enterprise

แหล่งข้อมูลที่เกี่ยวข้อง

• ActiveCampaign API Documentation
• ActiveCampaign Webhook Guide
• Mailchimp Connector
• Brevo Connector
• Customer Sync Skill