Brevo konektor

Brevo konektor

Poveži svoj Brevo nalog sa Tajo za unifikovano upravljanje kontaktima, transakcionim porukama putem emaila, SMS-a i WhatsApp-a, i sveobuhvatnu marketing automatizaciju.

Pregled

Karakteristike

• Slanje na više kanala - Slanje transakcionih emailova, SMS-a i WhatsApp poruka iz unifikovanog API-ja
• Upravljanje kontaktima - Kreiranje, ažuriranje i segmentacija kontakata sa prilagođenim atributima
• Marketing kampanje - Programatsko kreiranje i slanje email kampanja
• Praćenje događaja - Praćenje prilagođenih događaja i aktivnosti na veb sajtu putem Brevo Tracker-a
• eCommerce sinhronizacija - Sinhronizacija proizvoda, porudžbina i podataka korpe za personalizovane kampanje
• Programi lojalnosti - Upravljanje pretplatama lojalnosti, poentima i podacima članova
• Podrška za webhook-ove - Obaveštenja o događajima u realnom vremenu za transakcione, marketing i CRM događaje
• Razgovori - Integracija live chat widgeta i programatsko upravljanje porukama

Preduslovi

Pre nego što započneš, proveri da imaš:

1. Brevo nalog (Free, Starter, Business ili Enterprise plan)
2. API ključ generisan iz Brevo Settings > API Keys
3. Tajo nalog sa API pristupom
4. Verifikovani domen pošiljaoca za slanje emailova

Autentifikacija

Brevo podržava dve metode autentifikacije:

Autentifikacija API ključem (preporučeno)

Uključi API ključ u header api-key sa svakim zahtevom. Najbolje za direktne integracije i server-to-server komunikaciju.

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

OAuth 2.0 autentifikacija

Koristi OAuth 2.0 za privatne integracije unutar organizacije koje zahtevaju delegirani pristup i dozvole specifične za korisnika. OAuth pruža sistem zasnovan na tokenima sa definisanim periodima važenja.

Konfiguracija

Osnovno podešavanje

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

Mapiranje polja

Mapiranje polja podataka na Brevo atribute kontakta:

Mapiranje prilagođenih atributa

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

API endpointi

Osnovni endpointi

eCommerce endpointi

Endpointi kampanja

Događaji

Transakcioni događaji

eCommerce događaji

Primeri koda

Inicijalizacija konektora

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

Slanje transakcionog emaila

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

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

Praćenje prilagođenih događaja

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

Ograničenja brzine

Brevo primenjuje ograničenja brzine na tri nivoa u zavisnosti od tvog plana:

Rešavanje problema

Česti problemi

Debug režim

Uključi detaljno logovanje:

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

Testiraj vezu

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

Najbolje prakse

1. Koristi rotaciju API ključeva - Periodično rotiraj API ključeve radi bezbednosti
2. Implementiraj verifikaciju webhook-ova - Validiraj potpise webhook-ova sa autentifikacijom korisničkim imenom/lozinkom
3. Batch uvoz kontakata - Koristi bulk uvoz za velike skupove podataka umesto pojedinačnih API poziva
4. Prati ograničenja brzine - Proveri headere ograničenja brzine da izbjegneš 429 greške
5. Koristi praćenje događaja - Implementiraj Brevo Tracker za sveobuhvatne podatke o ponašanju kupaca
6. Postavi pravilnu autentifikaciju pošiljaoca - Konfiguriši SPF, DKIM i DMARC za optimalnu dostavljivost

Bezbednost

• Autentifikacija API ključem - Pristup zasnovan na tajnom tokenu putem headera api-key
• OAuth 2.0 - Delegirani pristup zasnovan na tokenima za privatne integracije
• Verifikacija webhook-ova - Autentifikacija korisničkim imenom i lozinkom za bezbedne webhook pozive
• TLS enkripcija - Sva API komunikacija enkriptovana u prenosu
• IP allowlisting - Opcijska IP ograničenja dostupna na Enterprise planovima

Povezani resursi

• Brevo API dokumentacija
• Brevo vodič za autentifikaciju
• Brevo ograničenja brzine
• Shopify konektor
• Customer Sync veština
• Brevo Contacts API