Đăng ký quyền truy cập sớm

Nhập tên và địa chỉ email công việc của bạn. Chúng tôi sẽ gửi liên kết để xác nhận yêu cầu truy cập Tajo.

Trên trang này

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

Trạng thái trình kết nối: Dự kiến Chưa được xây dựng. Hiện Tajo chưa chạy trình kết nối này.

Minh họa · dữ liệu mẫu

Ví dụ đồng bộ

Kiểm tra một bản ghi

Nguồn

Customer.io

Trạng thái trình kết nối: Dự kiến

Đích

Công cụ khác của bạn

Trạng thái trình kết nối: Công cụ tùy chỉnh

Ánh xạ trường

Trường nguồn	Trường đích	Giá trị mẫu
`record.id`	`source_id`	`record_1042`
`record.updated_at`	`updated_at`	`2026-10-18T08:00:00Z`
`record.value`	`value`	`sample_value`

Soạn thảo
Kiểm tra một bản ghi
Phê duyệt phiên bản này

Trạng thái áp dụng cho từng trình kết nối, không bảo đảm lần đồng bộ này đã sẵn sàng. Các trường chỉ để minh họa. Hãy kiểm tra lược đồ và quyền thực tế trước khi chạy đồng bộ.

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

Thuộc Tính	Giá Trị
Nền Tảng	Customer.io
Danh Mục	Marketing
Độ Phức Tạp Thiết Lập	Trung Bình
Tích Hợp Chính Thức	Không
Dữ Liệu Đồng Bộ	People, Sự Kiện, Segments, Campaigns
Loại API	Track API + App API
Xác Thực	API Key (Track) và Bearer Token (App)

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ó:

Tài khoản Customer.io
Track API Key (Site ID + API Key)
App API Key (Bearer Token)
Tài khoản Brevo với quyền truy cập API
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"

Phân Tách API Key

Customer.io sử dụng hai loại API keys: Track API (cho ghi dữ liệu) và App API (cho đọc và quản lý). Đảm bảo dùng đúng key cho từng thao tác để tránh lỗi xác thực.

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

Phương Thức	Endpoint	Mô Tả
`GET`	`/v1/customers`	Liệt kê customers
`GET`	`/v1/customers/{id}`	Lấy customer
`GET`	`/v1/segments`	Liệt kê segments
`GET`	`/v1/segments/{id}/membership`	Thành viên segment
`GET`	`/v1/campaigns`	Liệt kê campaigns
`GET`	`/v1/campaigns/{id}/metrics`	Số liệu campaign
`POST`	`/api/v2/entity`	Track events (Track API)

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

Batch Endpoints

Customer.io hỗ trợ batch operations cho người dùng và events. Tajo tự động nhóm cập nhật để tối ưu hóa thông lượng và giảm số lần gọi API.

Giới Hạn Tốc Độ

Endpoint	Giới Hạn
Track API	100 yêu cầu/giây
App API	10 yêu cầu/giây
Batch Track	1.000 entities/yêu cầu

Khắc Phục Sự Cố

Sự Cố	Nguyên Nhân	Giải Pháp
401 Unauthorized	API key không hợp lệ	Kiểm tra đúng loại API key (Track vs App)
Customers không tải	Filter pagination	Kiểm tra tham số `start` pagination
Segments rỗng	Segment không đủ thành viên	Xác minh segment có members trong Customer.io