Brevo Connector

Brevo Connector

Poveži račun Brevo s Tajo za enotno upravljanje stikov, transakcijsko sporočanje prek e-maila, SMS in WhatsApp ter celovito marketinško avtomatizacijo.

Pregled

Funkcionalnosti

• Večkanalno sporočanje – pošlji transakcijske e-maile, SMS in WhatsApp iz enotnega API
• Upravljanje stikov – ustvari, posodobi in segmentiraj stike z atributi po meri
• Marketinške kampanje – programsko ustvari in pošlji e-mailne kampanje
• Sledenje dogodkom – sledi dogodkom po meri in dejavnosti spletnega mesta prek sledilnika Brevo
• Sinhronizacija e-trgovine – sinhroniziraj izdelke, naročila in podatke o košarici za personalizirane kampanje
• Programi zvestobe – upravljaj naročnine na zvestobo, točke in podatke članov
• Podpora za webhooks – obvestila o dogodkih v realnem času za transakcijske, marketinške in CRM dogodke
• Pogovori – integracija klepetalnega widgeta v živo in programsko upravljanje sporočil

Predpogoji

Preden začneš, se prepričaj, da imaš:

1. Račun Brevo (plan Free, Starter, Business ali Enterprise)
2. Ključ API, ustvarjen iz Brevo Settings > API Keys
3. Tajo račun z dostopom do API
4. Preverjena domene pošiljatelja za pošiljanje e-mailov

Avtentikacija

Brevo podpira dve metodi avtentikacije:

Avtentikacija z API ključem (priporočeno)

V vsak zahtevek vključi ključ API v glavi api-key. Najprimernejše za neposredne integracije in komunikacijo med strežniki.

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

Avtentikacija OAuth 2.0

Uporabi OAuth 2.0 za zasebne integracije znotraj organizacije, ki zahtevajo pooblastilan dostop in dovoljenja za specifične uporabnike. OAuth zagotavlja sistem na osnovi žetonov z določenimi veljavnostnimi obdobji.

Konfiguracija

Osnovna nastavitev

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

Preslikava polj

Preslikaj podatkovna polja v atribute stikov Brevo:

Preslikava atributov po meri

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

Končne točke API

Osnovne končne točke

Končne točke e-trgovine

Končne točke kampanj

Dogodki

Transakcijski dogodki

Dogodki e-trgovine

Primeri kode

Inicializacija konektorja

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
});

Pošiljanje transakcijskega e-maila

// 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'
  }
});

Sinhronizacija stikov

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

Sledenje dogodkom po meri

// 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'
    }
  }
});

Omejitve hitrosti

Brevo uveljavlja omejitve hitrosti v treh nivojih glede na plan:

Odpravljanje težav

Pogoste težave

Način odpravljanja napak

Omogoči podrobno beleženje:

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

Preizkus povezave

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

Najboljše prakse

1. Rotacija API ključev – periodično menjaj API ključe za varnost
2. Implementiraj preverjanje webhooks – potrdi podpise webhooks z avtentikacijo z uporabniškim imenom/geslom
3. Paketni uvozi stikov – za velike nabore podatkov namesto posameznih klicev API uporabi množičen uvoz
4. Sprljuj omejitve hitrosti – preverjaj glave omejitev hitrosti za izogibanje napakam 429
5. Uporabi sledenje dogodkov – implementiraj sledilnik Brevo za celovite podatke o vedenju strank
6. Nastavi pravilno avtentikacijo pošiljatelja – konfiguriraj SPF, DKIM in DMARC za optimalno dostavljivost

Varnost

• Avtentikacija z API ključem – dostop z žetonom prek glave api-key
• OAuth 2.0 – pooblaščen dostop na osnovi žetonov za zasebne integracije
• Preverjanje webhooks – avtentikacija z uporabniškim imenom in geslom za varne klice webhooks
• TLS šifriranje – vsa komunikacija API šifrirana med prenosom
• Dovoljevanje IP – neobvezne omejitve IP na planih Enterprise

Povezani viri

• Brevo API dokumentacija
• Vodnik za avtentikacijo Brevo
• Omejitve hitrosti Brevo
• Shopify Connector
• Customer Sync Skill
• Brevo Contacts API