WhatsApp Cloud API hata kodları
Belgelediğimiz tüm WhatsApp Cloud API hata kodları, her birinin anlamı ve yeniden denemenin işe yarayıp yaramadığıyla birlikte tek tabloda. Çoğu işe yaramaz: Kodlar belirleyicidir, aynı istek aynı şekilde başarısız olur ve yeniden deneme döngüsü hatalı isteği hız sınırına dönüştürür.
EasyCoexistence bağlantıyı sürekli izler ve Meta'nın hesap ve kalite olaylarını bağlantı zaman çizelgesine kaydeder.
İstek
| Kod | Anlamı | Yeniden deneme |
|---|---|---|
| 100 | Bir parametre desteklenmiyor, yanlış yazılmış veya hatalı biçimlendirilmiş. | Hayır |
| 131008 | Zorunlu bir parametre hiç gönderilmemiş. | Hayır |
| 131009 | Parametre var, ancak uç noktanın reddettiği bir değere sahip. | Hayır |
| 131021 | Gönderen ve alıcı aynı numara. | Hayır |
| 131051 | Mesaj türü desteklenmiyor, çoğu zaman bir Coexistence sınırı. | Hayır |
| 131052 | Meta, müşterinin gönderdiği medyayı indiremedi. | Hayır |
| 131053 | Meta, gönderdiğiniz medyayı yükleyemedi. Boyut, biçim veya erişilebilirlik. | Hayır |
Şablon
| Kod | Anlamı | Yeniden deneme |
|---|---|---|
| 132000 | Parametre sayısı şablonla eşleşmiyor. | Hayır |
| 132001 | Bu ad ve dil çiftine sahip bir şablon yok. | Hayır |
| 132007 | Şablon mesajlaşma politikasını ihlal ediyor. Yeniden yazıp tekrar gönderin. | Hayır |
| 132012 | Parametre biçimi şablonda tanımlananla eşleşmiyor. | Hayır |
| 132015 | Şablon, kalite düşüşünün ardından duraklatıldı. Geçici. | Bekleyin |
| 132016 | Şablon kalıcı olarak devre dışı bırakıldı. Geri gelmeyecek. | Hayır |
Pencere ve alıcı
| Kod | Anlamı | Yeniden deneme |
|---|---|---|
| 131047 | 24 saatlik müşteri hizmetleri penceresi kapandı. Bir şablon gönderin. | Hayır |
| 131026 | Alıcı mesajı hiçbir şekilde alamıyor. | Hayır |
| 131050 | Kişi mesaj almayı reddetti. Bunun bir çözümü yok ve bu bilinçli bir tasarım. | Hayır |
| 130497 | O ülkeye mesaj gönderimi hesabınız için kısıtlanmış. | Hayır |
Kayıt ve PIN
| Kod | Anlamı | Yeniden deneme |
|---|---|---|
| 131045 | Numara, Cloud API mesajlaşması için hiç kaydedilmemiş. | Hayır |
| 133010 | Numara kayıtlı değil. Kaydın tamamlanması gerekiyor. | Hayır |
| 133006 | Numaranın kaydedilebilmesi için önce doğrulanması gerekiyor. | Hayır |
| 133005 | İki adımlı doğrulama PIN'i yanlıştı. Tahmin etmeyi bırakın. | Hayır |
| 133008 | Çok fazla PIN denemesi. Kayıt bir süreliğine kilitlendi. | Bekleyin |
Erişim ve hesap
| Kod | Anlamı | Yeniden deneme |
|---|---|---|
| 190 | Erişim token'ının süresi doldu veya geçersiz kılındı. | Hayır |
| 368 | Hesap, bir politika ihlalinin ardından kısıtlandı. | Hayır |
| 131031 | Hesap kısıtlandı veya verileri Meta'nın verileriyle eşleşmiyor. | Hayır |
| 131042 | İşletme hesabındaki bir ödeme sorunu gönderimi engelliyor. | Hayır |
| 131049 | Meta, ekosistemin sağlığını korumak için mesajı engelledi. | Hayır |
Hız sınırları
| Kod | Anlamı | Yeniden deneme |
|---|---|---|
| 130429 | Hesabın mesaj gönderim kapasitesi sınırına ulaşıldı. | Bekleyin |
| 131048 | Bir spam hız sınırına takıldı. Sebep hacim değil, kalite. | Hayır |
| 131056 | Numaranız ile tek bir alıcı arasında çok fazla mesaj var. | Hayır |
| 80007 | Hesap, yönetim çağrısı sınırına ulaştı. Genellikle sık sorgulamadan (polling). | Bekleyin |
Geçici hatalar
Coexistence senkronizasyonu
Yeniden deneme sütunu nasıl okunur
Bu sütunda üç değer vardır ve aralarında yanlış seçim yapmak, bu başvurudaki en maliyetli hatadır.
Hayır, başarısızlığın belirleyici olduğu anlamına gelir. Başarısız olan şey istek, şablon veya alıcının durumudur. Aynı isteği yeniden göndermek aynı hatayı üretir ve daha sonra ihtiyaç duyacağınız kapasiteyi tüketir. Evet, başarısızlığın Meta tarafında olduğu ve beklemenin sorunu gerçekten çözdüğü anlamına gelir. Bekleyin, durumun gerçek ama geçici olduğunu gösterir: kendiliğinden kalkacak bir sınır veya kilit söz konusudur. Kalkmadan önce yeniden denemek hiçbir şeyi çözmez ve süreci uzatabilir.
Bunların çoğu neden yeniden denenemez
Çünkü platform genel kodlar yerine özel kodlar döndürür. Hatalı biçimlendirilmiş bir parametre, var olmayan bir şablon, kapanmış bir mesajlaşma penceresi ve ileti almayı reddetmiş bir alıcı, yanıt geldiği anda bilinebilir. Bu nedenle Meta belirsiz bir hata vermek yerine durumu adlandırır.
- İstekle ilgili bir sorun ikinci denemede doğru hale gelmez.
- Şablonla ilgili sorun şablonun kendisindedir; istek bunu değiştiremez.
- Pencere veya ileti almayı reddetme sorunu sizin değil, alıcının durumuyla ilgilidir.
- Hesap kısıtlaması bir karardır; yeniden denemek itiraz değildir.
Bunlardan biri geldiğinde neyi loglamalıyım
Sorunu yeniden oluşturmadan teşhis etmeye yetecek bilgiler. Beş dakikalık düzeltmeyle bir gün süren tahmin arasındaki fark budur.
- Meta desteğinin istediği trace id dahil, tam hata yanıtı.
- İstek gövdesini amaçladığınız haliyle değil, gönderildiği haliyle kaydedin. Bu ikisi arasındaki fark genellikle hatadır.
- Sorunun tek bir numarada mı yoksa hesap genelinde mi olduğunu ayırt etmek için phone number id.
- Başarısızlığı o andaki bağlantı durumuyla karşılaştırabilmek için zaman damgası.
Yalnızca Coexistence'ta bulunan kodlar
Bunlardan iki tane vardır ve sıradan gönderme hatalarına benzedikleri için kafa karıştırırlar. 2593107 ve 2593108, bir numara ilk kez bağlandığında WhatsApp Business uygulamasındaki son görüşmeleri kopyalayan adım olan sohbet geçmişi senkronizasyonuyla ilgilidir.
Bunlar mesajlaşma hataları değildir ve bağlantının başarısız olduğu anlamına gelmez. Sınırı aşan veya penceresi dışında çalışan bir senkronizasyon, numarayı bağlı ve normal şekilde mesaj gönderir halde bırakır; yalnızca beklenenden daha az geçmiş kopyalanır. Bunları bozuk bağlantı olarak okumak, numaranın bağlantısını kesip baştan başlamaya yol açar. Bu da geçmişi kurtarmak yerine daha fazlasını kaybettirir.
Sık sorulan sorular
Hangi hataları yeniden denemeliyim?
131016 ve 131000 kodlarını üstel beklemeyle yeniden deneyin. 130429, 132015 ve 133008 beklediğinizde kendiliğinden düzelir. Diğer her şey belirleyicidir.
Bir hata kodu numaramın bağlantısının kesildiği anlamına mı gelir?
Genellikle hayır. Bunların çoğu istek, şablon veya alıcıyla ilgilidir. Bağlantı sorunları, gönderme hataları yerine hesap ve kalite webhook'ları olarak görünür.
Trace id nedir?
Meta desteğinin belirli isteği bulmasını sağlayan, hata yanıtındaki tanımlayıcıdır. Her başarısızlıkta loglayın; bu olmadan destek kaydı işleme alınamaz.
Bu kodlar her sağlayıcıda aynı mı?
Evet. Kodlar Meta'nın Cloud API'sinden gelir, bu nedenle numarayı hangi sağlayıcı bağlarsa bağlasın aynıdır. Sağlayıcı yalnızca bunların size ne kadar açık ulaştığını değiştirebilir.
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ın3 gün boyunca hiçbir ücret alınmaz. İstediğiniz zaman iptal edin.