Bu rehberde: Kit (eski adıyla ConvertKit) hesabınızı v4 API anahtarıyla bağlarsınız. Bülten aboneleriniz bir Kit etiketine eşitlenir, bültenler Kit'te broadcast olarak oluşturulup o etiketin abonelerine gönderilir; iş akışlarında abone ekleyip etiketleyebilir, Kit'te etkinleşen abonelerle akış başlatabilirsiniz.
⏱ 10 dakika
Kimlik kartı
| Alan | Değer |
|---|---|
| Sağlayıcı anahtarı | KIT |
| Kategori | Mesajlaşma (e-posta pazarlama) |
| Kimlik doğrulama | API anahtarı v4 (X-Kit-Api-Key başlığı) |
| Kapsam | Proje bazlı |
| Webhook | Evet – bağlanınca otomatik oluşturulur, imzalı (X-Kit-Signature) |
| Yetenekler | Bülten, uygulama işlemleri, uygulama tetikleyicileri |
Ne işe yarar?
- Abone eşitleme: onaylı bülten aboneleri Kit'e eklenir (100'erli toplu istekler) ve seçtiğiniz etiket verilir. Kit'te abonelikten çıkmış (
cancelled) ya da geri dönen (bounced) kişiler etiketlenmez ve eşitleme sonucunda "atlandı" görünür; OrqLabs kimseyi yeniden abone yapmaz. - Bülten gönderimi: bülten Kit'te bir broadcast olarak oluşturulur, hedefi seçtiğiniz etikettir ve hemen gönderilir. İçerik Kit'in varsayılan e-posta şablonuna yerleştirilir; abonelikten çıkma bağlantısı Kit'in
{{ unsubscribe_url }}etiketiyle eklenir. - İstatistikler: alıcı, açılma, tıklama ve abonelikten çıkma sayıları Kit broadcast istatistiklerinden okunur (Kit API geri dönme sayısı vermez).
- Kit kutusu (iş akışı): abone ekle/güncelle, etiketle, etiketi kaldır, abonelikten çıkar, aboneyi bul, etiketleri listele.
- Tetikleyiciler: Abone etkinleşti (
subscriber.activated) ve Abonelikten çıktı (subscriber.unsubscribed).
Gönderim ücretleri Kit planınıza aittir; OrqLabs kredinizden düşmez.
Ön koşullar
- kit.com hesabı ve en az bir etiket (Subscribers → Tags). Bülten listesi olarak kullanacağınız etiketi önceden oluşturun.
- Kit'te onaylı bir gönderim adresi (Settings → Email → Sending addresses).
Adım adım kurulum
- Kit'te Settings → Developer → API keys (v4) → Add a new key → adı
OrqLabs→ anahtarı kopyalayın. - OrqLabs'ta Entegrasyonlar → Kit (ConvertKit) → Bağla → projeyi seçin → API key (v4) alanına yapıştırın → Bağla.
- Bağlantı sırasında OrqLabs, Kit'te bir webhook uç noktası oluşturur (abone etkinleşti / abonelikten çıktı) ve Kit'in verdiği imza anahtarını saklar. Kartta "Webhook kaydı başarısız" görürseniz anahtarın v4 olduğundan emin olup Bağlantıyı test et'e basın.
- Kartın ayrıntı panelindeki Bülten varsayılanları bölümünde Etiket'i seçin. İsterseniz Gönderen e-posta alanına Kit'te onaylı bir gönderim adresi yazın (boş → hesabın varsayılan adresi) → Kaydet.
- Bülten → Listeler sayfasında listenizin gönderim hesabını bu Kit bağlantısı yapın.
İş akışı kutusu: Kit
| İşlem | Ne yapar | Çıktı |
|---|---|---|
| Abone ekle / güncelle | E-postayla abone oluşturur (varsa adını ve özel alanlarını günceller), isteğe bağlı etiketler | subscriberId, state, created, tagged |
| Aboneyi etiketle | Var olan aboneye etiket ekler (etiketin dizileri başlar) | alreadyTagged |
| Etiketi kaldır | Etiketi kaldırır; abone ve diğer etiketleri kalır | removed |
| Abonelikten çıkar | Abonenin tüm Kit e-postalarından çıkmasını sağlar | unsubscribed |
| Aboneyi bul | E-postayla arar | found, state, fields |
| Etiketleri listele | Hesaptaki etiketler | tagId, name |
Etiket ID: Kit'te etiketi açtığınızda adres çubuğundaki sayıdır veya Etiketleri listele çıktısındaki tagId.
Tetikleyici: Entegrasyon olayı
İş akışına Entegrasyon olayı tetikleyicisini ekleyin, Kit bağlantınızı ve KIT · Subscriber activated (veya Subscriber unsubscribed) olayını seçin. İlk öğe subscriberId, email, firstName, state, createdAt, fields alanlarını taşır. Teslimatlar X-Kit-Signature (HMAC-SHA256, 5 dakikalık pencere) ile doğrulanır; aynı olay iki kez gelirse bir kez işlenir.
Limitler
| Konu | Sınır |
|---|---|
| API hız sınırı | Kit API anahtarı başına dakikada 120 istek; aşılırsa RATE_LIMIT ve bekleyip yeniden deneme |
| Toplu eşitleme | 100 aboneye kadar tek istek (Kit'in eşzamanlı sınırı) |
| Onaylanmamış aboneler | Kit'e gönderilmez; OrqLabs'ta onay verdiklerinde eşitlenir |
| Planlama | OrqLabs planlanan saatte gönderir; broadcast o anda Kit'te oluşturulur |
Sık karşılaşılan hatalar
| Hata | Olası neden | Çözüm |
|---|---|---|
AUTH – 401 | Anahtar yanlış, silinmiş veya v3 anahtarı | Settings → Developer'dan v4 anahtarı üretin |
CONFIG – "tag id must be a numeric Kit tag id" | Varsayılan etiket seçilmedi | Ayrıntı panelinde etiket seçin |
FORBIDDEN – 403 | Abone sayısı plan sınırını aşacak | Kit planını yükseltin |
CONFIG – 422 e-posta adresi | Gönderen adresi Kit'te onaylı değil | Sending addresses bölümünden onaylayın veya alanı boş bırakın |
| Bülten "başarısız" | Broadcast oluşturulamadı | Kit → Broadcasts'ta taslak olmadığını kontrol edip yeniden gönderin; gönderim otomatik yeniden denenmez |
Sık sorulan sorular
Neden liste değil de etiket? Kit'te bağımsız "liste" yoktur; aboneler etiket ve formlarla gruplanır. Broadcast'ler etikete göre hedeflenebildiği için OrqLabs etiketi liste gibi kullanır.
Abonelikten çıkanlar ne olur?
Kit'teki bağlantıyla çıkan kişi Kit'te cancelled olur, OrqLabs onu yeniden etiketlemez. OrqLabs'ta çıkan kişinin Kit etiketi kaldırılır.