---
title: "Brevo Bağlayıcısı"
description: "Tajo ile kişileri, işlemsel e-postaları, SMS, WhatsApp kampanyalarını ve pazarlama otomasyonunu senkronize etmek için eksiksiz Brevo entegrasyon rehberi."
url: https://tajo.io/tr/docs/connectors/marketing/brevo/
markdown: https://tajo.io/tr/docs/connectors/marketing/brevo.md
lang: tr-TR
robots: noindex
---

Erken erişim talep edin

Adınızı ve iş e-posta adresinizi girin. Tajo erişim talebinizi onaylamanız için size bir bağlantı göndereceğiz.

# Brevo Bağlayıcısı

Bağlayıcı durumu: Aktif Doğrulandı. Tajo bu bağlayıcıyı bugün çalıştırıyor.

| Kaynak alanı | Hedef alanı | Örnek değer |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

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ış

| Özellik | Değer |
| --- | --- |
| **Platform** | Brevo |
| **Kategori** | Pazarlama |
| **Kurulum Karmaşıklığı** | Kolay |
| **Resmi Entegrasyon** | Evet |
| **Senkronize Edilen Veri** | Kişiler, Kampanyalar, İşlemsel Mesajlar, Olaylar, eCommerce |
| **API Temel URL’si** | `https://api.brevo.com/v3` |

## Ö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.

```bash
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.

OAuth Kullanılabilirliği

OAuth şu anda yalnızca bir kuruluş içindeki özel entegrasyonlar için kullanılabilir. OAuth entegrasyonları genel dağıtım veya pazaryeri listelemesi için tasarlanmamıştır.

## Yapılandırma

### Temel Kurulum

```yaml
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:

#### Varsayılan Eşlemeler

| Parameter | Type | Description |
| --- | --- | --- |
| `email` required | string | Kişi e-posta adresi (benzersiz tanımlayıcı) |
| `FIRSTNAME` optional | string | Kişi adı özniteliği |
| `LASTNAME` optional | string | Kişi soyadı özniteliği |
| `SMS` optional | string | SMS ve WhatsApp mesajlaşması için telefon numarası |
| `OPT_IN` optional | boolean | Pazarlama onay durumu |
| `ORDER_COUNT` optional | integer | Verilen toplam sipariş sayısı |
| `TOTAL_REVENUE` optional | number | Kişiden gelen yaşam boyu gelir |
| `LOYALTY_POINTS` optional | integer | Mevcut sadakat programı puan bakiyesi |

#### Özel Öznitelik Eşleme

```yaml
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

| Yöntem | Uç Nokta | Açıklama |
| --- | --- | --- |
| `POST` | `/v3/smtp/email` | İşlemsel e-posta gönder |
| `POST` | `/v3/transactionalSMS/send` | İşlemsel SMS gönder |
| `POST` | `/v3/whatsapp/sendMessage` | İşlemsel WhatsApp gönder |
| `POST` | `/v3/contacts` | Bir kişi oluştur |
| `PUT` | `/v3/contacts/{email}` | Bir kişiyi güncelle |
| `GET` | `/v3/contacts/{identifier}` | Kişi detaylarını al |
| `POST` | `/v3/contacts/import` | Toplu kişi içe aktar |

### eCommerce Uç Noktaları

| Yöntem | Uç Nokta | Açıklama |
| --- | --- | --- |
| `POST` | `/v3/orders/status` | Sipariş durumu oluştur veya güncelle |
| `POST` | `/v3/products` | Ürün oluştur veya güncelle |
| `POST` | `/v3/categories` | Ürün kategorileri oluştur veya güncelle |
| `POST` | `/v3/events` | Özel olayları takip et |

### Kampanya Uç Noktaları

| Yöntem | Uç Nokta | Açıklama |
| --- | --- | --- |
| `POST` | `/v3/emailCampaigns` | Bir e-posta kampanyası oluştur |
| `POST` | `/v3/emailCampaigns/{id}/sendNow` | Bir kampanyayı hemen gönder |
| `GET` | `/v3/emailCampaigns` | Tüm e-posta kampanyalarını listele |
| `GET` | `/v3/smtp/statistics/events` | E-posta olay istatistiklerini al |

## Olaylar

### İşlemsel Olaylar

| Olay | Tetikleyici | Kullanım Alanı |
| --- | --- | --- |
| `delivered` | E-posta gelen kutusuna teslim edildi | Teslimat onayı |
| `opened` | Alıcı tarafından e-posta açıldı | Etkileşim takibi |
| `clicked` | E-postadaki bağlantıya tıklandı | Tıklama takibi |
| `bounced` | E-posta geri döndü | Liste hijyeni |
| `spam` | Spam olarak işaretlendi | Uyumluluk izleme |
| `unsubscribed` | Kişi abonelikten çıktı | Tercih yönetimi |

### eCommerce Olayları

| Olay | Tetikleyici | Kullanım Alanı |
| --- | --- | --- |
| `order_completed` | Sipariş başarıyla verildi | Satın alma sonrası akışlar |
| `cart_updated` | Sepet içeriği değişti | Terk edilmiş sepet takibi |
| `cart_deleted` | Sepet temizlendi veya süresi doldu | Sepet kurtarma |
| `product_viewed` | Ürün sayfası ziyaret edildi | Gezinme terki |

## Kod Örnekleri

### Bağlayıcıyı Başlat

```javascript
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

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

### Kişileri Senkronize Et

```javascript
// 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

```javascript
// Track a custom event for a contact
await tajo.brevo.trackEvent({
  email: 'customer@example.com',
  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:

| Uç Nokta | Free/Starter | Professional | Enterprise |
| --- | --- | --- | --- |
| `POST /v3/smtp/email` | 1.000 RPS | 2.000 RPS | 6.000 RPS |
| `POST /v3/transactionalSMS/send` | 150 RPS | 200 RPS | 250 RPS |
| `POST /v3/events` | 10 RPS | 20 RPS | 60 RPS |
| `/v3/contacts/*` | 10 RPS | 20 RPS | 60 RPS |
| Diğer tüm uç noktalar | 100 RPH | 200 RPH | 600 RPH |

Hız Limit Yanıtı

Bir hız limitini aştığınızda, API bir `429 Too Many Requests` durum kodu döndürür. Kullanımınızı takip etmek için yanıtlardaki hız limit başlıklarını izleyin.

## Sorun Giderme

### Sık Karşılaşılan Sorunlar

| Sorun | Neden | Çözüm |
| --- | --- | --- |
| 401 Unauthorized | Geçersiz API anahtarı | Brevo Settings’te API anahtarını yeniden oluşturun |
| Kişi oluşturulmadı | E-posta alanı eksik | Tüm kişiler için e-postanın sağlandığından emin olun |
| E-posta teslim edilmedi | Doğrulanmamış gönderici alan adı | Brevo Senders ayarlarında alan adını doğrulayın |
| Webhook alınmıyor | Yanlış URL veya sunucu hatası | Webhook URL erişilebilirliğini ve günlüklerini kontrol edin |
| SMS gönderilmedi | Geçersiz telefon formatı | Ülke kodlu uluslararası format kullanın |

### Hata Ayıklama Modu

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

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

### Bağlantıyı Test Et

```bash
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](https://developers.brevo.com/docs/getting-started)
- [Brevo Kimlik Doğrulama Rehberi](https://developers.brevo.com/docs/authentication-schemes)
- [Brevo Hız Limitleri](https://developers.brevo.com/docs/api-limits)
- [Shopify Bağlayıcısı](https://tajo.io/tr/docs/connectors/ecommerce/shopify)
- [Müşteri Senkronizasyon Yeteneği](https://tajo.io/tr/docs/skills/data-sync/customer-sync)
- [Brevo Kişiler API’si](https://tajo.io/tr/docs/contact-management)