WhatsApp API mesajı teslim edilmedi: nedenler, sırasıyla
Kabul edilen bir WhatsApp API mesajı, teslim edilmiş bir mesaj değildir: Meta sonucu daha sonra durum webhook'unda bildirir; gönderildi, iletildi, okundu veya başarısız, hata koduyla birlikte. Sırayla kontrol edin: başarısız durum ve kodu, 24 saatlik pencere (131047), ödeme yöntemi (131042), şablon (132001, 132015), alıcı (131026, 131049, 131050), ardından numaranın limitleri ve bağlantısı.
easyCoexistence bağlı her numarayı gece gündüz izler; Meta teslimatı durdurduğunda, bağlantıyı düşürdüğünde ya da kaliteyi düşürdüğünde size e-posta gönderir ve Meta'nın durum webhook'larını değiştirmeden sisteminize iletir.
sent (tek onay işareti), delivered (çift), read (çift mavi) ve failed (kırmızı hata üçgeni), durum webhook'larının bildirdiği şekliyle.
Alıcının son yanıtından bu yana 24 saatten fazla geçti; Meta bunun yerine bir şablon göndermeyi öneriyor.
Teslim edilemiyor: numara WhatsApp'ta değil, alıcı yeni koşulları kabul etmemiş ya da eski bir WhatsApp sürümü kullanıyor.
WhatsApp, teslim edilemeyen yardımcı ve pazarlama şablonlarını bırakmadan önce yeniden denediği varsayılan süre; kimlik doğrulama şablonlarında bu süre 10 dakikadır.
WhatsApp Business uygulamasında ve Cloud API'de birlikte kullanılan bir numaranın sabit işlem hacmi.
Kabul edilen bir mesaj neden yine de ulaşmıyor?
Çünkü API yanıtı ile teslim, iki ayrı olaydır. Gönderdiğinizde Meta isteği kabul eder etmez bir mesaj kimliği döndürür; mesajın müşterinin telefonuna ulaşıp ulaşmadığı ise daha sonra, messages alanı üzerinden gelen bir durum webhook'unda bildirilir. sent, mesajın Meta'nın sunucularından çıktığı (tek onay işareti), delivered cihaza ulaştığı (çift), read açıldığı (çift mavi) ve failed gönderilemediği ya da iletilemediği anlamına gelir; bu durum, errors dizisiyle birlikte size gösterilir: code, title ve error_data.details. Bu yüzden ilk adım asla tahmin yürütmek değildir: o mesaj kimliği için başarısız durumu bulun ve kodunu okuyun. Bir webhook hedefiniz yoksa hiçbir şey kaydedilmez.
Kontrol edilecek nedenler, sırasıyla nedir?
Yeni bağlanmış bir numarada en sık görülenden en nadire doğru. Her satır Meta'nın kodunu adıyla belirtir; başarısız durum hangisine denk geldiğinizi söyler:
- Pencere kapalı: 131047, müşteri son yazdığından bu yana 24 saatten fazla geçti. Serbest metin mesajlar açık bir pencere gerektirir; bir şablon gönderin.
- Ödeme: 131042, ya da şablonların sessizce düşürülmesi. 1 Ekim 2026'dan itibaren, ödeme yöntemi olmadan ayda 1.000 kullanıldığında hizmet mesajları da durur.
- Şablon: 132001 onaylanmamış veya yanlış dil, 132000 yanlış değişken sayısı, 132012 yanlış biçim, 132015 duraklatılmış, 132016 devre dışı.
- Alıcı: 131026 WhatsApp'ta değil, eski sürüm veya koşullar kabul edilmemiş; 131050 pazarlama mesajlarını durdurmuş; 131049 sağlıklı etkileşim için geri tutulmuş; ABD numaralarına gönderilen pazarlama şablonları iletilmez.
- Limitler: 131048 spam sinyallerinden sonra kısıtlanmış, 131056 tek bir kişiye çok fazla mesaj, 130429 işlem hacmi, Coexistence numarasında saniyede 20 mesaj.
- Hesap: 131031 ya da 368, WhatsApp Business Account bir politika ihlali nedeniyle kısıtlanmış veya devre dışı bırakılmış.
- Bağlantı: numara artık bağlı değil, örneğin WhatsApp Business uygulaması 14 gün açılmadıktan sonra.
Alıcı tarafı kodlarıyla nasıl başa çıkılır?
Farklı biçimde, çünkü bazıları yeniden denemeyi hak eder, bazıları asla. 131050, kişinin sizden pazarlama mesajı almayı durdurmayı seçtiği anlamına gelir: Meta yeniden denenmemesini söylüyor ve user_preferences webhook'u, durdurduklarında ya da yeniden başlattıklarında size haber verir. 131049, Meta'nın sağlıklı etkileşimi korumak için bir pazarlama mesajını geri tuttuğu anlamına gelir; genellikle pazarlama şablonları için kullanıcı başına bir limittir: Meta, yeniden göndermeden önce en az 24 saat beklemenizi öneriyor, çünkü daha erken göndermek aynı hatayı yeniden döndürür. 131026, WhatsApp'ta olmayan numaraları, WhatsApp'ın güncel koşullarını kabul etmeyen kullanıcıları ve çok eski uygulama sürümlerini kapsar; önce numaranın biçimini ve ülke kodunu kontrol edin, sonra müşteriye başka bir kanaldan ulaşın.
WhatsApp teslim etmeye ne kadar süre çalışır?
Mesajın yaşam süresi (time to live) boyunca. Telefon kapalıysa ya da kapsama alanı dışındaysa WhatsApp, hemen başarısız saymak yerine yeniden dener: varsayılan olarak yardımcı ve pazarlama şablonlarında 30 gün, kimlik doğrulama şablonlarında 10 dakika. İşletme, şablon başına message_send_ttl_seconds ile süreyi kısaltabilir: yardımcı şablonlarda 30 saniye ile 12 saat, kimlik doğrulamada 30 saniye ile 15 dakika arası. Yaşam süresi içinde iletilemeyen bir mesaj düşürülür. Bu nedenle saatlerce sent durumunda kalıp delivered almayan bir mesaj genellikle kayıp değil, müşterinin telefonunu bekliyordur; kodlar ve zamana duyarlı uyarılar için kısa bir yaşam süresi ayarlayın ki geç gelen bir teslimat kimseyi şaşırtmasın.
Bu, AI yanıtları ve otomasyonlar için ne anlama gelir?
Önce çalıştırmaya, sonra duruma bakın. Runs sekmesinde Skipped (atlanmış) bir çalıştırma hiçbir şey göndermemiştir ve nedenini söyler: "Müşterinin son mesajından bu yana 24 saatten fazla geçti", "Bu sohbete kısa süre önce telefonunuzdan yanıt verdiniz" ya da "Bu sohbet için bu saatteki AI yanıt limitine ulaşıldı". Done bir çalıştırma, Meta'nın her yanıtı kabul ettiği anlamına gelir; bu teslimat kanıtı değildir. easyCoexistence mesaj durumlarını saklamaz: otomasyonlar açıksa ve bir yönlendirme URL'si belirlediyseniz durumlar oraya ulaşır, doğrudan modda ise doğrudan kendi uç noktanıza gider. ChatGPT veya Claude'dan, AI'nızdan get_number_health aracını çalıştırmasını isteyin: canlı durumu, kalite derecelendirmesini ve son 15 izleme olayını döndürür; bu olaylar Meta'nın kodunu içeren bir sending bloğunu da kapsar.
Nasıl kurulur
- Find the statusLook up the message id in your webhook log and read the latest status: delivered, read, sent only, or failed with an error code.
- Match the codeLook up the failed status's code in the list of causes above and in Meta's error codes reference.
- Check the accountConfirm the WhatsApp Business Account has a default payment method, a currency and a time zone in Billing & payments.
- Check the templateIf it was a template, confirm it is APPROVED in that language and the variables match its definition.
- Check the numberAsk your AI to run get_number_health, or open the number in the dashboard, to see the connection and any sending block.
Yaygın hatalar
- 131050 kodunda yeniden denemek. Kişi sizden pazarlama mesajlarını durdurmuş; daha fazla deneme asla iletilmez ve yalnızca olumsuz sinyaller ekler.
- Mesaj kimliğini teslim edilmiş saymak. Meta önce kabul eder, hataları sonra bildirir; bu yüzden mesaj kimliğinde duran bir iş akışı, reddedilen her mesajı gözden kaçırır.
- Bir gün sonra serbest metin yanıt göndermek. Müşteri mesajı olmadan 24 saat geçtikten sonra yalnızca bir şablon kabul edilir.
- Webhook hedefi olmadan çalıştırmak. Başarısız durumlar yalnızca webhook olarak gelir; hedef yoksa bir mesajın neden ulaşmadığı bilgisi kaybolur.
AI'nız ChatGPT veya Claude'dan get_number_health ile bir numarayı kontrol edebilir. Numara başına aylık US$ 9'dan US$ 0.75'e kadar, numara ekledikçe düşer; ilk 3 gün ücretsiz.
Sık sorulan sorular
Mesaj neden saatlerce tek onay işaretiyle kaldı?
Tek onay işareti sent durumudur: Meta mesajı gönderdi, ama telefon almadı, genellikle kapalı ya da çevrimdışı olduğu için. WhatsApp, şablonun yaşam süresi dolana kadar yeniden dener; yardımcı ve pazarlama şablonlarında varsayılan 30 gün.
Yanıtlar ulaşıyor ama şablonlar neden ulaşmıyor?
Genellikle WhatsApp Business Account üzerindeki bir ödeme yöntemi sorunudur. Meta, hizmet mesajlarını numaranın aylık ücretsiz kotası içinde ödeme yöntemi olmadan iletir, ama şablonları iletmez. "Billing & payments" bölümünden bir kart ekleyin.
Başarısız mesajları WhatsApp Business uygulamasında görebilir miyim?
Güvenilir biçimde hayır. Coexistence numarasında API ile gönderilen mesajlar uygulamadaki sohbet akışında görünür, ancak mesajın neden başarısız olduğu yalnızca durum webhook'unun hata kodunda gelir.
Teslim edilmeyen mesajlar için Meta ücret alır mı?
Hayır. Meta yalnızca teslim edilen mesajlar için ücret alır; duraklatılmış bir şablonla yapılan denemeler de ücretlendirilmez.
Okumaya devam edin
Başlamaya hazır mısınız?
WhatsApp Coexistence'ı aylar değil, dakikalar içinde kurun. Uygulama telefonda çalışmaya devam eder.
Ücretsiz denemeyi başlatınDoğrulama tarihi