İşlemsel e-posta sorunlarını giderme

Bu makale, Flexmail işlemsel e-postasıyla ilgili en yaygın sorunları (kimlik doğrulama hataları, teslim edilebilirlik sorunları ve API veya SMTP hataları) ve her biri için ne yapmanız gerektiğini ele almaktadır.


Kimlik doğrulama ve kurulum hataları

API 401 Unauthorized hatası döndürüyor

Hesap kimliğiniz veya kişisel erişim belirteciniz yanlış. Her ikisini de dikkatlice kontrol edin:

  • Kullanıcı adı, e-posta adresiniz değil, sayısal hesap kimliğinizdir.
  • Parola, Flexmail giriş parolanız değil, Ayarlar > API > Kişisel erişim belirteçleri bölümünde oluşturulan bir kişisel erişim belirtecidir.
  • Belirtecin sonunda boşluk veya satır sonu olmadan eksiksiz kopyalandığından emin olun.
  • Emin değilseniz yeni bir belirteç oluşturun ve tekrar deneyin.

SMTP bağlantısı başarısız oluyor veya zaman aşımına uğruyor

Şunları kontrol edin:

  • STARTTLS ile birlikte submission.flexmail.eu sunucusunu ve 587 numaralı bağlantı noktasını kullanıyorsunuz.
  • Sunucunuz veya barındırma ortamınız 587 numaralı bağlantı noktasında giden bağlantılara izin veriyor. Bazı paylaşımlı barındırma sağlayıcıları bu bağlantı noktasını engeller; doğrulamak için barındırma sağlayıcınızla iletişime geçin.
  • SMTP kimlik bilgileriniz, Flexmail'in SMTP erişiminizi etkinleştirirken sağladığı kullanıcı adı ve paroladır. Bunlar, yalnızca HTTP API için kullanılan hesap kimliğinizden ve kişisel erişim belirtecinizden ayrıdır.
  • Gönderen adresiniz Flexmail'de doğrulanmıştır.

Gönderen adresi doğrulanmamış

Flexmail'de doğrulanmamış bir adresten göndermeye çalışırsanız gönderim reddedilir. Ayarlar > Gönderen ekle veya kaldır bölümüne gidin, adresi ekleyin ve Flexmail'in gönderdiği e-postadaki doğrulama bağlantısına tıklayın.


Teslim edilebilirlik sorunları

E-postalar spam klasörüne düşüyor

İşlemsel e-postaların spam klasörüne düşmesinin nedeni neredeyse her zaman şu üç şeyden biridir:

  • E-posta kimlik doğrulaması yapılandırılmamış veya yanlış yapılandırılmış. Gönderim alan adınız için SPF, DKIM ve DMARC kayıtlarının mevcut olduğunu kontrol edin. Eksik veya yanlış yapılandırılmış tek bir kayıt bile e-postaların spam klasörüne düşmesine neden olabilir. Yapılandırma talimatları, email-api.flexmail.eu/documentation adresindeki API belgelerinde Email authentication başlığı altında yer alır.
  • Gönderen itibarı düşük. Alan adınızın veya IP adresinizin, yalnızca Flexmail değil herhangi bir gönderim platformundan kaynaklanan spam şikâyeti veya yüksek geri dönme oranı geçmişi varsa, gelen kutusu sağlayıcıları e-postanızı spam klasörüne yönlendirebilir. İtibarın nasıl değerlendirileceği ve iyileştirileceği için "Gönderen itibarını anlama" makalesine bakın.
  • İçerik spam filtrelerini tetikliyor. Belirli konu satırı kalıpları, aşırı sayıda bağlantı veya az metin içeren görsel ağırlıklı e-postalar spam filtrelerini tetikleyebilir. İçerik düzeyindeki sorunları belirlemek için işlemsel e-postalarınızı Mail-Tester (mail-tester.com) gibi bir araçla test edin.

E-postalar hiç ulaşmıyor

API başarılı bir yanıt döndürüyor ancak e-posta ulaşmıyorsa:

  • Webhook olaylarınızı kontrol edin (yapılandırıldıysa); gönderimden kısa süre sonra gelen bir bounce olayı, bir teslimat hatasına işaret eder.
  • Alıcı adresinin mevcut olduğunu ve doğru yazıldığını doğrulayın.
  • Alıcıdan spam klasörünü kontrol etmesini isteyin.
  • Alıcının alan adının katı bir DMARC politikası olup olmadığını kontrol edin; doğru yapılandırılmış DKIM olmadan e-postalarınız sessizce reddedilebilir.
  • Bazı kurumsal e-posta sistemleri, yeni veya itibarı düşük gönderenlerden gelen e-postaları reddeder. Alıcı tarafındaki filtrelemeyi ekarte etmek için kişisel bir Gmail veya Outlook adresine göndermeyi deneyin.

Yüksek geri dönme oranı

İşlemsel e-postalarda yüksek bir geri dönme oranı, genellikle var olmayan veya artık etkin olmayan adreslere gönderim yaptığınız anlamına gelir. Adres toplama sürecinizi kontrol edin:

  • E-posta adresi biçimini giriş noktasında doğruluyor musunuz?
  • Yeni bir adrese güvenmeden önce bir onay veya doğrulama e-postası gönderiyor musunuz?
  • Kalıcı olarak geri dönen (hard bounce) adresleri sisteminizden hemen kaldırıyor musunuz?

Önemli

Kalıcı olarak geri dönen (hard bounce) adreslere gönderim yapmaya devam etmek, her gönderimde gönderen itibarınıza zarar verir. Bounce olayları için webhook işlemeyi ayarlayın ve bu adresleri sisteminizde hemen engelleyin.


API ve entegrasyon hataları

API 422 veya 400 hatası döndürüyor

Bu hatalar, isteğinizle ilgili bir soruna işaret eder: eksik bir zorunlu alan, geçersiz bir parametre değeri veya hatalı biçimlendirilmiş bir istek gövdesi. Ayrıntılar için yanıt gövdesindeki hata mesajını kontrol edin. email-api.flexmail.eu/documentation adresindeki API belgeleri, her uç nokta için tüm zorunlu ve isteğe bağlı parametreleri listeler.

API 429 Too Many Requests hatası döndürüyor

Bir hız sınırına ulaştınız. API belgeleri, abonelik paketinizin kademesine ait hız sınırlarını belirtir. Bu durumu sorunsuz bir şekilde yönetmek için entegrasyonunuza üstel geri çekilme (exponential backoff) ile yeniden deneme mantığı ekleyin.

Şablon değişkenleri değiştirilmiyor

Yer tutucu metni teslim edilen e-postada olduğu gibi görünüyorsa:

  • Değişken değerlerini API isteğinde doğru şekilde ilettiğinizi kontrol edin. Tam parametre yapısı için API belgelerinin Templates bölümüne bakın.
  • Şablonunuzdaki yer tutucu söz diziminin, API'nin beklediğiyle tam olarak eşleştiğini kontrol edin.
  • API çağrınızda doğru şablon kimliğine başvurduğunuzdan emin olun.

Webhook'lar ulaşmıyor

Webhook uç noktanız olayları almıyorsa:

  • Uç noktanızın HTTPS üzerinden herkese açık olarak erişilebilir olduğunu doğrulayın.
  • Uç noktanızın hızlı bir şekilde 2xx yanıtı döndürdüğünü kontrol edin; yavaş veya yanıt vermeyen bir uç nokta, Flexmail'in teslimatı başarısız saymasına neden olur.
  • Bir yönlendirme veya güvenlik duvarı sorununu ekarte etmek için sunucu günlüklerinizde gelen POST isteklerini kontrol edin.
  • Webhook uç noktası URL'nizin API'de doğru şekilde kayıtlı olduğunu doğrulayın.

Yardım alma

Yukarıdakilerin tümünü uyguladıysanız ve sorun devam ediyorsa, support@flexmail.eu adresinden Flexmail destek ekibiyle iletişime geçin. Teşhisi hızlandırmak için mesajınıza şunları ekleyin:

  • Başarısız bir gönderimin mesaj kimliği (API yanıtından veya günlüklerinizden).
  • Test için kullandığınız alıcı e-posta adresi.
  • Varsa API'den gelen hata mesajı veya yanıt gövdesi.
  • MXToolbox veya Mail-Tester gibi bir e-posta kimlik doğrulama kontrol aracının sonucu.

Sonraki adımlar

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.