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

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 Airtable bases của bạn với Brevo qua Tajo để đồng bộ bản ghi, kích hoạt chiến dịch marketing từ dữ liệu bảng tính và xây dựng luồng tự động hóa tùy chỉnh.

## Tổng Quan

| Thuộc Tính | Giá Trị |
| --- | --- |
| **Nền Tảng** | Airtable |
| **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ộ** | Bản Ghi, Bảng, Tệp Đính Kèm |
| **Loại API** | REST API |
| **Xác Thực** | Personal Access Token |
| **URL Cơ Sở** | `https://api.airtable.com/v0` |

## Tính Năng

- **Đồng bộ bản ghi** - Đồng bộ bất kỳ bảng Airtable nào sang liên hệ hoặc sự kiện Brevo
- **Ánh xạ trường linh hoạt** - Ánh xạ các loại cột Airtable sang thuộc tính Brevo
- **Webhook theo thời gian thực** - Nhận cập nhật khi bản ghi thay đổi
- **Đồng bộ nhiều base** - Kết nối nhiều Airtable bases với một tích hợp Tajo
- **Lọc trường** - Chỉ đồng bộ bản ghi khớp điều kiện cụ thể

## Yêu Cầu

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

1. Tài khoản Airtable (Free, Plus, Pro, hoặc Enterprise)
2. Personal Access Token với quyền phù hợp
3. Tài khoản Brevo với quyền truy cập API
4. Tài khoản Tajo với subscription hoạt động

## Xác Thực

### Personal Access Token

Airtable sử dụng Personal Access Tokens (PATs) cho xác thực API.

```bash
curl "https://api.airtable.com/v0/{baseId}/{tableId}" \
  -H "Authorization: Bearer YOUR_PERSONAL_ACCESS_TOKEN"
```

Tạo PATs trong Airtable account settings > Developer hub > Personal access tokens.

Phạm Vi Token

Hãy chọn phạm vi tối thiểu cần thiết. Đối với đồng bộ Brevo, thường chỉ cần `data.records:read` trừ khi ghi lại dữ liệu sang Airtable.

#### Phạm Vi Cần Thiết

```
data.records:read    - Đọc bản ghi từ bases
data.records:write   - Viết bản ghi (nếu cần)
schema.bases:read    - Đọc cấu trúc base và bảng
webhook:manage       - Tạo và quản lý webhooks
```

## Cấu Hình

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

```yaml
connectors:
  airtable:
    enabled: true
    access_token: "${AIRTABLE_ACCESS_TOKEN}"

    # Các bases để đồng bộ
    bases:
      - base_id: "appXXXXXXXXXXXXXX"
        tables:
          - name: "Contacts"
            sync_to: brevo_contacts
          - name: "Orders"
            sync_to: brevo_events
```

### Ánh Xạ Trường

Ánh xạ cột Airtable sang thuộc tính liên hệ Brevo:

```yaml
field_mapping:
  Email: email
  "First Name": FIRSTNAME
  "Last Name": LASTNAME
  Phone: SMS
  Company: COMPANY_NAME
  Status: LIFECYCLE_STAGE
  Tags: TAGS
```

## API Endpoints

| Phương Thức | Endpoint | Mô Tả |
| --- | --- | --- |
| `GET` | `/v0/{baseId}/{tableId}` | Liệt kê bản ghi |
| `GET` | `/v0/{baseId}/{tableId}/{recordId}` | Lấy bản ghi đơn |
| `POST` | `/v0/{baseId}/{tableId}` | Tạo bản ghi |
| `PATCH` | `/v0/{baseId}/{tableId}` | Cập nhật bản ghi (theo lô) |
| `DELETE` | `/v0/{baseId}/{tableId}` | Xóa bản ghi |
| `GET` | `/v0/meta/bases` | Liệt kê tất cả bases |
| `GET` | `/v0/meta/bases/{baseId}/tables` | Liệt kê bảng trong một base |

## 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('airtable', {
  accessToken: process.env.AIRTABLE_ACCESS_TOKEN
});
```

### Đồng Bộ Bản Ghi Sang Brevo

```javascript
// Đồng bộ bản ghi Airtable sang liên hệ Brevo
await tajo.connectors.sync('airtable', {
  baseId: 'appXXXXXXXXXXXXXX',
  tableId: 'Contacts',
  type: 'incremental',
  filterFormula: "AND({Status}='Active', {Email}!='')"
});
```

Thao Tác Theo Lô

Airtable hỗ trợ tạo, cập nhật và xóa tới 10 bản ghi mỗi yêu cầu. Tajo tự động chia thành lô để tối đa hóa thông lượng.

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

| Giới Hạn | Giá Trị | Chi Tiết |
| --- | --- | --- |
| Yêu cầu API | 5 yêu cầu/giây | Mỗi base |
| Bản ghi mỗi yêu cầu | 100 | Tối đa mỗi yêu cầu GET |
| Tạo/cập nhật theo lô | 10 bản ghi | Mỗi yêu cầu POST/PATCH |

## 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 PAT trong Airtable Developer Hub |
| 403 Forbidden | Phạm vi không đủ | Thêm phạm vi cần thiết vào PAT |
| Bản ghi không đồng bộ | Công thức lọc | Kiểm tra cú pháp filterFormula |
| Trường bị thiếu | Tên cột sai | Sử dụng tên cột chính xác (phân biệt chữ hoa/thường) |

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

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