Meta Tech Provider

Mga field ng WhatsApp webhook, at kung saan napupunta ang mga ito

Naghahatid ang WhatsApp Business Account ng mga event bilang pinangalanang field. Dalawa ang may laman ng usapan at ipinapadala sa inyong endpoint. Anim ang may operational state at ginagamit para sa pagmo-monitor. Ang pagkilala sa mga ito ang tumutukoy sa inyong architecture.

Dalawang message field, anim na operational field
Itinatakda ang routing bawat account
Pinangalanang field, hindi generic payload

Magsimula ng Libreng Trial

Walang sisingilin sa loob ng 7 araw. Mag-cancel anumang oras.

Walang message storageBusiness App + Cloud APIMCP para sa Claude at ChatGPTLive sa loob ng 2 minuto

Mga field sa message path: messages at smb_message_echoes.

Mga operational field na ginagamit para sa pagmo-monitor.

Puwedeng i-override bawat WhatsApp Business Account, na siyang naghihiwalay sa mga ito.

Ano ang dala ng bawat field?

Dala ng messages ang lahat ng ipinapadala ng customer sa numero: text, media reference, reply at reaction. Dala naman ng smb_message_echoes ang ipinapadala ng inyong team mula sa WhatsApp Business app. Umiiral lang ito sa Coexistence number at dito nakikita ng software ang mga sagot ng tao.

Dala ng account_update ang estado ng koneksyon: PARTNER_REMOVED kapag na-uninstall ang app mula sa account, ACCOUNT_OFFBOARDED, ACCOUNT_RECONNECTED, at mga event tungkol sa restriction o violation. Dala ng phone_number_quality_update ang pagbabago sa quality rating at throughput. Dala ng account_alerts ang mga alert na inilalabas ng Meta laban sa account, habang dala ng account_review_update ang resulta ng review.

Dala ng business_capability_update ang pagbabago sa messaging limit at capability, habang dala ng phone_number_name_update ang mga approval at rejection para sa display name.

Bakit mahalaga sa architecture ang paghihiwalay?

Dahil tinutukoy nito kung makararating ba ang laman ng usapan sa isang provider.

Ipinapadala ng override ang dalawang message field sa inyong endpoint nang direkta mula sa Meta. Patuloy namang ipinapadala sa provider ang anim na operational field, kaya posible ang dashboard at alerting nang walang humahawak ng mensahe.

Ito rin ang dahilan kung bakit maaaring structural, hindi lang policy, ang pahayag na hindi nag-iimbak ng mga mensahe. Kapag sa ibang lugar ipinapadala ang message field, walang code path kung saan maiimbak ang mga ito. Sa aming setup, ang account na walang override ay gumagamit ng default callback, kung saan dini-drop ng handler ang mga event nang hindi sine-save.

Anong mga field ang dapat asahan ng inyong handler?

Ang dalawang message field lang kapag naka-set ang override. Mainam na isulat ang handler para balewalain ang iba kaysa mag-fail kapag may natanggap na hindi inaasahan.

Nagdagdag ang Meta ng mga field habang lumilipas ang panahon, at maaaring magkaroon ng bagong key ang payload shape nang walang abiso. Patuloy na gagana ang handler na nagche-check ng field name at bumabalewala sa hindi nito nakikilala. Ang handler na umaasa sa iisang shape ay magti-throw sa unang hindi pamilyar na event.

Mainam ding hawakan nang tahasan ang smb_message_echoes sa halip na ituring itong ingay. Kung wala ito, hindi malalaman ng software na nakasagot na ang isang tao, kaya maaaring makatanggap ang customer ng dalawang sagot sa parehong tanong.

Mga karaniwang pagkakamali

Pag-aakalang generic payload ito. Pinapangalanan ang bawat event, kaya dapat mag-switch ang handler batay rito.
Pagbabalewala sa smb_message_echoes. Kung wala ito, sasagot ang software kahit nakasagot na ang isang tao.
Pagfa-fail sa hindi nakikilalang field sa halip na laktawan ito. Nagdaragdag ang Meta ng mga field nang walang abiso.

Ginagawa ito gamit ang EasyCoexistence

Sina-subscribe ng EasyCoexistence ang operational field para sa pagmo-monitor at ipinapadala ang dalawang message field sa inyong endpoint, o dini-drop ang mga ito nang hindi sine-save kung wala kayong itinakda.

Mga madalas itanong

Maaari ba akong tumanggap ng ilang field lang?

Inililipat ng override sa inyo ang message path. Fixed ang operational split dahil dito binubuo ang monitoring.

May smb_message_echoes ba sa normal na Cloud API number?

Wala. Umiiral ito dahil may taong nagpapadala mula sa app sa Coexistence number, kasabay ng software na nagpapadala mula sa API.

Ano ang nangyayari sa message event kung wala akong itinakdang destination?

Dumarating ang mga ito sa aming default callback at dini-drop nang hindi sine-save.

Mga field name ba ito ng Meta o ng inyong system?

Mga field name ito ng Meta. Walang pangalan dito na kami ang nag-imbento, kaya sulit itong matutunan nang isang beses.

Magpatuloy sa pagbabasa

The messages webhookEverything a customer sends arrives on this field. What the payload carries, how to acknowledge it, and why it never reaches a provider on a routed number.The smb_message_echoes webhookHow software sees what a human sent from the WhatsApp Business app. Only exists on Coexistence numbers, and ignoring it causes double replies.The account_update webhook, and every disconnection reasonaccount_update reports connection state changes. The full list of disconnection reasons Meta sends, what each means, and which ones are recoverable.The phone_number_quality_update webhookWhat this webhook actually carries as of 2026, why the colour quality rating is not in it, and where the rating has to be read from instead.The WhatsApp Business Account, and why overrides live on itWhat a WABA holds, why webhook overrides are applied at this level rather than per number, and what that means when a connection is removed.WhatsApp Cloud API error codesEvery WhatsApp Cloud API error code in one table: what each one means, whether retrying helps, and the page that covers it in full.

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 TrialWalang sisingilin sa loob ng 7 araw. Mag-cancel anumang oras.

Na-verify noong 2026-09-21