---
title: "Trình Kết Nối Notion"
description: "Hướng dẫn tích hợp Notion đầy đủ để đồng bộ databases, pages và dữ liệu nội dung với Brevo qua Tajo."
url: https://tajo.io/vi/docs/connectors/custom/notion/
markdown: https://tajo.io/vi/docs/connectors/custom/notion.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 Notion

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 Notion với Brevo qua Tajo để đồng bộ database records sang liên hệ, kích hoạt chiến dịch từ cập nhật Notion và sử dụng Notion làm nguồn dữ liệu marketing.

## Tổng Quan

| Thuộc Tính | Giá Trị |
| --- | --- |
| **Nền Tảng** | Notion |
| **Danh Mục** | Tùy Chỉnh |
| **Độ Phức Tạp Thiết Lập** | Dễ |
| **Tích Hợp Chính Thức** | Không |
| **Dữ Liệu Đồng Bộ** | Databases, Pages, Blocks |
| **Loại API** | REST API |
| **Xác Thực** | Internal Integration Token |

## Tính Năng

- **Đồng bộ database** - Ánh xạ Notion database properties sang thuộc tính liên hệ Brevo
- **Theo dõi thay đổi page** - Forward updates Notion sang Brevo để kích hoạt chiến dịch
- **Quan hệ liên kết** - Giải quyết relation properties để làm phong phú dữ liệu liên hệ
- **Lọc và sắp xếp** - Đồng bộ chỉ database entries đáp ứng tiêu chí cụ thể
- **Nhiều database** - Kết nối nhiều Notion databases trong một tích hợp

## Yêu Cầu

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

1. Tài khoản Notion (Free, Plus, Business, hoặc Enterprise)
2. Notion Integration được tạo trong workspace
3. Databases được chia sẻ với integration
4. Tài khoản Brevo với quyền truy cập API
5. Tài khoản Tajo

## Xác Thực

### Internal Integration Token

```bash
curl "https://api.notion.com/v1/databases/{database_id}" \
  -H "Authorization: Bearer YOUR_INTEGRATION_TOKEN" \
  -H "Notion-Version: 2022-06-28" \
  -H "Content-Type: application/json"
```

Tạo integrations tại [https://www.notion.so/my-integrations](https://www.notion.so/my-integrations).

Yêu Cầu Chia Sẻ Page

Integration chỉ có thể truy cập databases và pages đã được chia sẻ rõ ràng với nó. Vào database settings > Connections > thêm integration của bạn.

### Kết Nối với Tajo

```bash
tajo connectors install notion \
  --integration-token $NOTION_INTEGRATION_TOKEN
```

## Cấu Hình

### Thiết Lập Cơ Bản

```yaml
connectors:
  notion:
    enabled: true
    integration_token: "${NOTION_INTEGRATION_TOKEN}"

    # Các databases để đồng bộ
    databases:
      - id: "database_id_here"
        name: "CRM Contacts"
        sync_to: brevo_contacts
      - id: "another_database_id"
        name: "Newsletter Subscribers"
        sync_to: brevo_list_5
```

### Ánh Xạ Trường

Ánh xạ loại Notion property sang thuộc tính Brevo:

```yaml
field_mapping:
  # Properties tiêu chuẩn
  "Email": email
  "Name": FULLNAME
  "Phone": SMS
  "Company": COMPANY_NAME

  # Properties trạng thái/chọn lựa
  "Status": LIFECYCLE_STAGE
  "Plan": PLAN_TYPE

  # Properties ngày tháng
  "Created": SIGNUP_DATE
  "Last Contact": LAST_CONTACT_DATE
```

## API Endpoints

| Phương Thức | Endpoint | Mô Tả |
| --- | --- | --- |
| `POST` | `/v1/databases/{id}/query` | Truy vấn database entries |
| `GET` | `/v1/pages/{id}` | Lấy chi tiết page |
| `PATCH` | `/v1/pages/{id}` | Cập nhật page properties |
| `POST` | `/v1/pages` | Tạo page mới |
| `GET` | `/v1/databases/{id}` | Lấy schema database |
| `POST` | `/v1/search` | Tìm kiếm pages và databases |

## 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('notion', {
  integrationToken: process.env.NOTION_INTEGRATION_TOKEN
});
```

### Đồng Bộ Database Sang Brevo

```javascript
// Đồng bộ Notion database sang liên hệ Brevo
await tajo.connectors.sync('notion', {
  databaseId: 'database_id_here',
  type: 'incremental',
  filter: {
    property: 'Status',
    select: { equals: 'Active' }
  }
});
```

Phân Trang Cursor

Notion API sử dụng cursor-based pagination. Tajo tự động xử lý phân trang và lưu trữ cursor giữa các lần đồng bộ để xử lý tăng dần hiệu quả.

## Giới Hạn Tốc Độ

| Giới Hạn | Giá Trị |
| --- | --- |
| Yêu cầu API | 3 yêu cầu/giây |
| Kích thước trang tối đa | 100 kết quả |

## Khắc Phục Sự Cố

| Sự Cố | Nguyên Nhân | Giải Pháp |
| --- | --- | --- |
| 401 Unauthorized | Token không hợp lệ | Xác minh integration token |
| Database không tìm thấy | Chưa chia sẻ với integration | Thêm integration vào database connections |
| Property bị thiếu | Tên property không khớp | Kiểm tra tên property chính xác (phân biệt hoa/thường) |
| Relation không giải quyết | Relation database không chia sẻ | Chia sẻ tất cả related databases với integration |

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

- [Tài Liệu API Notion](https://developers.notion.com/reference/intro)
- [Tài Liệu Notion Integration](https://developers.notion.com/docs/getting-started)
- [Trình Kết Nối Airtable](https://tajo.io/vi/docs/connectors/custom/airtable)
- [Customer Sync Skill](https://tajo.io/vi/docs/skills/data-sync/customer-sync)