Giriş yapınÜcretsiz denemeyi başlatın
Meta Tech Provider

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.

Varsayılan olarak mesaj saklama yokBusiness App + Cloud APIClaude ve ChatGPT için MCP2 dakikada hazır

İstek

KodAnlamıYeniden deneme
100Bir parametre desteklenmiyor, yanlış yazılmış veya hatalı biçimlendirilmiş.Hayır
131008Zorunlu bir parametre hiç gönderilmemiş.Hayır
131009Parametre var, ancak uç noktanın reddettiği bir değere sahip.Hayır
131021Gönderen ve alıcı aynı numara.Hayır
131051Mesaj türü desteklenmiyor, çoğu zaman bir Coexistence sınırı.Hayır
131052Meta, müşterinin gönderdiği medyayı indiremedi.Hayır
131053Meta, gönderdiğiniz medyayı yükleyemedi. Boyut, biçim veya erişilebilirlik.Hayır

Şablon

KodAnlamıYeniden deneme
132000Parametre sayısı şablonla eşleşmiyor.Hayır
132001Bu 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
132012Parametre 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ı

KodAnlamıYeniden deneme
13104724 saatlik müşteri hizmetleri penceresi kapandı. Bir şablon gönderin.Hayır
131026Alıcı mesajı hiçbir şekilde alamıyor.Hayır
131050Kişi mesaj almayı reddetti. Bunun bir çözümü yok ve bu bilinçli bir tasarım.Hayır
130497O ülkeye mesaj gönderimi hesabınız için kısıtlanmış.Hayır

Kayıt ve PIN

KodAnlamıYeniden deneme
131045Numara, Cloud API mesajlaşması için hiç kaydedilmemiş.Hayır
133010Numara kayıtlı değil. Kaydın tamamlanması gerekiyor.Hayır
133006Numaranı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

KodAnlamıYeniden deneme
190Erişim token'ının süresi doldu veya geçersiz kılındı.Hayır
368Hesap, bir politika ihlalinin ardından kısıtlandı.Hayır
131031Hesap 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
131049Meta, ekosistemin sağlığını korumak için mesajı engelledi.Hayır

Hız sınırları

KodAnlamıYeniden deneme
130429Hesabın mesaj gönderim kapasitesi sınırına ulaşıldı.Bekleyin
131048Bir spam hız sınırına takıldı. Sebep hacim değil, kalite.Hayır
131056Numaranız ile tek bir alıcı arasında çok fazla mesaj var.Hayır
80007Hesap, yönetim çağrısı sınırına ulaştı. Genellikle sık sorgulamadan (polling).Bekleyin

Geçici hatalar

KodAnlamıYeniden deneme
131016Bir Meta hizmeti geçici olarak kullanılamıyor.Evet
131000Sınıflandırılmamış hata. Bir kez yeniden deneyin, ardından trace id ile iletin.Evet

Coexistence senkronizasyonu

KodAnlamıYeniden deneme
2593107Sohbet geçmişi senkronizasyon sınırı aşıldı.Hayır
2593108Senkronizasyon, 24 saatlik senkronizasyon penceresinin dışında denendi.Hayır

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.

Okumaya devam edin