Konektor Brevo

Hubungkan akun Brevo Anda ke Tajo untuk manajemen kontak terpadu, pesan transaksional lintas email, SMS, dan WhatsApp, serta otomatisasi marketing yang menyeluruh.

Ikhtisar

Fitur

• Pesan multi-kanal - Kirim email transaksional, SMS, dan WhatsApp dari satu API terpadu
• Manajemen kontak - Buat, perbarui, dan segmentasikan kontak dengan atribut kustom
• Kampanye marketing - Buat dan kirim kampanye email secara terprogram
• Pelacakan event - Lacak custom event dan aktivitas situs web melalui Brevo Tracker
• Sinkronisasi eCommerce - Sinkronkan produk, pesanan, dan data keranjang untuk kampanye yang dipersonalisasi
• Program loyalitas - Kelola langganan loyalitas, poin, dan data anggota
• Dukungan webhook - Notifikasi event real-time untuk event transaksional, marketing, dan CRM
• Conversations - Integrasi widget live chat dan manajemen pesan secara terprogram

Prasyarat

Sebelum memulai, pastikan Anda memiliki:

1. Akun Brevo (paket Free, Starter, Business, atau Enterprise)
2. API key yang dibuat dari Brevo Settings > API Keys
3. Akun Tajo dengan akses API
4. Domain pengirim terverifikasi untuk pengiriman email

Autentikasi

Brevo mendukung dua metode autentikasi:

Autentikasi API key (direkomendasikan)

Sertakan API key Anda pada header api-key di setiap permintaan. Paling cocok untuk integrasi langsung dan komunikasi server ke server.

curl -X GET "https://api.brevo.com/v3/account" \
  -H "api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Autentikasi OAuth 2.0

Gunakan OAuth 2.0 untuk integrasi privat di dalam organisasi yang memerlukan akses terdelegasi dan izin spesifik per pengguna. OAuth menyediakan sistem berbasis token dengan masa berlaku yang ditentukan.

Konfigurasi

Setup dasar

connectors:
  brevo:
    enabled: true
    api_key: "${BREVO_API_KEY}"
    api_version: "v3"

    # Data sync options
    sync:
      contacts: true
      campaigns: true
      transactional: true
      events: true
      ecommerce: true

    # List assignment
    lists:
      all_customers: 5
      newsletter: 6
      buyers: 7

Pemetaan field

Petakan field data Anda ke atribut kontak Brevo:

Pemetaan atribut kustom

field_mapping:
  # Standard fields
  email: email
  first_name: FIRSTNAME
  last_name: LASTNAME
  phone: SMS

  # Marketing fields
  opt_in: OPT_IN
  signup_source: SIGNUP_SOURCE
  preferred_language: LANGUAGE

  # eCommerce metrics
  orders_count: ORDER_COUNT
  total_spent: TOTAL_REVENUE
  last_order_date: LAST_ORDER_DATE

  # Loyalty fields
  loyalty_tier: VIP_TIER
  loyalty_points: LOYALTY_POINTS

Endpoint API

Endpoint inti

Endpoint eCommerce

Endpoint kampanye

Event

Event transaksional

Event eCommerce

Contoh kode

Inisialisasi konektor

import { TajoClient } from '@tajo/sdk';

const tajo = new TajoClient({
  apiKey: process.env.TAJO_API_KEY,
  brevoApiKey: process.env.BREVO_API_KEY
});

// Connect Brevo account
await tajo.connectors.connect('brevo', {
  apiKey: process.env.BREVO_API_KEY
});

Kirim email transaksional

// Send a transactional email via Brevo
await tajo.brevo.sendTransactionalEmail({
  to: [{ email: '[email protected]', name: 'John Doe' }],
  templateId: 12,
  params: {
    ORDER_ID: '12345',
    ORDER_TOTAL: '$59.99',
    DELIVERY_DATE: '2024-02-15'
  }
});

Sinkronkan kontak

// Bulk import contacts to Brevo
await tajo.connectors.sync('brevo', {
  type: 'full',
  resources: ['contacts'],
  options: {
    listIds: [5, 6],
    updateExisting: true,
    emptyContactsAttributes: false
  }
});

// Check sync status
const status = await tajo.connectors.status('brevo');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-01-15T10:30:00Z',
//   contactsSynced: 25400,
//   campaignsSent: 142,
//   eventsTracked: 89320
// }

Lacak custom event

// Track a custom event for a contact
await tajo.brevo.trackEvent({
  email: '[email protected]',
  event: 'product_purchased',
  eventdata: {
    id: 'txn_98765',
    data: {
      product_name: 'Premium Widget',
      price: 49.99,
      currency: 'USD'
    }
  }
});

Batas rate

Brevo menerapkan batas rate dalam tiga tingkatan berdasarkan paket Anda:

Pemecahan masalah

Masalah umum

Mode debug

Aktifkan logging terperinci:

connectors:
  brevo:
    debug: true
    log_level: verbose
    log_webhooks: true

Uji koneksi

tajo connectors test brevo
# ✓ API connection successful
# ✓ Contacts API accessible
# ✓ Transactional email ready
# ✓ SMS sending configured
# ✓ Webhooks registered

Praktik terbaik

1. Rotasi API key - Rotasikan API key secara berkala demi keamanan
2. Terapkan verifikasi webhook - Validasi signature webhook dengan autentikasi username/password
3. Impor kontak secara batch - Gunakan impor massal untuk dataset besar alih-alih panggilan API satu per satu
4. Pantau batas rate - Periksa header batas rate untuk menghindari error 429
5. Gunakan pelacakan event - Terapkan Brevo Tracker untuk data perilaku pelanggan yang menyeluruh
6. Siapkan autentikasi pengirim yang benar - Konfigurasikan SPF, DKIM, dan DMARC demi deliverability optimal

Keamanan

• Autentikasi API key - Akses berbasis token rahasia melalui header api-key
• OAuth 2.0 - Akses terdelegasi berbasis token untuk integrasi privat
• Verifikasi webhook - Autentikasi username dan password untuk panggilan webhook yang aman
• Enkripsi TLS - Semua komunikasi API dienkripsi saat transit
• Whitelist IP - Pembatasan IP opsional yang tersedia pada paket Enterprise

Sumber terkait

• Dokumentasi API Brevo
• Panduan Autentikasi Brevo
• Batas Rate Brevo
• Konektor Shopify
• Skill Customer Sync
• API Kontak Brevo