Bakit nabigo ang WhatsApp mensahe: pagbasa sa failed status at mga error nito
Ang failed status webhook ay nangangahulugang hindi naipadala o naihatid ng Meta ang mensaheng ipinadala ng negosyo sa pamamagitan ng API. Dumarating ito sa messages field na may status na failed at errors array na naglalaman ng code, title, message, error_data.details at href. Sinasabi ng code ang dahilan: 131047 sarado na ang 24-hour window, 131026 hindi maihatid, 131049 marketing limit, 131050 itinigil ang marketing, 131042 problema sa payment.
Ikinokonekta ng easyCoexistence ang numero ng inyong WhatsApp Business app sa Cloud API ng Meta sa pamamagitan ng Coexistence at ipinapasa ang mga failed status sa inyong server, direkta o bilang signed forward kapag naka-on ang automations.
Lumipas na ang higit 24 oras mula nang huling sumagot ang recipient; ang ayos ng Meta ay magpadala ng template sa halip.
Hindi naihatid para mapanatiling malusog ang ecosystem; maghintay nang hindi bababa sa 24 oras bago muling ipadala ang marketing template.
Pinili ng recipient na itigil ang marketing mensahe mula sa negosyo; sinasabi ng Meta na huwag na itong subukang muli.
Walang contacts array ang failed status, kaya itugma ang pagkabigo sa pamamagitan ng statuses.id.
Ang sinisingil ng Meta: sinisingil ang mga mensahe kapag naihatid, hindi kapag naipadala.
Ano ang itsura ng failed status?
Kapareho ng ibang status, pero may dagdag na errors. Wala ang contacts array, wala ang recipient_user_id kapag ipinadala ang mensahe sa numero ng telepono, at walang pricing object. Parehong teksto ang title at message, ipinapaliwanag ng error_data.details ito sa isang pangungusap, at tumuturo ang href sa listahan ng error code ng Meta. Ito ay halimbawa mula mismo sa Meta, isang marketing template na itinigil ng per-user limit:
{
"object": "whatsapp_business_account",
"entry": [
{
"id": "102290129340398",
"changes": [
{
"value": {
"messaging_product": "whatsapp",
"metadata": {
"display_phone_number": "15550783881",
"phone_number_id": "106540352242922"
},
"statuses": [
{
"id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgARGBI0QUQ2MjA4NEYyRkExNjMyREUA",
"status": "failed",
"timestamp": "1751142888",
"recipient_id": "16505551234",
"errors": [
{
"code": 131049,
"title": "This message was not delivered to maintain healthy ecosystem engagement.",
"message": "This message was not delivered to maintain healthy ecosystem engagement.",
"error_data": {
"details": "In order to maintain a healthy ecosystem engagement, the message failed to be delivered."
},
"href": "/documentation/business-messaging/whatsapp/support/error-codes"
}
]
}
]
},
"field": "messages"
}
]
}
]
}Aling mga error code ang madalas lumabas, at ano ang ibig sabihin ng mga ito?
Nagbabalik ang Meta ng error sa send response, sa failed status, o sa pareho, kaya maaaring dumating ang parehong code sa alinmang paraan, at dapat basahin ng handler ang dalawang lugar. Ito ang mga code na nagpapaliwanag sa karamihan ng mensaheng hindi dumarating, kasama ang dahilan ayon sa Meta at ang unang dapat subukan. Nasa error code reference ng Meta ang buong listahan:
Paano dapat tumugon ang handler sa bawat uri ng pagkabigo?
Ayusin muna ang code ayon sa susunod na dapat gawin bago mag-retry ang anuman. Ang blanket retry ay nagpapalit ng marketing opt-out sa paulit-ulit na pagkabigo at maaaring magpahaba ng block, samantalang ang pag-drop ng pansamantalang error ay nawawala ang mensaheng sana'y naihatid makalipas ang isang minuto:
- Mag-retry na may backoff: 131000 unknown, 131016 service unavailable, 130429 naabot ang throughput.
- Maghintay muna: 131049, nang hindi bababa sa 24 oras, dahil ang maagang retry ay maaaring mag-block sa user na iyon nang hanggang 24 oras pa.
- I-switch ang mensahe: 131047 ay nangangailangan ng approved template, dahil sarado na ang 24-hour window.
- Itigil para sa customer na ito: 131050, hanggang dumating ang
user_preferencesresume. - Ayusin ang account o content: 131042 payment, 131031 account restricted, 131053 media.
Aling mga pagkabigo ang lumalabas lang bilang failed status?
Yaong mga pinapasya ng Meta matapos tanggapin ang request. Nagbabalik ang send ng wamid, at darating ang pagtanggi sa webhook na ito pagkatapos. Hindi naghahatid ang Meta ng marketing template sa mga WhatsApp user na may United States na numero ng telepono (+1 na may US area code). Ang marketing template sa customer na tumigil sa marketing mensahe ay pinoproseso at saka iniuulat na failed na may 131050, at ang per-user marketing limit ay nag-uulat ng 131049 sa parehong paraan.
Kung walang webhook destination ang numero, hindi makikita kahit saan ang mga pagkabigong ito at mukhang naipadala lang ang mensahe. Para sa buong pagkakasunod-sunod ng pagsusuri kapag walang natanggap ang customer, tingnan ang pahina tungkol sa WhatsApp API messages not delivered.
Ano ang nagbabago sa Coexistence number?
Dalawang bagay ang mahalaga. Una, ang 24-hour window ay nalalapat lamang sa API. Sinasabi ng Coexistence guide ng Meta na ang mga mensaheng ipinadala mula sa WhatsApp Business app ay hindi sakop ng customer service window, kaya pagkatapos ng 131047 ay maaari pa ring sagutin ng may-ari ang customer na iyon mula sa telepono, habang nagpapadala ng approved template ang sistema ninyo.
Ikalawa, nakapirmi ang throughput. Ang numerong ginagamit sa app at API nang sabay ay nagpapadala ng hanggang 20 mensahe kada segundo, at kapag lumampas dito ay nagbabalik ng 130429. Ang iba pa ay magkapareho sa anumang Cloud API number: parehong field, parehong errors array, parehong code.
Paano nakikita ng mga automation at ng AI ninyo ang pagkabigo?
Nakadepende ito kung kailan sasabihin ng Meta ang hindi. Ang pagtanggi sa oras ng pagpapadala, gaya ng 131047, ay nagpapabigo sa hakbang ng automation: ipinapakitang Failed ang run kasama ang mensahe ng Meta sa Runs tab, at nakakatanggap ang may-ari ng email para masagot nila mismo ang customer na iyon. Sinusuri rin ng automations ang window bago magpadala ng free-form na sagot, at nilalaktawan ito na may window_closed sa halip na subukan.
Ang pagkabigong iniulat ng Meta pagkatapos ay dumarating bilang failed status sa inyong Forward URL o direct destination, at nananatiling pareho ang run. Ang AI na nagpadala ng template sa pamamagitan ng MCP connector ay nakikita ang wamid at "sent: true". Itanong sa sistema ninyo ang status ng wamid na iyon, o hilingin sa assistant na patakbuhin ang get_number_health kapag maraming mensahe ang sabay-sabay na pumalya.
Mga karaniwang pagkakamali
- Paulit-ulit na pag-retry ng 131050. Tumigil ang customer sa marketing mensahe, kaya pumapalpak ang bawat pagsubok sa parehong paraan hanggang bumalik ang customer.
- Muling pagpapadala ng 131049 marketing template sa loob ng ilang oras. Hinihingi ng Meta ang hindi bababa sa 24 oras, at ang maagang retry ay maaaring mag-block sa user na iyon nang hanggang 24 oras pa.
- Pag-log lamang ng title. Dala ng error_data.details ang tiyak na dahilan, kaya itago ang code at details kasama ng wamid.
- Pagtakbo nang walang webhook destination at paghusga sa paghahatid base sa send response, na nagsasabi lamang na tinanggap ng Meta ang mensahe.
Kapag tinanggihan ang sagot ng isang automation sa oras ng pagpapadala, ipinapakita ng run ang error ng Meta at makakatanggap kayo ng email. Mino-monitor ang bawat numero 24/7 para sa disconnection at pagbaba ng kalidad. US$ 9 hanggang US$ 0.75 kada numero kada buwan, bumababa habang dumarami ang numero, at libre ang unang 3 araw.
Mga madalas itanong
Sinisingil ba ng Meta ang failed na mensahe?
Sinasabi ng pricing page ng Meta na naniningil ito para sa mga mensaheng naihatid, hindi para sa mga mensaheng ipinadala lamang. Walang pricing object ang failed status. Napupunta ang mga singil sa sariling WhatsApp Business Account ng negosyo; hindi kailanman nilalagyan ng markup ng easyCoexistence ang mga ito.
Ibig bang sabihin ng 131026 na hinarang ng customer ang negosyo?
Iba pang dahilan ang nakalista ng Meta para sa 131026: wala sa WhatsApp ang numero, hindi pa tinatanggap ng recipient ang pinakabagong terms, o masyadong luma ang bersyon ng WhatsApp nila. Iminumungkahi ng Meta na tanungin ang customer sa ibang channel para tingnan ang mga iyon.
Bakit lumalabas ang recipient_user_id sa ilang pagkabigo at wala sa iba?
Inaalis ito ng Meta sa failed status kapag ipinadala ang mensahe sa numero ng telepono. Kapag ipinadala ninyo sa BSUID ng customer, kasama ito sa pagkabigo, at maaaring ang recipient_id ang nawawala.
Maaari bang pumalya ang mensahe matapos itong maihatid?
Ang reference ng Meta ay naglalarawan sa failed bilang pagkabigo sa pagpapadala o paghahatid. Kapag naabot na ng mensahe ang device, ang susunod na status na maaari ninyong asahan ay read, o played para sa voice messages.
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 TrialNa-verify noong