Connector

Connector

Connector là các tích hợp được dựng sẵn để đồng bộ dữ liệu giữa các nền tảng của bạn và Brevo. Chúng xử lý việc xác thực, ánh xạ dữ liệu và đồng bộ hóa theo thời gian thực.

Connector là gì?

Connector là một cầu nối dữ liệu hai chiều, cho phép:

• Xác thực an toàn với các nền tảng bên ngoài
• Đồng bộ dữ liệu theo thời gian thực hoặc chế độ theo lô
• Ánh xạ trường giữa schema của nền tảng và Brevo
• Kích hoạt Skill để hành động trên dữ liệu đã đồng bộ

Các Connector khả dụng

Nền tảng thương mại điện tử

Hệ thống CRM

Thanh toán

Kiến trúc Connector

graph LR
    A[Your Platform] <-->|OAuth/API Key| B[Tajo Connector]
    B <-->|Real-time Webhooks| C[Event Processing]
    C --> D[Field Mapping]
    D --> E[Brevo API]
    B <-->|Batch Sync| F[Scheduled Jobs]
    F --> D

Luồng dữ liệu

1. Xác thực: Kết nối an toàn qua OAuth 2.0 hoặc API key
2. Sự kiện thời gian thực: Webhook ghi nhận thay đổi ngay lập tức
3. Đồng bộ theo lô: Các job được lên lịch cho dữ liệu lịch sử
4. Ánh xạ trường: Cấu hình ánh xạ sang thuộc tính Brevo
5. Brevo API: Dữ liệu được đồng bộ tới liên hệ, sự kiện và danh sách

Cấu hình

Thiết lập cơ bản

connectors:
  shopify:
    enabled: true
    shop_url: "your-store.myshopify.com"
    api_key: "${SHOPIFY_API_KEY}"
    api_secret: "${SHOPIFY_API_SECRET}"

    # Data sync settings
    sync:
      customers: true
      orders: true
      products: true
      carts: true

    # Field mappings
    field_mapping:
      email: email
      first_name: FIRSTNAME
      last_name: LASTNAME
      total_spent: TOTAL_SPENT

Chế độ đồng bộ

Bắt đầu nhanh

1. Chọn Connector

Chọn connector phù hợp với nền tảng của bạn từ danh mục bên trên.

2. Xác thực

Kết nối nền tảng của bạn bằng OAuth hoặc thông tin API:

tajo connectors connect shopify \
  --shop-url your-store.myshopify.com \
  --api-key $SHOPIFY_API_KEY

3. Cấu hình ánh xạ trường

Ánh xạ các trường của nền tảng sang thuộc tính liên hệ Brevo:

field_mapping:
  email: email
  firstName: FIRSTNAME
  lastName: LASTNAME
  totalOrders: ORDER_COUNT
  totalSpent: TOTAL_REVENUE
  lastOrderDate: LAST_ORDER_DATE

4. Bật đồng bộ dữ liệu

Bắt đầu đồng bộ dữ liệu:

tajo connectors sync shopify --full

5. Kích hoạt Skill

Bật các skill sử dụng dữ liệu đã đồng bộ:

tajo skills enable abandoned-cart
tajo skills enable customer-sync

Connector tùy chỉnh

Xây dựng connector riêng cho các nền tảng chưa có trong danh mục:

Connector SDK

import { ConnectorSDK } from '@tajo/connector-sdk';

const connector = new ConnectorSDK({
  name: 'my-platform',
  version: '1.0.0',

  // Authentication
  auth: {
    type: 'oauth2',
    authorizationUrl: 'https://api.myplatform.com/oauth/authorize',
    tokenUrl: 'https://api.myplatform.com/oauth/token'
  },

  // Data mappings
  resources: {
    customers: {
      endpoint: '/api/customers',
      mapping: {
        email: 'contact.email',
        name: 'contact.full_name'
      }
    }
  },

  // Webhooks
  webhooks: {
    customer_created: '/webhooks/customer',
    order_placed: '/webhooks/order'
  }
});

export default connector;

Bước tiếp theo

• Shopify Connector - Bắt đầu với Shopify
• Hướng dẫn ánh xạ dữ liệu - Tìm hiểu về ánh xạ trường
• Connector SDK - Xây dựng connector tùy chỉnh
• Mẫu xác thực - Bảo mật kết nối của bạn