Brevo Bağlayıcısı

Brevo Bağlayıcısı

Birleşik kişi yönetimi, e-posta, SMS ve WhatsApp üzerinden işlemsel mesajlaşma ve kapsamlı pazarlama otomasyonu için Brevo hesabınızı Tajo’ya bağlayın.

Genel Bakış

Özellikler

• Çok kanallı mesajlaşma - Birleşik bir API’den işlemsel e-posta, SMS ve WhatsApp gönderin
• Kişi yönetimi - Özel özniteliklerle kişiler oluşturun, güncelleyin ve segmentlere ayırın
• Pazarlama kampanyaları - Programatik olarak e-posta kampanyaları oluşturun ve gönderin
• Olay takibi - Brevo Tracker üzerinden özel olayları ve site etkinliklerini takip edin
• eCommerce senkronizasyonu - Kişiselleştirilmiş kampanyalar için ürünleri, siparişleri ve sepet verilerini senkronize edin
• Sadakat programları - Sadakat aboneliklerini, puanlarını ve üye verilerini yönetin
• Webhook desteği - İşlemsel, pazarlama ve CRM olayları için gerçek zamanlı olay bildirimleri
• Konuşmalar - Canlı sohbet widget entegrasyonu ve programatik mesaj yönetimi

Ön Koşullar

Başlamadan önce sahip olmanız gerekenler:

1. Bir Brevo hesabı (Free, Starter, Business veya Enterprise planı)
2. Brevo Settings > API Keys bölümünden oluşturulmuş bir API anahtarı
3. API erişimi olan bir Tajo hesabı
4. E-posta gönderimi için doğrulanmış gönderici alan adı

Kimlik Doğrulama

Brevo iki kimlik doğrulama yöntemini destekler:

API Anahtar Kimlik Doğrulaması (Önerilen)

API anahtarınızı her istekte api-key başlığına ekleyin. Doğrudan entegrasyonlar ve sunucu-sunucu iletişimi için en uygunudur.

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

OAuth 2.0 Kimlik Doğrulaması

Bir kuruluş içinde delege erişim ve kullanıcıya özel izinler gerektiren özel entegrasyonlar için OAuth 2.0 kullanın. OAuth, tanımlı geçerlilik süreleri olan belirteç tabanlı bir sistem sağlar.

Yapılandırma

Temel Kurulum

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

Alan Eşleme

Veri alanlarınızı Brevo kişi özniteliklerine eşleyin:

Özel Öznitelik Eşleme

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 Uç Noktaları

Temel Uç Noktalar

eCommerce Uç Noktaları

Kampanya Uç Noktaları

Olaylar

İşlemsel Olaylar

eCommerce Olayları

Kod Örnekleri

Bağlayıcıyı Başlat

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

İşlemsel E-posta Gönder

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

Kişileri Senkronize Et

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

Özel Olayları Takip Et

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

Hız Limitleri

Brevo, planınıza göre üç katman üzerinden hız limitleri uygular:

Sorun Giderme

Sık Karşılaşılan Sorunlar

Hata Ayıklama Modu

Ayrıntılı günlüklemeyi etkinleştirin:

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

Bağlantıyı Test Et

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

En İyi Uygulamalar

1. API anahtar rotasyonu kullanın - Güvenlik için API anahtarlarını periyodik olarak rotasyona alın
2. Webhook doğrulaması uygulayın - Webhook imzalarını kullanıcı adı/şifre kimlik doğrulamasıyla doğrulayın
3. Kişi içe aktarmalarını gruplandırın - Bireysel API çağrıları yerine büyük veri kümeleri için toplu içe aktarma kullanın
4. Hız limitlerini izleyin - 429 hatalarından kaçınmak için hız limit başlıklarını kontrol edin
5. Olay takibini kullanın - Kapsamlı müşteri davranış verileri için Brevo Tracker’ı uygulayın
6. Uygun gönderici kimlik doğrulamasını kurun - Optimal teslim edilebilirlik için SPF, DKIM ve DMARC yapılandırın

Güvenlik

• API Anahtar Kimlik Doğrulaması - api-key başlığı üzerinden gizli belirteç tabanlı erişim
• OAuth 2.0 - Özel entegrasyonlar için belirteç tabanlı delege erişim
• Webhook doğrulama - Güvenli webhook çağrıları için kullanıcı adı ve şifre kimlik doğrulaması
• TLS şifrelemesi - Tüm API iletişimi aktarımda şifrelenir
• IP beyaz listesi - Enterprise planlarda mevcut isteğe bağlı IP kısıtlamaları

İlgili Kaynaklar

• Brevo API Dokümantasyonu
• Brevo Kimlik Doğrulama Rehberi
• Brevo Hız Limitleri
• Shopify Bağlayıcısı
• Müşteri Senkronizasyon Yeteneği
• Brevo Kişiler API’si