Bu rehberde: Brevo (eski adıyla Sendinblue) hesabınızı bir API anahtarıyla bağlarsınız. Bülten aboneleriniz bir Brevo kişi listesine eşitlenir, kampanyalar kendi Brevo hesabınızdan ve doğrulanmış göndereninizden çıkar; açılma, tıklama ve geri dönme sayıları OrqLabs'a geri gelir.
⏱ 10 dakika
Kimlik kartı
| Alan | Değer |
|---|---|
| Sağlayıcı anahtarı | BREVO |
| Kategori | Mesajlaşma (e-posta pazarlama) |
| Kimlik doğrulama | API anahtarı (api-key başlığı) |
| Kapsam | Proje bazlı |
| Webhook | Hayır |
| Yetenekler | Bülten, toplu gönderim |
Ne işe yarar?
OrqLabs'ın bülten modülü gönderimi isterseniz kendi Brevo hesabınıza devreder:
- Abone eşitleme: onaylı aboneler seçtiğiniz Brevo listesine eklenir veya güncellenir (ad, soyad
FIRSTNAME/LASTNAMEniteliklerine yazılır). 100'den fazla kişi tek seferde Brevo'nun içe aktarma işlemiyle arka planda işlenir. - Kampanya gönderimi: konu, önizleme metni ve HTML içerikle Brevo'da bir e-posta kampanyası oluşturulur ve hemen ya da planlanan saatte gönderilir.
- İstatistikler: gönderilen, teslim edilen, açılma (toplam / tekil), tıklama, abonelikten çıkma ve geri dönme sayıları Brevo kampanya istatistiklerinden okunur.
Gönderim ücretlerini Brevo'ya siz ödersiniz; bu gönderimler OrqLabs kredinizden düşmez.
Ön koşullar
- brevo.com hesabı (ücretsiz plan günde 300 e-posta ile başlar).
- Brevo'da doğrulanmış bir gönderen (sender). Kampanyalar yalnızca doğrulanmış gönderenlerden çıkabilir; mümkünse alan adınızı da doğrulayın (DKIM / DMARC).
- En az bir kişi listesi (Contacts → Lists).
Adım adım kurulum
A) Brevo'da API anahtarı
- Sağ üstteki hesap menüsü → SMTP & API → API Keys sekmesi.
- Generate a new API key → bir ad verin (
OrqLabs) → Generate. xkeysib-ile başlayan anahtarı kopyalayın; yalnızca bir kez gösterilir.
Dikkat: Aynı sayfadaki SMTP sekmesinde üretilen
xsmtpsib-…anahtarı API'de çalışmaz. OrqLabs bu anahtarı bağlantı sırasında reddeder.
B) Doğrulanmış gönderen
- Senders, Domains & Dedicated IPs → Senders → Add a sender.
- Gönderen adı ve adresini girin; Brevo bu adrese doğrulama e-postası yollar.
- Bağlantıya tıklayınca gönderen Verified olur. Alan adınızı da Domains sekmesinden doğrulamanız teslim oranını artırır.
C) OrqLabs'ta bağlama
- Entegrasyonlar → Brevo → Bağla → Proje seçin.
- API key (v3) alanına
xkeysib-…anahtarını yapıştırın → Bağla. - Karta tıklayıp ayrıntı panelini açın. Bülten varsayılanları bölümünde:
- Kişi listesi: aboneler bu listeye eşitlenir, kampanyalar bu listeye gider.
- Gönderen: yalnızca Brevo'da doğrulanmış gönderenler seçilebilir; doğrulanmamışlar pasif görünür.
- Gönderen adı ve Yanıt adresi (isteğe bağlı).
- Kaydet. Liste ya da gönderen Brevo'da yoksa kayıt reddedilir; Listeyi yenile ile hesabınızdan güncel listeyi çekin.
Çift onay (double opt-in)
OrqLabs'ta onaylanmış aboneler Brevo'ya doğrudan "abone" olarak eklenir. Henüz onaylamamış aboneler için iki seçenek vardır:
- Brevo'nun kendi onay e-postası: Brevo'da Templates bölümünde Double opt-in türünde bir şablon oluşturun; şablon kimliğini (ör.
12) ve onay sonrası yönlendirme adresini ayrıntı panelindeki Çift onay şablonu ve Onay sonrası yönlendirme adresi alanlarına girin. Onaylamamış aboneler bu e-postayı Brevo'dan alır, bağlantıya tıklayınca listeye eklenir. - Şablon girilmezse: onaylamamış aboneler Brevo'ya hiç gönderilmez ve eşitleme sonucunda "atlandı" olarak görünür. Onay verdiklerinde bir sonraki eşitlemede eklenirler.
İzinler
Brevo API anahtarları hesabın tamamına erişir; ayrı kapsam seçimi yoktur. OrqLabs yalnızca hesap bilgisi, listeler, gönderenler, kişiler ve e-posta kampanyalarıyla çalışır. Anahtarı yalnızca OrqLabs için üretin; işiniz bitince Brevo'da silebilirsiniz.
Limitler
| Konu | Sınır |
|---|---|
| Ücretsiz plan | Günde 300 e-posta, Brevo logosu e-postada görünür |
| Tek seferde kişi ekleme | 100 kişiye kadar tek tek, üzeri arka plan içe aktarma |
| API hız sınırı | Plana göre değişir; aşılırsa RATE_LIMIT ve bekleme süresi |
| Planlama | Kampanya planlı saatte Brevo tarafından gönderilir |
Bağlantıyı test etme
Bağlantıyı test et Brevo hesabınızı (GET /account), listeleri ve gönderenleri okur. Başarılıysa şirket adınız, liste sayısı ve doğrulanmış gönderenler görünür.
Kimlik bilgilerini yenileme
Brevo'da yeni anahtar üretin → ayrıntı panelinde Kimlik bilgileri → Güncelle → API key → Kaydet. Eski anahtarı Brevo'da silin.
Sık karşılaşılan hatalar
| Hata | Olası neden | Çözüm |
|---|---|---|
CONFIG – "Brevo API keys start with xkeysib-" | SMTP anahtarı girildi | API Keys sekmesinden anahtar üretin |
AUTH – 401 "Key not found" | Anahtar silinmiş veya yanlış | Yeni anahtar girin |
FORBIDDEN – 402/403 | Plan / kredi yetersiz, hesap henüz onaylanmamış | Brevo'da planı ve hesap durumunu kontrol edin |
CONFIG – "pick a verified Brevo sender" | Varsayılan gönderen seçilmedi | Ayrıntı panelinden gönderen seçin |
CONFIG – 400 "sender is not valid" | Gönderen doğrulanmamış veya silinmiş | Brevo'da doğrulayın, Listeyi yenile |
RATE_LIMIT – 429 | Çok sık istek | OrqLabs bekleme süresinden sonra yeniden dener |
| Onaylamamış aboneler eklenmiyor | Çift onay şablonu girilmedi | Yukarıdaki Çift onay bölümüne bakın |
Sık sorulan sorular
Abonelikten çıkanlar ne olur? Brevo'nun e-postadaki abonelikten çıkma bağlantısını kullananlar Brevo'da işaretlenir; OrqLabs onları yeniden abone yapmaz. OrqLabs'ta abonelikten çıkan bir kişi Brevo listesinden de çıkarılır.
Gönderim ücreti kime ait? Brevo planınıza. OrqLabs bu gönderimler için kredi düşmez.