IngiaAnza kipindi cha majaribio bila malipo
Meta Tech Provider

Ujumbe wa WhatsApp API haujafika: sababu zake, kwa mpangilio

Ujumbe wa WhatsApp API uliokubaliwa si ujumbe uliofika: Meta huripoti matokeo baadaye kupitia webhook ya hali, sent, delivered, read au failed, pamoja na msimbo wa hitilafu. Kagua kwa mpangilio huu: hali ya failed na msimbo wake, dirisha la saa 24 (131047), njia ya malipo (131042), template (132001, 132015), mpokeaji (131026, 131049, 131050), kisha vikomo na muunganisho wa nambari.

easyCoexistence hufuatilia kila nambari iliyounganishwa saa 24 kwa siku, hukutumia barua pepe Meta inapoacha kufikisha ujumbe, muunganisho ukikatika au ubora ukishuka, na husambaza webhook za hali za Meta bila kubadilishwa kwenye mfumo wako.

4 statuses

sent (alama moja ya kukagua), delivered (alama mbili), read (alama mbili za bluu) na failed (pembetatu nyekundu ya hitilafu), kama webhook za hali zinavyoyaripoti.

131047

Zaidi ya saa 24 zimepita tangu mpokeaji alipojibu mara ya mwisho; Meta inasema utume template badala yake.

131026

Haiwezi kufikishwa: nambari haipo kwenye WhatsApp, mpokeaji hajakubali masharti mapya, au anatumia toleo la zamani la WhatsApp.

30 days

WhatsApp hujaribu tena template ya huduma au ya uuzaji isiyofika kwa muda chaguomsingi kabla ya kuitupa; template za uthibitishaji ni dakika 10.

20 mps

Kasi isiyobadilika ya kutuma kwa nambari inayotumika kwenye programu ya WhatsApp Business na Cloud API.

Kwa nini ujumbe uliokubaliwa bado haufiki?

Kwa sababu jibu la API na ufikishaji ni matukio mawili tofauti. Unapotuma, Meta hurudisha message id mara tu inapokubali ombi. Kama ujumbe utamfikia mteja kwenye simu yake, hilo hutokea baadaye, kupitia webhook ya hali kwenye messages field. sent maana yake imetoka kwenye seva za Meta (alama moja ya kukagua), delivered imefika kwenye kifaa (alama mbili), read imefunguliwa (alama mbili za bluu), na failed haikuweza kutumwa wala kufikishwa, ikionyeshwa kwenye safu ya errors yenye code, title na error_data.details. Kwa hiyo hatua ya kwanza si kukisia: tafuta hali ya failed kwa message id hiyo na usome msimbo wake. Usipokuwa na lengwa la webhook, hakuna kinachorekodi hali hiyo.

Ni sababu zipi, kwa mpangilio wa kuzikagua?

Kuanzia ya kawaida zaidi kwenye nambari mpya iliyounganishwa hadi adimu zaidi. Kila mstari unataja msimbo wa Meta, ili hali ya failed ikuonyeshe uko kwenye sababu ipi:

  • Dirisha limefungwa: 131047, zaidi ya saa 24 tangu mteja alipoandika mara ya mwisho. Maandishi huru yanahitaji dirisha wazi; tuma template.
  • Malipo: 131042, au template zinazoondolewa kimya kimya. Tangu 1 Oktoba 2026, jumbe za huduma pia husimama baada ya kutumia jumbe 1,000 kwa mwezi bila njia ya malipo.
  • Template: 132001 haijaidhinishwa au lugha si sahihi, 132000 idadi ya vigezo si sahihi, 132012 muundo si sahihi, 132015 imesitishwa, 132016 imezimwa.
  • Mpokeaji: 131026 nambari haipo kwenye WhatsApp, toleo la zamani au masharti hayajakubaliwa; 131050 amesitisha jumbe za uuzaji; 131049 imezuiwa ili kulinda ushiriki mzuri; template za uuzaji kwa nambari za Marekani hazifikishwi.
  • Vikomo: 131048 imezuiwa baada ya ishara za barua taka, 131056 jumbe nyingi mno kwa mtu mmoja, 130429 kasi ya kutuma, jumbe 20 kwa sekunde kwenye nambari ya Coexistence.
  • Akaunti: 131031 au 368, akaunti ya WhatsApp Business imezuiwa au imezimwa kwa kukiuka sera.
  • Muunganisho: nambari haijaunganishwa tena, kwa mfano baada ya siku 14 bila kufungua programu ya WhatsApp Business.

Unashughulikiaje misimbo ya upande wa mpokeaji?

Kwa namna tofauti, kwa sababu baadhi yake yanastahili kujaribiwa tena, na mingine hayastahili kamwe. 131050 inamaanisha mtu aliamua kusitisha jumbe za uuzaji kutoka kwako: Meta inasema usijaribu tena, na webhook ya user_preferences inakujulisha wanapositisha au kuanza tena. 131049 ni Meta kuzuia ujumbe wa uuzaji ili kulinda ushiriki mzuri, mara nyingi ni kikomo cha kila mtumiaji kwa template za uuzaji: Meta inashauri kusubiri angalau saa 24 kabla ya kutuma tena, kwa kuwa kutuma mapema kunarudisha hitilafu ileile tu. 131026 inahusu nambari zisizo kwenye WhatsApp, watumiaji ambao hawajakubali masharti ya sasa ya WhatsApp, na matoleo ya zamani sana ya programu; kwanza kagua muundo wa nambari na msimbo wa nchi, kisha umuulize mteja kupitia njia nyingine.

Je, WhatsApp hujaribu kufikisha kwa muda gani?

Ni kwa muda wa kuishi wa ujumbe, yaani TTL yake. Simu ikiwa imezimwa au nje ya mtandao, WhatsApp hujaribu kufikisha tena badala ya kushindwa mara moja: kwa chaguomsingi siku 30 kwa template za huduma na za uuzaji, na dakika 10 kwa template za uthibitishaji. Biashara inaweza kupunguza muda huo kwa kila template kwa kutumia message_send_ttl_seconds, kutoka sekunde 30 hadi saa 12 kwa huduma, na sekunde 30 hadi dakika 15 kwa uthibitishaji. Ujumbe usiofikishwa ndani ya TTL yake huondolewa. Kwa hiyo ujumbe wenye hali ya sent bila hali ya delivered baada ya saa kadhaa kwa kawaida unasubiri simu ya mteja, si kwamba umepotea; weka TTL fupi kwa misimbo na arifa zenye muda maalum ili ufikishaji wa kuchelewa usimchanganye mtu.

Hii ina maana gani kwa majibu ya AI na otomatiki?

Soma run kwanza, kisha hali. Kwenye kichupo cha Runs, run iliyoruka haikutuma chochote na inaeleza sababu yake: "Zaidi ya saa 24 tangu ujumbe wa mwisho wa mteja", "Ulijibu mazungumzo haya kutoka kwenye simu yako hivi karibuni" au "Kikomo cha majibu ya AI kwa mazungumzo haya kimefikiwa saa hii". Run iliyokamilika inamaanisha Meta ilikubali kila jibu, ambalo si uthibitisho wa kufikishwa. easyCoexistence haihifadhi hali za jumbe: otomatiki ikiwa imewashwa, hali hizo hufika kwenye URL ya kusambaza ukiwa umeweka moja, na katika hali ya moja kwa moja huenda moja kwa moja kwenye endpoint yako mwenyewe. Kutoka ChatGPT au Claude, muulize AI yako aendeshe get_number_health: inarudisha hali ya sasa, kiwango cha ubora na matukio 15 ya mwisho ya ufuatiliaji, pamoja na sehemu ya sending yenye msimbo wa Meta.

Jinsi ya kuisanidi

  1. Find the statusLook up the message id in your webhook log and read the latest status: delivered, read, sent only, or failed with an error code.
  2. Match the codeLook up the failed status's code in the list of causes above and in Meta's error codes reference.
  3. Check the accountConfirm the WhatsApp Business Account has a default payment method, a currency and a time zone in Billing & payments.
  4. Check the templateIf it was a template, confirm it is APPROVED in that language and the variables match its definition.
  5. Check the numberAsk your AI to run get_number_health, or open the number in the dashboard, to see the connection and any sending block.

Makosa ya kawaida

  • Kujaribu tena kwenye 131050. Mtu amesitisha jumbe za uuzaji kutoka kwako; majaribio zaidi hayatafikishwa kamwe na yanaweza tu kuongeza ishara hasi.
  • Kusoma message id kama imefikishwa. Meta hukubali kwanza na huripoti kushindwa baadaye, kwa hiyo workflow inayosimama kwenye id hukosa kila ujumbe uliokataliwa.
  • Kutuma jibu la maandishi huru siku moja baadaye. Baada ya saa 24 bila ujumbe wa mteja, template pekee ndiyo inayokubaliwa.
  • Kuendesha bila lengwa la webhook. Hali za failed hufika tu kama webhook, kwa hiyo bila lengwa hilo, sababu ya ujumbe kutofika inapotea.
Kufanya hili ukitumia EasyCoexistence

AI yako inaweza kukagua nambari kutoka ChatGPT au Claude kwa get_number_health. Kuanzia US$ 9 kwa kila nambari iliyounganishwa kwa mwezi, hadi US$ 0.75 kadri unavyoongeza nambari, na siku 3 za kwanza ni bure.

Maswali yanayoulizwa mara kwa mara

Kwa nini ujumbe ulionyesha alama moja ya kukagua kwa saa nyingi?

Alama moja ni hali ya sent: Meta ilituma ujumbe huo, lakini simu haijapokea ujumbe, kwa kawaida kwa sababu imezimwa au haina mtandao. WhatsApp huendelea kujaribu hadi muda wa kuishi wa template uishe, siku 30 kwa chaguomsingi kwa huduma na uuzaji.

Kwa nini majibu yanafika lakini template hazifikishwi?

Mara nyingi ni tatizo la njia ya malipo kwenye akaunti ya WhatsApp Business. Meta hufikisha jumbe za huduma ndani ya kiwango cha bure cha nambari kwa mwezi hata bila njia ya malipo, lakini template hazifikishwi. Ongeza kadi kwenye Billing & payments.

Je, naweza kuona jumbe zilizoshindwa kwenye programu ya WhatsApp Business?

Si kwa uhakika. Kwenye nambari ya Coexistence, jumbe zilizotumwa kupitia API huonekana kwenye mazungumzo ya programu, lakini sababu ya kushindwa inakuja tu kwenye msimbo wa hitilafu wa webhook ya hali.

Je, Meta hutoza kwa jumbe ambazo hazikufikishwa?

Hapana. Meta hutoza tu kwa jumbe zilizofikishwa, na majaribio ya template iliyositishwa pia hayatozwi.

Endelea kusoma

Uko tayari kuanza?

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

Anza kipindi cha majaribio bila malipo

Imethibitishwa kwenye