---
title: "Trình Kết Nối PostHog"
description: "Hướng dẫn tích hợp PostHog đầy đủ để đồng bộ sự kiện người dùng, cohorts, feature flags và dữ liệu analytics với Brevo qua Tajo."
url: https://tajo.io/vi/docs/connectors/custom/posthog/
markdown: https://tajo.io/vi/docs/connectors/custom/posthog.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 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.

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

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

## Xác Thực

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

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

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

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

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

### Đồng Bộ Cohort Sang Brevo

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

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

- [Tài Liệu API PostHog](https://posthog.com/docs/api)
- [PostHog HogQL Documentation](https://posthog.com/docs/hogql)
- [Trình Kết Nối Amplitude](https://tajo.io/vi/docs/connectors/custom/amplitude)
- [Trình Kết Nối Mixpanel](https://tajo.io/vi/docs/connectors/custom/mixpanel)