Bu rehberde: Klaviyo hesabınızı özel API anahtarıyla (
pk_…) bağlarsınız. Onaylı bülten aboneleriniz seçtiğiniz Klaviyo listesine e-posta pazarlama izniyle eklenir, bültenler Klaviyo kampanyası olarak gönderilir; iş akışlarında profil güncelleyebilir ve Klaviyo akışlarını (flow) başlatan özel olaylar gönderebilirsiniz.⏱ 10 dakika
Kimlik kartı
| Alan | Değer |
|---|---|
| Sağlayıcı anahtarı | KLAVIYO |
| Kategori | Mesajlaşma (e-posta pazarlama) |
| Kimlik doğrulama | Özel API anahtarı (Authorization: Klaviyo-API-Key pk_…, revision başlığı) |
| Kapsam | Proje bazlı |
| Webhook | Hayır |
| Yetenekler | Bülten, uygulama işlemleri |
Ne işe yarar?
- Abone eşitleme: onaylı aboneler, Klaviyo'nun toplu abonelik işiyle (1000'erli) listeye e-posta izniyle eklenir; ad ve soyad profil içe aktarmayla yazılır. Klaviyo'da abonelikten çıkmış veya bastırılmış (suppressed) profiller önce sorgulanır ve yeniden abone yapılmaz. Klaviyo bu işleri arka planda işlediği için OrqLabs kampanyayı eşitlemeden yaklaşık 3 dakika sonra oluşturur.
- Kampanya gönderimi: HTML içerik bir Klaviyo şablonu (CODE) olarak kaydedilir, listeye hedeflenen bir e-posta kampanyası oluşturulur, şablon atanır ve bir gönderim işi (send job) başlatılır. Abonelikten çıkma bağlantısı Klaviyo'nun
{% unsubscribe_url %}etiketiyle eklenir. - İstatistikler: alıcı, teslim, açılma, tekil açılma, tıklama, abonelikten çıkma ve geri dönme sayıları Klaviyo kampanya raporundan (son 12 ay) okunur.
- Klaviyo kutusu (iş akışı): listeye abone et, profil oluştur/güncelle, olay izle (track event), abonelikten çıkar, listeleri listele.
Gönderim ücretleri Klaviyo planınıza aittir; OrqLabs kredinizden düşmez.
Ön koşullar
- Bir klaviyo.com hesabı ve en az bir liste (Audience → Lists & segments).
- Klaviyo'da doğrulanmış bir gönderen adresi/alan adı ve hesap varsayılan göndereni (Settings → Account → Organization).
- Önerilen: listeyi tek onaylı (single opt-in) yapın. OrqLabs aboneleri zaten çift onaylı topluyor; liste çift onaylıysa Klaviyo bu kişilere ikinci bir onay e-postası gönderir ve onaylayana kadar kampanyayı almazlar.
Adım adım kurulum
- Klaviyo'da Settings → API keys → Create Private API Key → adı
OrqLabs. - Kapsamlar: Lists, Profiles, Subscriptions, Campaigns, Templates, Events, Metrics ve Accounts için Full (raporlar için Read) erişim → anahtarı kopyalayın (
pk_ile başlar). - OrqLabs'ta Entegrasyonlar → Klaviyo → Bağla → projeyi seçin → Private API key alanına yapıştırın → Bağla.
- Ayrıntı panelindeki Bülten varsayılanları bölümünde Kişi listesi'ni seçin. İsterseniz Gönderen e-posta, Gönderen adı ve Yanıt adresi girin (boş → Klaviyo hesabının varsayılan göndereni) → Kaydet.
- Bülten → Listeler sayfasında listenin gönderim hesabını bu Klaviyo bağlantısı yapın.
İş akışı kutusu: Klaviyo
| İşlem | Ne yapar | Çıktı |
|---|---|---|
| Listeye abone et | E-posta izni verip profili listeye ekler (listenin onay ayarı geçerlidir); Klaviyo'da çıkmış kişiyi atlar | queued veya skipped |
| Profil oluştur / güncelle | E-postaya göre profil oluşturur ya da günceller (izin değiştirmez) | profileId, created |
| Olay izle | Profil için özel bir olay (metric) kaydeder – Klaviyo akışlarını tetiklemek için | accepted |
| Abonelikten çıkar | E-posta pazarlama iznini geri alır (Liste ID verilirse o listeden) | queued |
| Listeleri listele | Hesaptaki listeler | listId, name, optInProcess |
Örnek: bir web formu tetikleyicisinden sonra Olay izle ile Requested demo olayı gönderin; Klaviyo'da bu metrikle başlayan bir flow kurarak karşılama dizisi başlatın.
Limitler
| Konu | Sınır |
|---|---|
| Toplu abonelik işi | İş başına 1000 profil; işlem arka planda (eşitleme sonucu "kuyrukta") |
| Kampanya raporu | Klaviyo raporlama uç noktası dakikada 2, günde 225 istek; istatistikleri gerektiğinde yenileyin |
| Tetikleyiciler | Yok (Klaviyo webhook'ları uygulama/ileri plan gerektirir) |
| Gönderim | Başarısız kampanya otomatik yeniden denenmez; kesin ret durumunda taslak kampanya silinir |
Sık karşılaşılan hatalar
| Hata | Olası neden | Çözüm |
|---|---|---|
CONFIG – "use a private API key (starts with pk_)" | Genel anahtar (site ID) girildi | Private API key oluşturun |
FORBIDDEN – 403 | Anahtarda eksik kapsam | Anahtarın kapsamlarını yukarıdaki listeye göre düzenleyin |
CONFIG – "no sender e-mail" | Ne ayrıntı panelinde ne de Klaviyo'da varsayılan gönderen var | Gönderen e-posta girin veya Klaviyo'da varsayılan gönderen tanımlayın |
| Aboneler kampanyayı almadı | Liste çift onaylı, aboneler Klaviyo onayını bekliyor | Listeyi tek onaylı yapın |
RATE_LIMIT – 429 | Çok sık istek (özellikle raporlar) | OrqLabs bekleyip yeniden dener; istatistik yenilemeyi seyrek yapın |