---
title: "Trình Kết Nối Customer.io"
description: "Hướng dẫn tích hợp Customer.io đầy đủ để đồng bộ people, events, segments và campaign data với Brevo qua Tajo."
url: https://tajo.io/vi/docs/connectors/marketing/customerio/
markdown: https://tajo.io/vi/docs/connectors/marketing/customerio.md
lang: vi-VN
robots: noindex
---

Đă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ì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.

| 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` |

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

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

```bash
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

```bash
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

```yaml
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

```yaml
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

```javascript
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

```javascript
// Đồ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 |

## Tài Nguyên Liên Quan

- [Tài Liệu API Customer.io](https://customer.io/docs/api/)
- [Customer.io Track API](https://customer.io/docs/api/track/)
- [Customer Sync Skill](https://tajo.io/vi/docs/skills/data-sync/customer-sync)