Mag-log inMagsimula ng Libreng Trial
Meta Tech Provider

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.

Default: walang message storageBusiness App + Cloud APIMCP para sa Claude at ChatGPTLive sa loob ng 2 minuto

Request

CodeAno ang ibig sabihinUlitin
100Hindi suportado, mali ang baybay o mali ang format ng isang parameter.Hindi
131008Hindi talaga naisama ang isang kinakailangang parameter.Hindi
131009May parameter, pero tinatanggihan ng endpoint ang value nito.Hindi
131021Iisang numero ang sender at ang recipient.Hindi
131051Hindi suportado ang uri ng mensahe, kadalasan dahil sa limitasyon ng Coexistence.Hindi
131052Hindi ma-download ng Meta ang media na ipinadala ng customer.Hindi
131053Hindi ma-upload ng Meta ang media na ipinadala ninyo. Dahil sa laki, format o hindi ito ma-access.Hindi

Template

CodeAno ang ibig sabihinUlitin
132000Hindi tugma sa template ang bilang ng mga parameter.Hindi
132001Walang template na may ganoong pangalan at wika.Hindi
132007Lumalabag ang template sa messaging policy. Isulat itong muli at i-submit ulit.Hindi
132012Hindi tugma ang format ng parameter sa itinakda ng template.Hindi
132015Naka-pause ang template dahil bumaba ang kalidad nito. Pansamantala lamang.Maghintay
132016Permanenteng naka-disable ang template. Hindi na ito babalik.Hindi

Window at recipient

CodeAno ang ibig sabihinUlitin
131047Sarado na ang 24-oras na service window. Magpadala ng template.Hindi
131026Hindi talaga matatanggap ng recipient ang mensahe.Hindi
131050Nag-opt out ang tao. Sadyang walang paraan para malampasan ito.Hindi
130497Restricted para sa inyong account ang pagpapadala ng mensahe sa bansang iyon.Hindi

Registration at PIN

CodeAno ang ibig sabihinUlitin
131045Hindi kailanman na-register ang numero para sa messaging sa Cloud API.Hindi
133010Hindi naka-register ang numero. Kailangang tapusin ang registration.Hindi
133006Kailangang ma-verify ang numero bago ito ma-register.Hindi
133005Mali ang PIN ng two-step verification. Itigil na ang panghuhula.Hindi
133008Sobrang dami ng pagsubok sa PIN. Naka-lock ang registration nang ilang panahon.Maghintay

Access at account

CodeAno ang ibig sabihinUlitin
190Nag-expire o na-invalidate ang access token.Hindi
368Restricted ang account dahil sa paglabag sa policy.Hindi
131031Restricted ang account, o hindi tugma ang data nito sa data ng Meta.Hindi
131042May problema sa bayad sa business account na humaharang sa pagpapadala.Hindi
131049Hinarang ng Meta ang mensahe para protektahan ang kalusugan ng ecosystem.Hindi

Mga rate limit

CodeAno ang ibig sabihinUlitin
130429Naabot ang throughput limit ng account sa pagpapadala ng mensahe.Maghintay
131048Naabot ang spam rate limit. Kalidad, hindi dami, ang sanhi.Hindi
131056Sobrang daming mensahe sa pagitan ng inyong numero at ng iisang recipient.Hindi
80007Naabot ng account ang limit nito sa management call. Kadalasan dahil sa polling.Maghintay

Pansamantalang error

CodeAno ang ibig sabihinUlitin
131016Pansamantalang hindi available ang isang serbisyo ng Meta.Oo
131000Hindi naka-classify na failure. Mag-retry nang isang beses, saka i-escalate kasama ang trace id.Oo

Sync ng Coexistence

CodeAno ang ibig sabihinUlitin
2593107Nalampasan ang limit ng sync ng chat history.Hindi
2593108Sinubukan ang sync sa labas ng 24-oras na sync window.Hindi

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.

Magpatuloy sa pagbabasa