Trình Kết Nối Segment

Kết nối Twilio Segment với Brevo qua Tajo để đồng bộ customer profiles hợp nhất, forward events từ hơn 400 nguồn và sử dụng Segment như CDP trung tâm cho tích hợp Brevo.

Tổng Quan

Tính Năng

• Đồng bộ profile hợp nhất - Nhập customer profiles đã merge sang liên hệ Brevo
• Forward sự kiện - Stream sự kiện từ tất cả nguồn Segment sang Brevo triggers
• Đồng bộ traits - Ánh xạ Segment traits sang thuộc tính liên hệ Brevo
• Identity resolution - Sử dụng identity graph Segment để deduplicate liên hệ
• Audiences - Đồng bộ Segment Audiences sang danh sách Brevo
• Profiles API - Truy vấn profiles Segment theo thời gian thực

Yêu Cầu

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

1. Tài khoản Segment (Team hoặc Business)
2. Workspace Access Token
3. Tài khoản Brevo với quyền truy cập API
4. Tài khoản Tajo

Xác Thực

Workspace Token

curl "https://platform.segmentapis.com/v1beta/workspaces" \
  -H "Authorization: Bearer YOUR_WORKSPACE_TOKEN"

Tạo Access Tokens trong Segment Workspace Settings > Access Management.

Kết Nối với Tajo

tajo connectors install segment \
  --workspace-token $SEGMENT_WORKSPACE_TOKEN \
  --workspace-slug $SEGMENT_WORKSPACE_SLUG

Cấu Hình

Thiết Lập Cơ Bản

connectors:
  segment:
    enabled: true
    workspace_token: "${SEGMENT_WORKSPACE_TOKEN}"
    workspace_slug: "${SEGMENT_WORKSPACE_SLUG}"

    sync:
      profiles: true
      audiences: true
      events: false  # Dùng Segment Destination thay thế

    audience_mapping:
      "High Intent Users": 45
      "Trial Users": 46
      "Churned": 47

Ánh Xạ Trường

field_mapping:
  email: email
  traits.firstName: FIRSTNAME
  traits.lastName: LASTNAME
  traits.phone: SMS
  traits.company.name: COMPANY_NAME
  traits.plan: PLAN_TYPE
  traits.createdAt: SIGNUP_DATE
  traits.ltv: LIFETIME_VALUE

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('segment', {
  workspaceToken: process.env.SEGMENT_WORKSPACE_TOKEN,
  workspaceSlug: process.env.SEGMENT_WORKSPACE_SLUG
});

Đồng Bộ Profiles Sang Brevo

// Đồng bộ Segment profiles sang liên hệ Brevo
await tajo.connectors.sync('segment', {
  type: 'incremental',
  resources: ['profiles'],
  since: '2024-01-01',
  includeTraits: 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 Segment
• Segment Profiles API
• Customer Sync Skill