Meta Tech Provider

WhatsApp Cloud API -virhekoodit

Tässä ovat kaikki dokumentoimamme WhatsApp Cloud API -virhekoodit yhdessä taulukossa, merkityksineen ja uudelleenyrityksen vaikutuksineen. Useimmat eivät auta: ne ovat deterministisiä, joten sama pyyntö epäonnistuu aina samalla tavalla ja uudelleenyrityssilmukka muuttaa virheellisen pyynnön nopeusrajoitukseksi.

Emme tallenna viestejäBusiness-sovellus + Cloud APIMCP Claudelle ja ChatGPT:lleKäyttövalmis 2 minuutissa

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

Code	What it means	Retry
131047	The 24-hour service window is closed. Send a template.	No
131026	The recipient cannot receive the message at all.	No
131050	The person opted out. There is no workaround, by design.	No
130497	Messaging that country is restricted for your account.	No

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

Code	What it means	Retry
130429	The account's messaging throughput limit was reached.	Wait
131048	A spam rate limit was hit. Quality, not volume, is the cause.	No
131056	Too many messages between your number and one recipient.	No
80007	The account hit its management call limit. Usually polling.	Wait

Transient

Code	What it means	Retry
131016	A Meta service is temporarily unavailable.	Yes
131000	Unclassified failure. Retry once, then escalate with the trace id.	Yes

Coexistence sync

Code	What it means	Retry
2593107	The chat history synchronisation limit was exceeded.	No
2593108	A sync was attempted outside the 24-hour sync window.	No

Uudelleenyrityssarakkeen lukeminen

Sarakkeessa on kolme arvoa, ja väärän vaihtoehdon valitseminen on tämän koko viitteen kallein virhe.

Ei tarkoittaa, että epäonnistuminen on deterministinen. Pyyntö, viestipohja tai vastaanottajan tila aiheutti virheen, ja saman pyynnön lähettäminen uudelleen tuottaa saman virheen sekä kuluttaa myöhemmin tarvitsemaasi läpäisykykyä. Kyllä tarkoittaa, että virhe oli Metan puolella ja viive ratkaisee sen aidosti. Odota tarkoittaa, että tila on todellinen mutta väliaikainen: rajoitus tai lukitus poistuu itsestään, eikä ennen sitä tehty uudelleenyritys auta vaan voi pidentää tilaa.

Miksi useimpia näistä ei voi yrittää uudelleen

Koska alusta palauttaa tarkat koodit yleisten sijaan. Virheellinen parametri, puuttuva viestipohja, sulkeutunut viesti-ikkuna ja viesteistä kieltäytynyt vastaanottaja ovat tiedossa jo vastauksen hetkellä, joten Meta nimeää ongelman sen sijaan, että epäonnistuisi epämääräisesti.

Pyyntöongelma ei muutu oikeaksi toisella yrityksellä.
Viestipohjaongelma on viestipohjassa, eikä pyyntö voi muuttaa sitä.
Ikkuna- tai kieltäytymisongelma koskee vastaanottajan tilaa, ei sinun tilaasi.
Tilirajoitus on päätös, eikä uudelleenyritys ole valitus.

Mitä kirjataan, kun jokin näistä saapuu

Kirjaa tarpeeksi tietoja vian selvittämiseen ilman toistoa. Se erottaa viiden minuutin korjauksen päivän arvailusta.

Koko virhevastaus, mukaan lukien trace id, jota Metan tuki pyytää.
Lähetetty pyyntörunko, ei aiottu runko. Näiden välinen ero on yleensä virhe.
Puhelinnumeron tunnus, jotta yhden numeron ongelma erottuu koko tiliä koskevasta ongelmasta.
Aikaleima, jotta virhe voidaan tarkistaa yhteyden tilaa vasten juuri sillä hetkellä.

Vain Coexistencessa esiintyvät koodit

Niitä on kaksi, ja ne hämmentävät, koska näyttävät tavallisilta lähetysvirheiltä. 2593107 ja 2593108 koskevat keskusteluhistorian synkronointia. Se kopioi viimeisimmät keskustelut WhatsApp Business -sovelluksesta, kun numero yhdistetään ensimmäisen kerran.

Ne eivät ole viestintävirheitä eivätkä tarkoita, että yhteys epäonnistui. Jos synkronointi ylittää rajansa tai tapahtuu ikkunan ulkopuolella, numero pysyy yhdistettynä ja lähettää normaalisti, mutta historiaa kopioituu odotettua vähemmän. Jos koodi tulkitaan rikkoutuneeksi yhteydeksi, yhteys katkaistaan ja aloitetaan alusta, mikä menettää lisää historiaa sen palauttamisen sijaan.

Usein kysytyt kysymykset

Mitkä virheet kannattaa yrittää uudelleen?

131016 ja 131000 eksponentiaalisella viiveellä. 130429, 132015 ja 133008 poistuvat itsestään odottamalla. Kaikki muut ovat deterministisiä.

Tarkoittaako virhekoodi, että numeroni yhteys katkaistiin?

Yleensä ei. Useimmat koskevat pyyntöä, viestipohjaa tai vastaanottajaa. Yhteysongelmat näkyvät tili- ja laatua koskevina webhookeina, eivät lähetysvirheinä.

Mikä on trace id?

Virhevastauksessa oleva tunniste, jonka avulla Metan tuki löytää tietyn pyynnön. Kirjaa se jokaisesta virheestä, sillä ilman sitä tukipyyntöä ei voida käsitellä.

Ovatko nämä koodit samoja kaikilla palveluntarjoajilla?

Kyllä. Ne tulevat Metan Cloud API:sta, joten ne ovat samat riippumatta siitä, mikä palveluntarjoaja yhdisti numeron. Palveluntarjoaja voi muuttaa vain sitä, kuinka selkeästi koodit saavuttavat sinut.

Valmis aloittamaan?

Ota WhatsApp Coexistence käyttöön minuuteissa, ei kuukausissa. Sovellus toimii edelleen puhelimessa.

Aloita ilmainen kokeiluEi veloituksia 7 päivään. Peruuta milloin tahansa.

Lue lisää

ReferenceWhatsApp error 131047: re-engagement messageError 131047 means more than 24 hours have passed since that customer last messaged you, so the customer service window is closed and free text will not deliver.ReferenceWhatsApp error 100: invalid parameterError 100 means the request carried a parameter Meta does not accept: unsupported, misspelled, or the wrong shape for that endpoint.ReferenceWhatsApp error 131016: service unavailableError 131016 means a service on Meta's side is temporarily unavailable.ReferenceA number stopped working: how to find out whyWhen a connected number stops working, the cause is almost never the code.ReferenceWhatsApp webhook fields, and which ones go whereA WhatsApp Business Account delivers events as named fields.GuideWhatsApp Coexistence: the app and the API on one numberCoexistence is Meta's official mode for running the WhatsApp Business app and the Cloud API on one number at the same time.