Bu rehberde: beehiiv yayınınızı (publication) bir API anahtarı ve yayın kimliğiyle bağlarsınız. Onaylı bülten aboneleriniz beehiiv'e eşitlenir; planınız izin veriyorsa bülten beehiiv'de gönderi (post) olarak yayımlanır. İş akışlarında abone ekleyebilir, beehiiv'de onaylanan aboneliklerle akış başlatabilirsiniz.
⏱ 10 dakika
Kimlik kartı
| Alan | Değer |
|---|---|
| Sağlayıcı anahtarı | BEEHIIV |
| Kategori | Mesajlaşma (e-posta pazarlama) |
| Kimlik doğrulama | API anahtarı (Authorization: Bearer) + yayın kimliği (pub_…) |
| Kapsam | Proje bazlı |
| Webhook | Evet – bağlanınca otomatik oluşturulur (adrese eklenen gizli belirteçle doğrulanır) |
| Yetenekler | Bülten, uygulama işlemleri, uygulama tetikleyicileri |
Ne işe yarar?
- Abone eşitleme (tüm planlar): onaylı bülten aboneleri yayınınıza abone olarak eklenir. beehiiv'de abonelikten çıkmış kişiler yeniden etkinleştirilmez (
reactivate_existing: false) ve "atlandı" görünür; hoş geldin e-postası gönderilmez. - Gönderi yayımlama (Max ve Enterprise planları): bülten beehiiv'de bir gönderi olarak oluşturulur, konu ve önizleme metni e-posta ayarlarına yazılır ve yayımlanır. beehiiv kendi alt bilgisini (abonelikten çıkma bağlantısı dahil) ekler.
- İstatistikler: alıcı, teslim, açılma, tekil açılma, tıklama ve abonelikten çıkma sayıları gönderi istatistiklerinden okunur.
- beehiiv kutusu (iş akışı): abone ekle, aboneyi bul, abonelikten çıkar, gönderileri listele.
- Tetikleyici: Abonelik onaylandı (
subscription.confirmed).
Önemli – plan sınırı: beehiiv, API ile gönderi oluşturmayı yalnızca Max ve Enterprise planlarına açar. Diğer planlarda OrqLabs'tan gönderim
CONFIGhatasıyla durur ("needs a beehiiv Max or Enterprise plan"). Bu durumda abone eşitlemesini kullanmaya devam edin ve bülteni beehiiv'in kendi editöründe yazıp gönderin.
Ön koşullar
- beehiiv.com hesabı ve bir yayın.
- Gönderi yayımlamak için Max veya Enterprise planı (abone eşitleme için gerekmez).
Adım adım kurulum
- beehiiv'de Settings → Integrations → API → Create New API Key → adı
OrqLabs→ anahtarı kopyalayın. - Aynı sayfadaki Publication ID değerini (
pub_ile başlar) kopyalayın. - OrqLabs'ta Entegrasyonlar → beehiiv → Bağla → projeyi seçin → API key ve Publication ID alanlarını doldurun → Bağla.
- Bağlantı sırasında OrqLabs, yayınınızda subscription.confirmed olayı için bir webhook oluşturur. Adres OrqLabs'ın gizli belirtecini taşır; bu adresi paylaşmayın.
- Ayrıntı panelindeki Bülten varsayılanları bölümünde Yayın otomatik olarak sizin yayınınızdır; isterseniz seçip kaydedin.
- Bülten → Listeler sayfasında listenin gönderim hesabını bu beehiiv bağlantısı yapın.
Çift onay (double opt-in)
- OrqLabs'ta onaylı aboneler beehiiv'e çift onay kapalı olarak eklenir (zaten onay verdiler).
- İş akışındaki Abone ekle işleminde Double opt-in seçeneğiyle yayın ayarını kullanabilir, beehiiv'in onay e-postasını açabilir veya kapatabilirsiniz.
İş akışı kutusu: beehiiv
| İşlem | Ne yapar | Çıktı |
|---|---|---|
| Abone ekle | E-postayı yayına abone yapar; çıkmış biri yalnızca Reactivate açıksa geri döner | subscriptionId, status, tier |
| Aboneyi bul | E-postayla aboneliği arar | found, status, utmSource |
| Abonelikten çıkar | Aboneliği sonlandırır | unsubscribed |
| Gönderileri listele | Son gönderiler (yayımlanmış/taslak) | postId, title, webUrl |
Tetikleyici: Entegrasyon olayı
Entegrasyon olayı tetikleyicisinde beehiiv bağlantınızı ve BEEHIIV · Subscription confirmed olayını seçin. İlk öğe subscriptionId, email, status, tier, created, utmSource, referringSite, tags alanlarını taşır. beehiiv teslimatları Svix ile imzalar, ancak bu imza anahtarı yalnızca beehiiv panelinde görünür; OrqLabs bu yüzden webhook adresindeki gizli belirteci doğrular.
Limitler
| Konu | Sınır |
|---|---|
| Gönderi oluşturma | Yalnızca Max / Enterprise |
| API hız sınırı | beehiiv'in sınırı aşılırsa RATE_LIMIT ve bekleyip yeniden deneme |
| Eşitleme | Abone başına bir istek; büyük listeler birkaç dakika sürebilir |
| Gönderim | Başarısız gönderim otomatik yeniden denenmez (aynı gönderi iki kez çıkmasın diye) |
Sık karşılaşılan hatalar
| Hata | Olası neden | Çözüm |
|---|---|---|
CONFIG – "publication id must look like pub_…" | Yayın kimliği eksik/yanlış | Settings → Integrations → API'den kopyalayın |
AUTH – 401 | Anahtar silinmiş veya yanlış | Yeni anahtar üretip Kimlik bilgileri → Güncelle |
CONFIG – "needs a beehiiv Max or Enterprise plan" | Planınız API ile gönderiye izin vermiyor | Bülteni beehiiv editöründe yazın; eşitleme çalışmaya devam eder |
| Aboneler "atlandı" | beehiiv'de abonelikten çıkmışlar | Doğru davranış; yeniden abone olmalarını kendileri seçmeli |