Meta Tech Provider

Misimbo ya hitilafu ya WhatsApp Cloud API

Hii ni orodha ya kila msimbo wa hitilafu ya WhatsApp Cloud API tunayohifadhi, kwenye jedwali moja, pamoja na maana yake na kama kujaribu tena kunasaidia. Mingi haisaidii: hitilafu hizi hutokana na hali maalum, hivyo ombi lilelile litashindikana kwa njia ileile na mfululizo wa majaribio utageuza ombi baya kuwa kikomo cha kiwango.

Hakuna uhifadhi wa jumbeBusiness App + Cloud APIMCP kwa Claude na ChatGPTAnza ndani ya dakika 2

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

Jinsi ya kusoma safu ya kujaribu tena

Ina thamani tatu, na kuchagua vibaya kati yake ni kosa linalogharimu zaidi katika rejeleo hili lote.

`No` inamaanisha hitilafu hiyo itatokea kwa njia ileile kila mara. Ombi, template au hali ya mpokeaji ndiyo iliyoshindikana, na kutuma ombi lilelile tena kutatoa hitilafu ileile huku kukitumia kikomo cha utumaji utakachohitaji baadaye. `Yes` inamaanisha hitilafu ilitokea upande wa Meta na kusubiri kwa muda unaoongezeka kunaweza kuisuluhisha. `Wait` inamaanisha hali hiyo ni halisi lakini ya muda: kikomo au kufungwa ambako huondoka chenyewe. Kujaribu tena kabla hakijaondoka hakufanyi chochote na kunaweza kuirefusha.

Kwa nini mingi haiwezi kurekebishwa kwa kujaribu tena

Kwa sababu mfumo hurudisha misimbo maalum badala ya misimbo ya jumla. Kigezo kisicho sahihi, template ambayo haipo, dirisha la ujumbe lililofungwa na mpokeaji aliyejiondoa vyote vinaweza kutambuliwa wakati wa jibu, hivyo Meta huvitaja wazi badala ya kutoa hitilafu isiyoeleweka.

Tatizo la ombi halibadiliki kuwa sahihi unapojaribu mara ya pili.
Tatizo la template liko kwenye template yenyewe, ambayo ombi haliwezi kubadilisha.
Tatizo la dirisha au kujiondoa linahusu hali ya mpokeaji, si yako.
Kizuizi cha akaunti ni uamuzi, na kujaribu tena si rufaa.

Uweke nini kwenye kumbukumbu hitilafu hizi zinapofika

Hifadhi taarifa za kutosha kuichunguza bila kuirudia, kwa sababu hapo ndipo panapotofautisha marekebisho ya dakika tano na siku nzima ya kubahatisha.

Jibu kamili la hitilafu, likiwemo `trace id`, ambacho ndicho msaada wa Meta huomba.
Mwili wa ombi ulivyotumwa, si ulivyokusudiwa. Tofauti kati ya hayo mawili kwa kawaida ndiyo hitilafu.
`phone number id`, ili tatizo la nambari moja litofautishwe na tatizo linalohusu akaunti nzima.
Muda wa tukio, ili hitilafu iweze kulinganishwa na hali ya muunganisho wakati huo.

Misimbo inayopatikana kwenye Coexistence pekee

Ni miwili, na huwachanganya watu kwa sababu inaonekana kama hitilafu za kawaida za kutuma. 2593107 na 2593108 zote zinahusu usawazishaji wa historia ya mazungumzo, hatua inayohamisha mazungumzo ya hivi karibuni kutoka programu ya WhatsApp Business nambari inapounganishwa kwa mara ya kwanza.

Si hitilafu za ujumbe na hazimaanishi muunganisho umeshindikana. Usawazishaji unaozidi kikomo chake au unaoendeshwa nje ya dirisha lake huacha nambari ikiwa imeunganishwa na ikituma kawaida, huku historia iliyonakiliwa ikiwa ndogo kuliko ilivyotarajiwa. Kuzisoma kama muunganisho uliovunjika huwafanya watu kukata muunganisho na kuanza tena, jambo linalopoteza historia zaidi badala ya kuirejesha.

Maswali yanayoulizwa mara kwa mara

Ni hitilafu zipi ninazopaswa kujaribu tena?

131016 na 131000, huku ukisubiri muda unaoongezeka kati ya majaribio. 130429, 132015 na 133008 hujiondoa ukisubiri. Nyingine zote hutokea kwa njia ileile kila mara.

Je, msimbo wa hitilafu unamaanisha nambari yangu imekatwa?

Kwa kawaida hapana. Mingi inahusu ombi, template au mpokeaji. Matatizo ya muunganisho huonekana kama webhook za akaunti na ubora, si hitilafu za kutuma.

`trace id` ni nini?

Ni kitambulisho kwenye jibu la hitilafu kinachosaidia msaada wa Meta kupata ombi husika. Hifadhi kwenye kumbukumbu kila hitilafu inapotokea; bila hicho, ombi haliwezi kuchukuliwa hatua.

Je, misimbo hii ni sawa kwa kila mtoa huduma?

Ndiyo. Inatoka kwenye Cloud API ya Meta, hivyo ni ileile bila kujali mtoa huduma aliyeunganisha nambari. Mtoa huduma anaweza kubadilisha tu jinsi inavyokufikia kwa uwazi.

Uko tayari kuanza?

Sanidi WhatsApp Coexistence kwa dakika chache, si miezi. Programu inaendelea kufanya kazi kwenye simu.

Anza kipindi cha majaribio bila malipoHakuna kinachotozwa kwa siku 7. Ghairi wakati wowote.

Endelea kusoma

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.