Ang messages webhook
Ang messages ang field na nagdadala ng lahat ng ipinapadala ng customer sa inyong numero: text, media, replies, reactions at interactive responses. Sa routed na Coexistence number, mula Meta diretso ito sa inyong endpoint at hindi dumadaan sa provider.
Ang webhook field na nagdadala ng mga papasok na mensahe ng customer.
Ang prefix sa message id na ginagamit para i-deduplicate ang retries.
Ang status na mabilis na inaasahan ng Meta bago ang anumang pag-process.
Ano ang laman ng payload
Isa o higit pang messages sa isang delivery, bawat isa ay may sender, id at type. Tinutukoy ng type kung aling iba pang keys ang kasama.
- Ang phone number ng sender at ang phone number id ng numerong pinadalhan nila.
- Isang wamid message id, na batayan ng deduplication.
- Isang unix timestamp.
- Isang type: text, image, audio, video, document, sticker, location, contacts, reaction, button o interactive.
- Para sa media types, isang media id na gagamitin sa pag-fetch, hindi ang mismong bytes.
Bakit hindi ito nakakarating sa amin sa routed number
Inililipat ng override ang field na ito, kasama ang smb_message_echoes, sa destinasyong pipiliin ninyo.
Pinapayagan ng Meta ang isang app na baguhin kung saan ihahatid ng WhatsApp Business Account ang mga webhook nito. Itinatakda namin ang override sa inyong URL, kaya tuluyang inaalis ang daloy ng mensahe sa aming infrastructure. Walang copy, queue o retention sa panig namin dahil hindi kailanman dumarating dito ang delivery.
Kapag walang itinakdang destination, napupunta ang mga event na ito sa aming default callback, kung saan dini-drop ang mga ito nang hindi sine-save. Ito ang kaibahan ng pahayag tungkol sa storage at ng aktuwal na code path: walang mapupuntahan ang conversation content.
Paano mag-acknowledge nang tama
Magbalik ng 200 bago ninyo gawin ang trabaho, hindi pagkatapos.
Itinuturing ng Meta na failure ang mabagal na response at nagre-retry ito. Dahil dito, maaaring makita nang higit sa isang beses ng inline na nagpo-process na handler ang parehong mensahe. Sumagot agad, ilagay ang payload sa queue o background task, at isagawa ang trabaho sa labas ng request.
Sa serverless, hindi ito opsyonal. Maaaring i-freeze ang function sa sandaling magbalik ito ng response kahit patuloy pa itong gumagana, kaya dapat tunay na magkahiwalay ang acknowledgement at processing.
Paano mag-deduplicate
Palaging gamitin ang wamid, dahil normal ang retries at hindi ito pambihirang error.
Maaaring dumating nang dalawang beses ang parehong mensahe dahil sa mga dahilang walang kinalaman sa bug sa inyong panig: mabagal na response, network timeout o deploy na tumama sa kalagitnaan ng delivery. Ilagay sa storage ang mga nakita nang id at laktawan ang repeats. Ilang linya lang ito, pero ito ang pagkakaiba ng isang beses at dalawang beses na pagsagot sa customer.
Mas mahalaga ito sa Coexistence number dahil dumarating sa parehong path ang smb_message_echoes. Kung ituturing ng handler na bago ang bawat event, sasagot ito sa ibabaw ng sagot na naibigay na ng inyong team.
Mga karaniwang pagkakamali
- Nagpo-process bago magbalik ng 200. Nire-retry ng Meta ang mabagal na response at dalawang beses ninyong mahahawakan ang mensahe.
- Nilalaktawan ang deduplication. Bahagi ng disenyo ang retries, hindi ito edge case.
- Inaasahan ang media bytes sa payload. Media id ang dala nito para sa pag-fetch.
Direktang niruruta ng EasyCoexistence ang field na ito mula Meta papunta sa inyong endpoint at ang operational events lang na kailangan sa pagmo-monitor ang pinananatili, kaya walang daan ang conversation content papunta sa aming storage.
Mga madalas itanong
Nakikita ba ng EasyCoexistence ang mga mensahe ng aking customers?
Hindi. Inihahatid ng override ang field na ito sa inyong endpoint. Anumang makarating sa aming fallback callback ay dini-drop nang hindi sine-save.
Maaari bang maraming messages ang dumating sa isang request?
Oo. Maaaring maglaman ng higit sa isa ang isang delivery, kaya dapat i-iterate ng handlers ang mga ito sa halip na ang unang mensahe lang ang basahin.
Paano ko makukuha ang media?
May media id sa payload. Gamitin ito para i-fetch ang URL gamit ang access token ng numero, saka mag-download.
Ano ang smb_message_echoes?
Ito ang companion field na nagdadala ng ipinapadala ng inyong team mula sa WhatsApp Business app. Umiiral lamang ito sa Coexistence numbers.
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