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.
Request
| Code | What it means | Retry |
|---|---|---|
| 100 | A parameter is unsupported, misspelled or malformed. | No |
| 131008 | A required parameter was not included at all. | No |
| 131009 | A parameter is present with a value the endpoint rejects. | No |
| 131021 | Sender and recipient are the same number. | No |
| 131051 | The message type is not supported, often a Coexistence limit. | No |
| 131052 | Meta could not download media a customer sent. | No |
| 131053 | Meta could not upload media you sent. Size, format or reach. | No |
Template
| Code | What it means | Retry |
|---|---|---|
| 132000 | The number of parameters does not match the template. | No |
| 132001 | No template exists with that name and language pair. | No |
| 132007 | The template breaks messaging policy. Rewrite and resubmit. | No |
| 132012 | Parameter format does not match what the template defines. | No |
| 132015 | The template is paused after a quality decline. Temporary. | Wait |
| 132016 | The template is permanently disabled. It will not come back. | No |
Window and recipient
Registration and PIN
| Code | What it means | Retry |
|---|---|---|
| 131045 | The number was never registered for Cloud API messaging. | No |
| 133010 | The number is not registered. Registration must be completed. | No |
| 133006 | The number must be verified before it can be registered. | No |
| 133005 | The two-step verification PIN was wrong. Stop guessing. | No |
| 133008 | Too many PIN attempts. Registration is locked for a period. | Wait |
Access and account
| Code | What it means | Retry |
|---|---|---|
| 190 | The access token expired or was invalidated. | No |
| 368 | The account is restricted after a policy violation. | No |
| 131031 | The account is restricted, or its data does not match Meta's. | No |
| 131042 | A payment problem on the business account blocks sending. | No |
| 131049 | Meta blocked the message to protect ecosystem health. | No |
Rate limits
Transient
Coexistence sync
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ın7 gün boyunca hiçbir ücret alınmaz. İstediğiniz zaman iptal edin.