Trình Kết Nối Airtable

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

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.

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

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:

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

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

Đồng Bộ Bản Ghi Sang Brevo

// Đồ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}!='')"
});

Giới Hạn Tốc Độ

Khắc Phục Sự Cố

Tài Nguyên Liên Quan

• Tài Liệu API Airtable
• Trình Kết Nối Notion
• Customer Sync Skill