Konektor

Konektor adalah integrasi siap pakai yang menyinkronkan data antara platform Anda dan Brevo. Konektor menangani autentikasi, pemetaan data, dan sinkronisasi real-time.

Apa itu konektor?

Sebuah konektor adalah jembatan data dua arah yang:

• Melakukan autentikasi secara aman ke platform eksternal
• Menyinkronkan data secara real-time atau dalam mode batch
• Memetakan field antara skema platform dan Brevo
• Mengaktifkan skill untuk bekerja di atas data yang tersinkron

Konektor yang tersedia

Platform e-commerce

Sistem CRM

Pembayaran

Arsitektur konektor

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

Alur data

1. Autentikasi: koneksi aman melalui OAuth 2.0 atau API key
2. Event real-time: webhook menangkap perubahan seketika
3. Sinkronisasi batch: job terjadwal untuk data historis
4. Pemetaan field: pemetaan yang dapat dikonfigurasi ke atribut Brevo
5. Brevo API: data tersinkron ke kontak, event, dan list

Konfigurasi

Penyiapan dasar

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

Mode sinkronisasi

Mulai cepat

1. Pilih konektor Anda

Pilih konektor untuk platform Anda dari katalog di atas.

2. Lakukan autentikasi

Hubungkan platform Anda melalui OAuth atau kredensial API:

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

3. Konfigurasikan pemetaan field

Petakan field platform ke atribut kontak Brevo:

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

4. Aktifkan sinkronisasi data

Mulai sinkronisasi data:

tajo connectors sync shopify --full

5. Aktifkan skill

Aktifkan skill yang menggunakan data yang tersinkron:

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

Langkah berikutnya

• Konektor Shopify - Mulai dengan Shopify