Trình Kết Nối ActiveCampaign

Kết nối tài khoản ActiveCampaign của bạn với Brevo qua Tajo để migration contacts toàn diện, đồng bộ deal pipeline, ánh xạ automations và hợp nhất dữ liệu marketing trên cả hai nền tảng.

Tổng Quan

Tính Năng

• Migration contacts - Migrate contacts với custom fields, tags và list memberships
• Đồng bộ deal pipeline - Đồng bộ deal stages, values và owners để theo dõi doanh thu
• Ánh xạ automations - Ánh xạ ActiveCampaign automations sang workflow triggers Brevo
• Theo dõi sự kiện - Đồng bộ site tracking và custom events để phân đoạn hành vi
• Đồng bộ list và tag - Sao chép cấu trúc list và tag-based segments trong Brevo
• Tích hợp E-commerce - Đồng bộ Deep Data (orders, customers, carts) sang Brevo
• Đồng bộ custom objects - Ánh xạ custom objects ActiveCampaign sang thuộc tính Brevo
• Đồng bộ score - Chuyển lead và contact scores sang thuộc tính Brevo

Yêu Cầu

Trước khi bắt đầu, hãy đảm bảo bạn có:

1. Tài khoản ActiveCampaign (Lite, Plus, Professional, hoặc Enterprise)
2. API URL và API key từ Settings > Developer
3. Tài khoản Brevo với quyền truy cập API
4. Tài khoản Tajo

Xác Thực

Xác Thực API Key

ActiveCampaign sử dụng API key được truyền qua header hoặc query parameter.

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

Tìm API URL và key trong ActiveCampaign Settings > Developer.

Cấu Hình

Thiết Lập Cơ Bản

connectors:
  activecampaign:
    enabled: true
    api_url: "https://yourcompany.api-us1.com"
    api_key: "${AC_API_KEY}"

    # Tùy chọn đồng bộ dữ liệu
    sync:
      contacts: true
      deals: true
      automations: true
      events: true
      ecommerce: true

    # Ánh xạ list sang Brevo
    list_mapping:
      "Main List": 50
      "Newsletter": 51
      "Customers": 52

Ánh Xạ Trường

Ánh xạ trường ActiveCampaign sang thuộc tính liên hệ Brevo:

Ánh Xạ Custom Field

field_mapping:
  # Trường tiêu chuẩn
  email: email
  firstName: FIRSTNAME
  lastName: LASTNAME
  phone: SMS

  # Trường tương tác
  score: LEAD_SCORE
  rating: ENGAGEMENT_RATING

  # Trường deal
  deals.value: DEAL_VALUE
  deals.stage: DEAL_STAGE
  deals.owner: DEAL_OWNER

  # Trường tùy chỉnh
  fieldValues.company: COMPANY_NAME
  fieldValues.industry: INDUSTRY
  fieldValues.plan_tier: PLAN_TIER

API Endpoints

Contacts

Deals

Automations

E-commerce (Deep Data)

Theo Dõi Sự Kiện

Sự Kiện

Sự Kiện Liên Hệ

Sự Kiện Deal

Sự Kiện Automation

Ví Dụ Code

Khởi Tạo Trình Kết Nối

import { TajoClient } from '@tajo/sdk';

const tajo = new TajoClient({
  apiKey: process.env.TAJO_API_KEY,
  brevoApiKey: process.env.BREVO_API_KEY
});

// Kết nối ActiveCampaign
await tajo.connectors.connect('activecampaign', {
  apiUrl: process.env.AC_API_URL,
  apiKey: process.env.AC_API_KEY
});

Migrate Contacts Sang Brevo

// Migration contacts đầy đủ với custom fields và tags
await tajo.connectors.sync('activecampaign', {
  type: 'full',
  resources: ['contacts', 'deals', 'events'],
  options: {
    includeTags: true,
    includeCustomFields: true,
    includeScores: true,
    includeListMemberships: true
  }
});

// Kiểm tra trạng thái đồng bộ
const status = await tajo.connectors.status('activecampaign');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-01-15T10:30:00Z',
//   contactsMigrated: 28000,
//   dealsSynced: 4500,
//   eventsSynced: 120000
// }

Theo Dõi Custom Events

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

Giới Hạn Tốc Độ

Giới hạn tốc độ API ActiveCampaign:

Giới hạn bổ sung:

• Bulk import: 250 contacts mỗi batch
• Tần suất bulk import: 1 lần import cùng lúc
• Event tracking: 2 yêu cầu/giây
• Giới hạn hàng ngày: Không có giới hạn hàng ngày rõ ràng (chỉ dựa trên tốc độ)

Khắc Phục Sự Cố

Sự Cố Phổ Biến

Chế Độ Debug

Bật verbose logging:

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

Kiểm Tra Kết Nối

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

Thực Hành Tốt Nhất

1. Dùng contact sync endpoint - Sử dụng /contact/sync cho upsert thay vì create/update riêng
2. Ánh xạ fields theo ID - Custom field IDs ổn định; labels có thể thay đổi
3. Bảo toàn list memberships - Migrate list assignments cùng với contact data
4. Đồng bộ deal pipelines - Ánh xạ pipeline stages để báo cáo CRM nhất quán
5. Triển khai event tracking - Sử dụng site tracking để lấy dữ liệu hành vi trong Brevo
6. Batch imports - Sử dụng bulk import cho datasets lớn hơn 1.000 contacts

Bảo Mật

• Xác thực API Key - Truy cập dựa trên token qua header Api-Token
• Xác minh Webhook - Xác thực nguồn gốc webhook qua IP allowlisting
• Mã hóa TLS - Tất cả giao tiếp API được mã hóa qua HTTPS
• Truy cập cấp tài khoản - API key cấp quyền truy cập toàn tài khoản; sử dụng cẩn thận
• Giới hạn IP - Có sẵn cho gói Enterprise

Tài Nguyên Liên Quan

• Tài Liệu API ActiveCampaign
• Hướng Dẫn Webhook ActiveCampaign
• Trình Kết Nối Mailchimp
• Trình Kết Nối Brevo
• Customer Sync Skill