Mag-log inMagsimula ng Libreng Trial
Meta Tech Provider

Hindi na-deliver ang WhatsApp API mensahe: ang mga sanhi, ayon sa pagkakasunod

Ang mensaheng tinanggap ng WhatsApp API ay hindi pa nangangahulugang na-deliver na: iuulat ng Meta ang resulta mamaya sa status webhook, bilang sent, delivered, read o failed, kasama ang error code. Tingnan ayon sa pagkakasunod: ang failed status at ang code nito, ang 24-hour window (131047), ang payment method (131042), ang template (132001, 132015), ang recipient (131026, 131049, 131050), saka ang limits at koneksyon ng numero.

Pinagmo-monitor ng easyCoexistence ang bawat naka-connect na numero nang 24/7, nagpapadala ng email kapag huminto ang delivery ng Meta, naputol ang link, o bumaba ang quality, at ipinapasa nang walang pagbabago ang status webhooks ng Meta sa inyong system.

4 statuses

sent (isang check mark), delivered (dalawang check mark), read (dalawang asul na check mark) at failed (pulang error triangle), ayon sa iniuulat ng status webhooks.

131047

Lumipas na ang higit sa 24 oras mula nang huling sumagot ang recipient; sinasabi ng Meta na magpadala na lang ng template.

131026

Hindi ma-deliver: wala sa WhatsApp ang numero, hindi pa tinatanggap ng recipient ang bagong terms, o gumagamit ng lumang bersyon ng WhatsApp.

30 days

Ang default na oras kung saan ini-retry ng WhatsApp ang hindi naihatid na utility o marketing template bago ito i-drop; 10 minuto naman ang default ng authentication templates.

20 mps

Nakapirming throughput ng numerong ginagamit sa parehong WhatsApp Business app at Cloud API.

Bakit hindi pa rin dumarating ang tinanggap na mensahe?

Dahil magkahiwalay na pangyayari ang sagot ng API at ang delivery. Kapag nagpapadala, agad na nagbabalik ang Meta ng message id sa sandaling tanggapin nito ang request; kung makararating ang mensahe sa telepono ng customer, malalaman ito mamaya sa status webhook sa messages field. Ang sent ay nangangahulugang umalis na sa servers ng Meta (isang check mark), ang delivered ay naabot na ang device (dalawang check mark), ang read ay nabuksan na (dalawang asul na check mark), at ang failed ay hindi naipadala o hindi naihatid, ipinapakita sa inyo gamit ang errors array: code, title at error_data.details. Kaya huwag munang manghula: hanapin ang failed status para sa message id na iyon at basahin ang code nito. Kung walang webhook destination, walang nagtatala nito.

Ano ang mga sanhi, ayon sa pagkakasunod na dapat tingnan?

Mula sa pinakakaraniwan sa bagong naka-connect na numero hanggang sa pinakabihira. Nakasaad ang code ng Meta sa bawat linya, kaya ituturo ng failed status kung alin ang nararanasan ninyo:

  • Sarado ang window: 131047, lampas 24 oras mula nang huling nagsulat ang customer. Kailangan ng bukas na window ang free-form text; magpadala ng template.
  • Payment: 131042, o tahimik na na-drop ang templates. Simula 1 Oktubre 2026, humihinto rin ang service na mensahe kapag naabot ang 1,000 kada buwan nang walang payment method.
  • Template: 132001 hindi aprubado o mali ang wika, 132000 mali ang bilang ng variables, 132012 mali ang format, 132015 naka-pause, 132016 naka-disable.
  • Recipient: 131026 wala sa WhatsApp, luma ang bersyon o hindi tinanggap ang terms; 131050 huminto na sa pagtanggap ng marketing na mensahe; 131049 pinigil para mapanatiling malusog ang engagement; hindi naihahatid ang marketing templates sa mga numerong US.
  • Limits: 131048 pinaghigpitan matapos ang spam signals, 131056 sobrang dami ng mensahe sa iisang tao, 130429 throughput, 20 mensahe kada segundo sa Coexistence na numero.
  • Account: 131031 o 368, naka-restrict o naka-disable ang WhatsApp Business Account dahil sa paglabag sa policy.
  • Koneksyon: hindi na naka-link ang numero, halimbawa pagkalipas ng 14 na araw nang hindi binubuksan ang WhatsApp Business app.

Paano hahawakan ang mga code sa panig ng recipient?

Iba ang paraan ng paghawak dito, dahil may ilang nararapat i-retry at may ilang hindi kailanman. Ang 131050 ay nangangahulugang pinili ng tao na huminto sa marketing na mensahe mula sa inyo: sinasabi ng Meta na huwag nang i-retry, at sasabihan kayo ng user_preferences webhook kapag huminto o nagpatuloy ang tao. Ang 131049 ay pagpigil ng Meta sa marketing na mensahe para mapanatiling malusog ang engagement, kadalasan ay limit kada user sa marketing templates. Payo ng Meta na maghintay nang hindi bababa sa 24 oras bago magpadala muli, dahil kapag mas maaga, parehong error lang ang babalik. Sakop ng 131026 ang mga numerong wala sa WhatsApp, mga user na hindi pa tinatanggap ang kasalukuyang terms ng WhatsApp, at napakaluluma nang bersyon ng app. Suriin muna ang format ng numero at country code, saka tanungin ang customer sa ibang channel.

Gaano katagal sinusubukan ng WhatsApp na ihatid ang mensahe?

Sa loob ng time to live (TTL) ng mensahe. Kapag naka-off ang telepono o wala sa coverage area, inuulit ng WhatsApp ang delivery sa halip na agad mabigo: bilang default, 30 araw para sa utility at marketing templates, at 10 minuto para sa authentication templates. Maaaring paikliin ng negosyo ang tagal kada template gamit ang message_send_ttl_seconds, mula 30 segundo hanggang 12 oras para sa utility, at 30 segundo hanggang 15 minuto para sa authentication. Ang mensaheng hindi maihahatid sa loob ng TTL nito ay i-drop. Kaya ang mensaheng may sent status at walang delivered status pagkaraan ng ilang oras ay kadalasang naghihintay pa sa telepono ng customer, hindi nawala. Magtakda ng maikling TTL para sa codes at time-sensitive alert para hindi malito ang sinuman kapag huli nang dumating ang delivery.

Ano ang ibig sabihin nito para sa AI replies at automations?

Basahin muna ang run, saka ang status. Sa Runs tab, ang Skipped na run ay walang naipadala at nagsasabi kung bakit: "More than 24 hours since the customer's last message", "You answered this chat from your phone recently" o "AI reply limit for this chat reached this hour". Ang Done na run ay nangangahulugang tinanggap ng Meta ang bawat reply, na hindi patunay ng delivery. Hindi nag-iimbak ng status ng mensahe ang easyCoexistence: kapag naka-on ang automations, mapupunta ang mga ito sa forward URL kung nagtakda kayo ng isa, at sa direct mode ay diretsong pupunta sa sarili ninyong endpoint. Mula sa ChatGPT o Claude, hilingin sa inyong AI na patakbuhin ang get_number_health: ibabalik nito ang live status, quality rating, at huling 15 event sa pagmo-monitor, kabilang ang sending block na may code ng Meta.

Paano ito i-set up

  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.

Mga karaniwang pagkakamali

  • Pag-retry sa 131050. Huminto na ang tao sa pagtanggap ng marketing na mensahe mula sa inyo; ang mga dagdag na pagsubok ay hindi kailanman maihahatid at puro negatibong signal lang ang madaragdag.
  • Pagturing sa message id bilang delivered. Tinatanggap muna ng Meta ang request at iniuulat ang failure mamaya, kaya ang workflow na tumitigil sa message id ay nakakaligtaan ang bawat mensaheng tinanggihan.
  • Pagpapadala ng free-form na reply makalipas ang isang araw. Pagkatapos ng 24 oras na walang mensahe mula sa customer, template lang ang tinatanggap.
  • Pagpapatakbo nang walang webhook destination. Ang failed status ay dumarating lamang bilang webhook, kaya kapag wala ito, mawawala ang dahilan kung bakit hindi dumating ang mensahe.
Ginagawa ito gamit ang EasyCoexistence

Maaaring tingnan ng inyong AI ang numero mula sa ChatGPT o Claude gamit ang get_number_health. Mula US$ 9 hanggang US$ 0.75 kada naka-connect na numero kada buwan, bumababa habang dumarami ang numero, kasama ang unang 3 araw na free trial.

Mga madalas itanong

Bakit isang check mark lang ang mensahe nang ilang oras?

Ang isang check mark ay sent status: naipadala ito ng Meta, pero hindi pa natatanggap ng telepono, kadalasan dahil naka-off o offline ito. Patuloy na nagre-retry ang WhatsApp hanggang maubos ang time to live ng template, 30 araw bilang default para sa utility at marketing.

Bakit dumarating ang mga reply pero hindi ang templates?

Kadalasan ay problema sa payment method ng WhatsApp Business Account. Naihahatid ng Meta ang service na mensahe sa loob ng buwanang libreng tier ng numero kahit walang payment method, pero hindi nito inihahatid ang templates. Magdagdag ng card sa Billing & payments.

Makikita ko ba ang mga failed na mensahe sa WhatsApp Business app?

Hindi maaasahan. Sa Coexistence na numero, lumalabas sa chat thread ng app ang mga mensaheng ipinadala sa pamamagitan ng API, pero ang dahilan ng pagkabigo ay makikita lamang sa error code ng status webhook.

Naniningil ba ang Meta para sa mga mensaheng hindi naihatid?

Hindi. Naniningil lang ang Meta para sa mga naihatid na mensahe, at hindi rin sinisingil ang mga pagsubok gamit ang naka-pause na template.

Magpatuloy sa pagbabasa

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 Trial

Na-verify noong