Trình Kết Nối Customer.io

Kết nối Customer.io với Brevo qua Tajo để đồng bộ customer profiles, behavioral events và campaign data, hợp nhất engagement analytics và kích hoạt campaigns phối hợp.

Tổng Quan

Tính Năng

• Đồng bộ people - Đồng bộ Customer.io people sang liên hệ Brevo với tất cả attributes
• Forward sự kiện - Chuyển tiếp behavioral events sang Brevo triggers
• Đồng bộ segment - Xuất Customer.io segments sang danh sách Brevo
• Số liệu campaign - Nhập dữ liệu campaign performance vào Brevo analytics
• Hợp nhất danh tính - Ánh xạ Customer.io identifiers sang Brevo contact attributes

Yêu Cầu

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

1. Tài khoản Customer.io
2. Track API Key (Site ID + API Key)
3. App API Key (Bearer Token)
4. Tài khoản Brevo với quyền truy cập API
5. Tài khoản Tajo

Xác Thực

Track API

curl -X POST "https://track.customer.io/api/v2/entity" \
  -H "Authorization: Basic BASE64(SITE_ID:API_KEY)" \
  -H "Content-Type: application/json"

App API

curl "https://api.customer.io/v1/customers" \
  -H "Authorization: Bearer YOUR_APP_API_KEY"

Cấu Hình

Thiết Lập Cơ Bản

connectors:
  customerio:
    enabled: true
    site_id: "${CIO_SITE_ID}"
    track_api_key: "${CIO_TRACK_API_KEY}"
    app_api_key: "${CIO_APP_API_KEY}"

    sync:
      people: true
      segments: true
      campaigns: true
      events: false  # Sử dụng streaming thay thế

    segment_mapping:
      "Active Users": 55
      "Trial Users": 56
      "Churned": 57

Ánh Xạ Trường

field_mapping:
  email: email
  first_name: FIRSTNAME
  last_name: LASTNAME
  phone: SMS
  created_at: SIGNUP_DATE
  plan: PLAN_TYPE
  company: COMPANY_NAME
  last_active_at: LAST_ACTIVE_DATE

API Endpoints

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

await tajo.connectors.connect('customerio', {
  siteId: process.env.CIO_SITE_ID,
  trackApiKey: process.env.CIO_TRACK_API_KEY,
  appApiKey: process.env.CIO_APP_API_KEY
});

Đồng Bộ Segments Sang Brevo

// Đồng bộ Customer.io segment sang danh sách Brevo
await tajo.connectors.syncSegment('customerio', {
  segmentId: 42,
  brevoListId: 55,
  syncMode: 'mirror',
  includeAttributes: true
});

Giới Hạn Tốc Độ

Khắc Phục Sự Cố

Tài Nguyên Liên Quan

• Tài Liệu API Customer.io
• Customer.io Track API
• Customer Sync Skill