Bu rehberde: Mailchimp hesabınızı bir API anahtarıyla bağlarsınız. Bülten aboneleriniz bir Mailchimp kitlesine (audience) eşitlenir, kampanyalar kendi Mailchimp hesabınızdan gönderilir; 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ı | MAILCHIMP |
| Kategori | Mesajlaşma (e-posta pazarlama) |
| Kimlik doğrulama | API anahtarı (Basic auth) |
| Kapsam | Proje bazlı |
| Webhook | Hayır |
| Yetenekler | Bülten, toplu gönderim |
Ne işe yarar?
- Abone eşitleme: aboneler seçtiğiniz kitleye eklenir; ad ve soyad
FNAME/LNAMEalanlarına yazılır. Onaylanmış aboneler subscribed, henüz onaylamamışlar pending olarak eklenir. - Kampanya gönderimi: Mailchimp'te normal (regular) bir kampanya oluşturulur, HTML ve düz metin içerik yüklenir, hemen gönderilir ya da planlanır.
- İstatistikler: gönderilen, teslim edilen, açılma (toplam / tekil), tıklama, abonelikten çıkma ve geri dönme sayıları Mailchimp raporundan okunur.
Gönderim ücretlerini Mailchimp'e siz ödersiniz; bu gönderimler OrqLabs kredinizden düşmez.
Ön koşullar
- mailchimp.com hesabı ve en az bir kitle (Audience).
- Yanıt adresi olarak kullanacağınız alan adının Mailchimp'te doğrulanması (Website → Domains). Doğrulanmamış adreslerden gönderim teslim sorunlarına yol açar.
Adım adım kurulum
A) Mailchimp'te API anahtarı
- Sol alttaki profil → Profile → Extras → API keys.
- Create A Key → bir ad verin (
OrqLabs) → Generate Key. - Anahtarı kopyalayın;
0123…cdef-us21gibi görünür. Tireden sonraki kısım (us21) hesabınızın veri merkezidir; OrqLabs API adresini (https://us21.api.mailchimp.com/3.0) buradan bulur. Anahtarı eksiksiz kopyalayın.
B) OrqLabs'ta bağlama
- Entegrasyonlar → Mailchimp → Bağla → Proje seçin.
- API key alanına anahtarı yapıştırın → Bağla.
- Karta tıklayın; Bülten varsayılanları bölümünde:
- Kitle (audience): aboneler bu kitleye eşitlenir, kampanyalar bu kitleye gider. Kitlenin Mailchimp'teki varsayılan gönderen adı ve adresi boş alanlara otomatik dolar.
- Gönderen adı (zorunlu) ve Yanıt adresi (zorunlu). Mailchimp yanıt adresini gönderen adresi olarak da kullanır.
- Kaydet. Seçtiğiniz kitle hesapta yoksa kayıt reddedilir; Listeyi yenile ile güncel kitleleri çekin.
Çift onay (double opt-in)
- OrqLabs'ta onaylanmış aboneler Mailchimp'e subscribed olarak eklenir.
- Henüz onaylamamış aboneler pending olarak eklenir. Mailchimp bu kişilere kendi onay e-postasını gönderir; kişi bağlantıya tıklayınca abone olur. Onaylamayan kişiye kampanya gitmez.
- Kitlede zaten bulunan kişilerin durumu değiştirilmez. Mailchimp'te abonelikten çıkmış birini OrqLabs yeniden abone yapmaz; eşitleme sonucunda "atlandı" olarak görünür.
İzinler
Mailchimp API anahtarları hesabın tamamına erişir. OrqLabs yalnızca hesap bilgisi, kitleler, üyeler, kampanyalar ve raporlarla çalışır. Anahtarı yalnızca OrqLabs için üretin.
Limitler
| Konu | Sınır |
|---|---|
| Eşzamanlı bağlantı | Mailchimp hesap başına 10 eşzamanlı istek |
| Toplu ekleme | 50 kişiye kadar tek tek, üzeri 500'lük gruplar |
| Planlama | Mailchimp yalnızca çeyrek saatlere (:00, :15, :30, :45) planlar; OrqLabs saati bir sonraki çeyreğe yuvarlar |
| Abonelikten çıkma bağlantısı | HTML'de *|UNSUB|* yoksa OrqLabs e-postanın sonuna ekler |
Bağlantıyı test etme
Bağlantıyı test et önce GET /ping, sonra hesap bilgisini ve kitleleri okur. Başarılıysa hesap adınız, veri merkeziniz ve kitle sayısı görünür.
Kimlik bilgilerini yenileme
Mailchimp'te yeni anahtar üretin → ayrıntı panelinde Kimlik bilgileri → Güncelle → API key → Kaydet. Eski anahtarı Mailchimp'te iptal edin.
Sık karşılaşılan hatalar
| Hata | Olası neden | Çözüm |
|---|---|---|
CONFIG – "data center suffix" | Anahtar eksik kopyalandı (tire ve usXX yok) | Anahtarı tamamen kopyalayın |
AUTH – 401 "API Key Invalid" | Anahtar iptal edilmiş veya yanlış | Yeni anahtar girin |
FORBIDDEN – 403 | Hesap askıya alınmış veya kullanıcı yetkisi yetersiz | Mailchimp hesap durumunu kontrol edin |
CONFIG – "from name / reply-to is required" | Varsayılanlar girilmedi | Ayrıntı panelinden doldurun |
CONFIG – 400 "Your Campaign is not ready to send" | Eksik ayar (adres, içerik, doğrulanmamış alan adı) | Mailchimp'teki uyarıyı okuyun; alan adını doğrulayın |
RATE_LIMIT – 429 | Çok fazla eşzamanlı istek | OrqLabs bekleyip yeniden dener |
Sık sorulan sorular
Kampanya Mailchimp'te taslak olarak kalır mı? Gönderim Mailchimp tarafından reddedilirse OrqLabs oluşturduğu taslağı siler; böylece tekrar denemeler taslak yığını bırakmaz.
Gönderim ücreti kime ait? Mailchimp planınıza. OrqLabs bu gönderimler için kredi düşmez.