Đă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 PostHog

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

PostHog

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 PostHog với Brevo qua Tajo để hợp nhất product analytics với marketing automation, đồng bộ user cohorts sang danh sách Brevo và kích hoạt chiến dịch dựa trên hành vi sản phẩm.

Tổng Quan

Thuộc Tính	Giá Trị
Nền Tảng	PostHog
Danh Mục	Tùy Chỉnh
Độ 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ộ	Sự Kiện, Persons, Cohorts, Feature Flags
Loại API	REST API
Xác Thực	Personal API Key

Tính Năng

Đồng bộ persons - Nhập PostHog user profiles sang liên hệ Brevo
Đồng bộ cohort - Xuất cohorts sang danh sách Brevo cho targeting
Theo dõi sự kiện - Forward PostHog events sang Brevo triggers
Feature flag sync - Đồng bộ trạng thái feature flag sang thuộc tính liên hệ
HogQL queries - Truy vấn dữ liệu PostHog với SQL để tạo phân đoạn tùy chỉnh

Yêu Cầu

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

Tài khoản PostHog (Cloud hoặc Self-hosted)
Personal API Key
Project ID PostHog
Tài khoản Brevo với quyền truy cập API
Tài khoản Tajo

Xác Thực

curl "https://app.posthog.com/api/projects/" \
  -H "Authorization: Bearer YOUR_PERSONAL_API_KEY"

Tạo Personal API Keys trong PostHog Settings > Personal API keys.

Bảo Mật API Key

PostHog Personal API Keys có quyền truy cập đầy đủ vào project. Sử dụng Project API Keys thay thế khi chỉ cần ghi dữ liệu (tracking). Không bao giờ expose Personal API Keys phía client.

Kết Nối với Tajo

tajo connectors install posthog \
  --api-key $POSTHOG_API_KEY \
  --project-id $POSTHOG_PROJECT_ID \
  --host https://app.posthog.com  # hoặc URL self-hosted

Cấu Hình

Thiết Lập Cơ Bản

connectors:
  posthog:
    enabled: true
    api_key: "${POSTHOG_API_KEY}"
    project_id: "${POSTHOG_PROJECT_ID}"
    host: "https://app.posthog.com"

    sync:
      persons: true
      cohorts: true
      feature_flags: false
      events: false

    cohort_mapping:
      "Active Users": 35
      "Churned": 36
      "Power Users": 37

Ánh Xạ Trường

field_mapping:
  email: email
  properties.$name: FULLNAME
  properties.$phone: SMS
  properties.company: COMPANY_NAME
  properties.plan: PLAN_TYPE
  properties.signup_date: SIGNUP_DATE
  properties.$initial_referring_domain: ACQUISITION_SOURCE

API Endpoints

Phương Thức	Endpoint	Mô Tả
`GET`	`/api/projects/{id}/persons`	Liệt kê persons
`GET`	`/api/projects/{id}/cohorts`	Liệt kê cohorts
`POST`	`/api/projects/{id}/cohorts/{id}/persons`	Persons trong cohort
`GET`	`/api/projects/{id}/feature_flags`	Liệt kê feature flags
`POST`	`/api/projects/{id}/query`	Chạy HogQL query
`POST`	`/capture/`	Track sự kiện

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('posthog', {
  apiKey: process.env.POSTHOG_API_KEY,
  projectId: process.env.POSTHOG_PROJECT_ID
});

Đồng Bộ Cohort Sang Brevo

// Đồng bộ PostHog cohort sang danh sách Brevo
await tajo.connectors.syncCohort('posthog', {
  cohortId: 123,
  brevoListId: 35,
  syncMode: 'mirror',
  includeProperties: ['email', 'plan', 'company']
});

Xuất Theo Lô

Khi xuất nhiều persons, sử dụng phân trang với cursor để tránh vượt giới hạn tốc độ. PostHog trả về tối đa 100 kết quả mỗi trang theo mặc định.

Giới Hạn Tốc Độ

Giới Hạn	Giá Trị
Yêu cầu API	480 yêu cầu/phút
Kết quả mỗi trang	100 mặc định, 1000 tối đa

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ệ	Xác minh key trong PostHog Settings
Persons không đồng bộ	Email property thiếu	Đảm bảo identify calls có $email property
Cohort rỗng	Cohort chưa được tính toán	Chờ PostHog tính toán cohort sau khi tạo