Mga error code ng WhatsApp Cloud API
Narito ang lahat ng error code ng WhatsApp Cloud API na dokumentado namin, nasa isang table, kasama ang kahulugan ng bawat isa at kung makakatulong ang pag-retry. Karamihan ay hindi: deterministic ang mga ito, kaya pareho ang bagsak ng parehong request at maaaring gawing rate limit ng retry loop ang maling request.
Patuloy na mina-monitor ng EasyCoexistence ang koneksyon at itinatala sa connection timeline ang mga account at quality event ng Meta, kaya nakikita ang mga error mula sa state ng numero bago mag-fail ang send, hindi pagkatapos.
Request
| Code | Ano ang ibig sabihin | Ulitin |
|---|---|---|
| 100 | Hindi suportado, mali ang baybay o mali ang format ng isang parameter. | Hindi |
| 131008 | Hindi talaga naisama ang isang kinakailangang parameter. | Hindi |
| 131009 | May parameter, pero tinatanggihan ng endpoint ang value nito. | Hindi |
| 131021 | Iisang numero ang sender at ang recipient. | Hindi |
| 131051 | Hindi suportado ang uri ng mensahe, kadalasan dahil sa limitasyon ng Coexistence. | Hindi |
| 131052 | Hindi ma-download ng Meta ang media na ipinadala ng customer. | Hindi |
| 131053 | Hindi ma-upload ng Meta ang media na ipinadala ninyo. Dahil sa laki, format o hindi ito ma-access. | Hindi |
Template
| Code | Ano ang ibig sabihin | Ulitin |
|---|---|---|
| 132000 | Hindi tugma sa template ang bilang ng mga parameter. | Hindi |
| 132001 | Walang template na may ganoong pangalan at wika. | Hindi |
| 132007 | Lumalabag ang template sa messaging policy. Isulat itong muli at i-submit ulit. | Hindi |
| 132012 | Hindi tugma ang format ng parameter sa itinakda ng template. | Hindi |
| 132015 | Naka-pause ang template dahil bumaba ang kalidad nito. Pansamantala lamang. | Maghintay |
| 132016 | Permanenteng naka-disable ang template. Hindi na ito babalik. | Hindi |
Window at recipient
| Code | Ano ang ibig sabihin | Ulitin |
|---|---|---|
| 131047 | Sarado na ang 24-oras na service window. Magpadala ng template. | Hindi |
| 131026 | Hindi talaga matatanggap ng recipient ang mensahe. | Hindi |
| 131050 | Nag-opt out ang tao. Sadyang walang paraan para malampasan ito. | Hindi |
| 130497 | Restricted para sa inyong account ang pagpapadala ng mensahe sa bansang iyon. | Hindi |
Registration at PIN
| Code | Ano ang ibig sabihin | Ulitin |
|---|---|---|
| 131045 | Hindi kailanman na-register ang numero para sa messaging sa Cloud API. | Hindi |
| 133010 | Hindi naka-register ang numero. Kailangang tapusin ang registration. | Hindi |
| 133006 | Kailangang ma-verify ang numero bago ito ma-register. | Hindi |
| 133005 | Mali ang PIN ng two-step verification. Itigil na ang panghuhula. | Hindi |
| 133008 | Sobrang dami ng pagsubok sa PIN. Naka-lock ang registration nang ilang panahon. | Maghintay |
Access at account
| Code | Ano ang ibig sabihin | Ulitin |
|---|---|---|
| 190 | Nag-expire o na-invalidate ang access token. | Hindi |
| 368 | Restricted ang account dahil sa paglabag sa policy. | Hindi |
| 131031 | Restricted ang account, o hindi tugma ang data nito sa data ng Meta. | Hindi |
| 131042 | May problema sa bayad sa business account na humaharang sa pagpapadala. | Hindi |
| 131049 | Hinarang ng Meta ang mensahe para protektahan ang kalusugan ng ecosystem. | Hindi |
Mga rate limit
| Code | Ano ang ibig sabihin | Ulitin |
|---|---|---|
| 130429 | Naabot ang throughput limit ng account sa pagpapadala ng mensahe. | Maghintay |
| 131048 | Naabot ang spam rate limit. Kalidad, hindi dami, ang sanhi. | Hindi |
| 131056 | Sobrang daming mensahe sa pagitan ng inyong numero at ng iisang recipient. | Hindi |
| 80007 | Naabot ng account ang limit nito sa management call. Kadalasan dahil sa polling. | Maghintay |
Pansamantalang error
Sync ng Coexistence
Paano basahin ang retry column
Mayroon itong tatlong value, at ang maling pagpili sa mga ito ang pinakamagastos na pagkakamali sa buong reference na ito.
Ang Hindi ay nangangahulugang deterministic ang failure. Ang request, template o state ng recipient ang may problema, at ang muling pagpapadala ng parehong request ay magbubunga ng parehong error habang kumokonsumo ng throughput na kakailanganin ninyo sa susunod. Ang Oo ay nangangahulugang sa panig ng Meta nangyari ang failure at tunay na malulutas ito ng backoff. Ang Maghintay ay nangangahulugang totoo pero pansamantala ang kondisyon: limit o lock na kusang nawawala, kaya walang nagagawa ang pag-retry bago ito mawala at maaari pa itong mapahaba.
Bakit hindi maaaring i-retry ang karamihan sa mga ito
Dahil partikular na code, hindi generic, ang ibinabalik ng platform. Ang maling parameter, template na wala, saradong messaging window at recipient na nag-opt out ay malalaman na sa oras ng response, kaya pinapangalanan ito ng Meta sa halip na mag-fail nang malabo.
- Hindi nagiging tama ang problemang nasa request sa ikalawang attempt.
- Nasa template ang problema sa template, at hindi ito kayang baguhin ng request.
- Tungkol sa state ng recipient, hindi sa inyong state, ang problema sa window o opt-out.
- Desisyon ang restriction sa account, at hindi apela ang pag-retry.
Ano ang dapat i-log kapag dumating ang isa sa mga ito
Sapat na impormasyon para ma-diagnose ito nang hindi na kailangang i-reproduce, na siyang pagkakaiba ng limang minutong pag-aayos at isang araw ng paghuhula.
- Ang buong error response, kasama ang trace id na hinihingi ng Meta support.
- Ang request body na naipadala, hindi ang nilayon ninyong ipadala. Karaniwang nasa pagitan ng dalawang ito ang bug.
- Ang phone number id, para matukoy kung sa isang numero lang ang problema o sa buong account.
- Ang timestamp, para maikumpara ang failure sa state ng koneksyon sa sandaling iyon.
Mga code na umiiral lamang sa Coexistence
Dalawa ang mga ito, at nakalilito dahil mukha silang ordinaryong send failure. Parehong tungkol sa chat history synchronisation ang 2593107 at 2593108. Ito ang hakbang na kumokopya ng mga kamakailang conversation mula sa WhatsApp Business app kapag unang na-connect ang isang numero.
Hindi mga messaging error ang mga ito at hindi ibig sabihin na nag-fail ang koneksyon. Kapag lumampas sa limit nito ang sync o tumakbo sa labas ng window, mananatiling connected at normal na magse-send ang numero, pero mas kaunti ang makokopyang history kaysa inaasahan. Kapag binasa ito bilang sirang koneksyon, maaaring i-disconnect at magsimula ulit ang mga user, na mas maraming history ang nawawala sa halip na nababawi.
Mga madalas itanong
Aling mga error ang dapat i-retry?
131016 at 131000, na may exponential backoff. Kusang nawawala ang 130429, 132015 at 133008 kapag naghintay kayo. Deterministic ang lahat ng iba pa.
Ibig bang sabihin ng error code ay disconnected ang numero?
Karaniwan, hindi. Karamihan ay tungkol sa request, template o recipient. Lumalabas ang mga problema sa koneksyon bilang account at quality webhook, hindi bilang send error.
Ano ang trace id?
Isang identifier sa error response na tumutulong sa Meta support na hanapin ang partikular na request. I-log ito sa bawat failure; kung wala ito, hindi maaaksyunan ang ticket.
Pareho ba ang mga code na ito sa bawat provider?
Oo. Mula ang mga ito sa Cloud API ng Meta, kaya pareho ang mga ito kahit sinong provider ang nag-connect ng numero. Ang mababago lang ng provider ay kung gaano kalinaw na nakararating sa inyo ang mga ito.
Handa na po ba kayong magsimula?
I-set up ang WhatsApp Coexistence sa loob ng ilang minuto, hindi buwan. Patuloy na gumagana ang app sa telepono.
Magsimula ng Libreng TrialWalang sisingilin sa loob ng 3 araw. Mag-cancel anumang oras.