Bir Mailgun hesabına ve alan adınızın DNS ayarlarına erişime ihtiyacınız olacak.
Mailgun'ın kendi belgeleri: Alan adı ekleme ve doğrulama · API anahtarları · Kaydolun
1. Gönderim alan adınızı Mailgun'a ekleyin
Mailgun kontrol panelinde Send → Domains → Add New Domain yolunu izleyin ve bir alt alan adı girin, örneğin mail.yourdomain.com.
⚠️ Mailgun'ın kendi önerisi bir alt alan adı kullanılmasıdır ve bu durum burada bazı sağlayıcılara kıyasla daha büyük önem taşır: Mailgun, kendisine tanımladığınız öğeye kendi SPF ve DKIM kayıtlarını atar; bunu kök alan adınıza yönlendirmek, bu kayıtların kurumsal e-posta kutularınızın bağlı olduğu kayıtlarla bir arada yer alması anlamına gelir.
Verilerinizin barındırılmasını istediğiniz konuma uygun bölgeyi seçin — US veya EU. Bunu bir yere not edin; 4. adımda ihtiyacınız olacak ve yapılması en yaygın hata tam olarak budur.
2. Mailgun'ın size sağladığı DNS kayıtlarını yayımlayın
Mailgun size bir liste sunar. Bu kayıtların her birini DNS sağlayıcınıza ekleyin.
| Tür | Ana Bilgisayar (Host) | Amaç |
|---|
TXT | mail.yourdomain.com | SPF — v=spf1 include:mailgun.org ~all |
TXT | mailo._domainkey.mail.yourdomain.com | DKIM genel anahtarı |
CNAME | email.mail.yourdomain.com | İzleme ve teslim edilememe (bounce) yönetimi |
MX | mail.yourdomain.com | Teslim edilemeyen iletileri alma (Mailgun'ın iki MX ana bilgisayarı) |
⛔ Gönderim alt alan adınızın zaten bir SPF kaydı varsa, onu düzenleyin — ikinci bir kayıt eklemeyin. İki SPF TXT kaydı bulunan bir alan adı SPF doğrulamasında doğrudan başarısız olur; bu da hiç kayda sahip olmamaktan daha kötüdür.
Ardından Mailgun'da Verify DNS Settings seçeneğine tıklayın. Durumun yeşile dönmesi bir saati bulabilir.
⭐ Yalnızca gönderim yapıyor olsanız dahi MX kayıtlarını ekleyin. Mailgun teslim edilemeyen iletileri bu kayıtlar sayesinde toplar. Bunlar olmadan hatalı bir adres hiçbir yere iletilemez, Mailgun bu adresi engelleyemez ve siz de hiçbir zaman ileti alamayacak bir adrese gönderim yapmak için ödeme yapmaya devam edersiniz.
3. API anahtarınızı alın
Send → Sending → Domain settings → API keys yolunu veya hesabınızın API Keys sayfasını kullanın.
Planınız destekliyorsa, hesabınızın özel API anahtarı yerine doğrudan bu alan adına tanımlı bir gönderim anahtarı (sending key) kullanın. Gönderim anahtarı yalnızca e-posta gönderebilir; özel anahtar ise günlüklerinizi okuyabilir ve hesabınızda değişiklik yapabilir. İkinci anahtarı tarafımızda saklamamız için hiçbir neden yoktur.
4. Bunu Zinn® üzerinde bağlayın
Kontrol panelinizde Email sending bölümünü açın ve şu alanları doldurun:
- Sağlayıcı — Mailgun
- Bu alan adından gönder —
mail.yourdomain.com (bir e-posta adresi değil, bir alan adı)
- Mailgun gönderim alan adı — Mailgun'a eklediğiniz alan adının aynısı
- Bölge — 1. adımla eşleşecek şekilde
us veya eu
- Mailgun API anahtarı — 3. adımdaki anahtar
⛔⛔ Bölgeyi doğru seçin. EU konumlu Mailgun hesaplarına tamamen farklı bir API sunucusu üzerinden hizmet verilir. Bir EU hesabının anahtarını US sunucusuna göndermek "401 Unauthorized" hatası döndürür — bu da tıpkı anahtarın yanlış girilmesi gibi görünür. Anahtarınız kesinlikle doğruysa ve 401 hatası alıyorsanız, sebebi neredeyse her zaman budur.
5. Test iletisini gönderin ve kodu girin
Farklı bir alan adına ait bir gelen kutusu (Gmail adresi idealdir) kullanarak Send test message seçeneğine tıklayın. İlgili gelen kutusuna gelen kodu okuyun ve sisteme girin. E-posta sisteminiz anında geçiş yapacaktır.
İşe yaramadığında yapılması gerekenler
401 Unauthorized — Yanlış bölge seçilmiştir (yukarıya bakın) veya farklı bir Mailgun hesabına ait bir anahtar yapıştırmışsınızdır. Anahtarı elle yeniden yazmak yerine yeniden oluşturun; baştaki key- ifadesini gözden kaçırmak kolaydır.
Test iletisi hiç ulaşmıyor — Mailgun'ın Logs sayfasını kontrol edin. Mailgun'da buna dair hiçbir kayıt yoksa kimlik bilgisi veya alan adı yanlıştır. Mailgun iletiyi kabul ettiyse ve sonrasında başarısız olduysa, gerekçesi açıkça orada belirtilecektir ve bu durum neredeyse her zaman DNS kaynaklıdır.
"Domain not found" — Mailgun sending domain alanı, alt alan adı da dahil olmak üzere tam olarak Mailgun'da listelenen alan adı olmalıdır. Mailgun için yourdomain.com ile mail.yourdomain.com iki farklı alan adıdır.
Önce çalıştı, ardından durdu — Ücretsiz deneme sürenizin sona erip ermediğini kontrol edin. Mailgun deneme hesapları yalnızca yetkilendirilmiş alıcılara gönderim yapabilir; bu nedenle kendi adresinize gönderilen test iletisi çalışmaya devam ederken müşterilerinize giden her şey sessizce başarısız olur.