Webhook ya messages
messages ni field inayobeba kila kitu mteja anatuma kwenye nambari yako: maandishi, media, majibu, miitikio na majibu shirikishi. Kwenye nambari ya Coexistence iliyopitishwa, hutoka Meta moja kwa moja hadi kwenye endpoint yako, bila kupitia mtoa huduma.
Webhook field inayobeba jumbe za wateja zinazoingia.
Kiambishi awali cha message id kinachotumika kuondoa marudio ya majaribio.
Hali ambayo Meta inatarajia haraka, kabla ya uchakataji wowote.
Payload hubeba nini
Ujumbe mmoja au zaidi katika delivery moja, kila mmoja ukiwa na mtumaji, id na aina. Aina huamua keys nyingine zitakazokuwapo.
- Nambari ya simu ya mtumaji na phone number id ya nambari aliyoiandikia.
- wamid message id, ambayo msingi wa kuondoa marudio hujengwa juu yake.
- Muhuri wa muda wa unix.
- Aina: text, image, audio, video, document, sticker, location, contacts, reaction, button au interactive.
- Kwa aina za media, media id ya kuipakua badala ya bytes zenyewe.
Kwa nini haitufikii kwenye nambari iliyopitishwa
Kwa sababu override huhamisha field hii, pamoja na smb_message_echoes, hadi kwenye destination yoyote unayoteua.
Meta huruhusu programu kubadilisha mahali ambapo WhatsApp Business Account hupeleka webhook zake. Tunaweka override hiyo kwenye URL yako, hivyo njia ya ujumbe huondolewa kabisa kwenye miundombinu yetu. Hakuna nakala, queue wala uhifadhi upande wetu, kwa sababu delivery haifiki huko.
Destination isipowekwa, matukio haya hurudi kwenye callback yetu ya kawaida, ambapo handler huyatupa bila kuyahifadhi. Hiyo ndiyo tofauti kati ya dai kuhusu uhifadhi na code path: hakuna mahali maudhui ya mazungumzo yanaweza kwenda.
Kujibu kwa usahihi
Rudisha 200 kabla ya kufanya kazi, si baada yake.
Meta huchukulia jibu la polepole kuwa hitilafu na hujaribu tena, hivyo handler inayochakata ndani ya ombi itaona ujumbe uleule zaidi ya mara moja. Jibu mara moja, weka payload kwenye queue au background task, kisha kazi ifanyike nje ya ombi.
Kwenye mazingira yasiyo na server ya kudumu, hili si chaguo. Function inayorudisha jibu kisha kuendelea kufanya kazi inaweza kugandishwa mara tu inapojibu, kwa hiyo acknowledgement na uchakataji lazima vitenganishwe kweli.
Kuondoa marudio
Tumia wamid kila mara, kwa sababu majaribio ya kurudia ni jambo la kawaida, si tukio la nadra.
Ujumbe uleule unaweza kufika mara mbili kwa sababu zisizohusiana na hitilafu upande wako: jibu la polepole, network timeout au deploy kufanyika katikati ya delivery. Kuhifadhi ids zilizokwishaonekana na kuruka zinazorudiwa ni mistari michache tu, na ndiyo tofauti kati ya mteja kujibiwa mara moja na kujibiwa mara mbili.
Kwenye nambari ya Coexistence hili ni muhimu zaidi, kwa sababu smb_message_echoes hufika kwenye njia hiyo hiyo na handler inayochukulia kila tukio kuwa jipya itajibu juu ya mtu ambaye tayari amejibu.
Makosa ya kawaida
- Kuchakata kabla ya kurudisha 200. Meta hujaribu tena jibu la polepole na utashughulikia ujumbe mara mbili.
- Kuruka hatua ya kuondoa marudio. Majaribio ya kurudia yamepangwa, si tukio la pembeni.
- Kutarajia bytes za media kwenye payload. Hubeba media id ya kutumia kuipakua.
EasyCoexistence hupeleka field hii moja kwa moja kutoka Meta hadi kwenye endpoint yako na huhifadhi tu matukio ya uendeshaji yanayotumiwa na ufuatiliaji, hivyo maudhui ya mazungumzo hayana njia ya kufika kwenye hifadhi yetu.
Maswali yanayoulizwa mara kwa mara
Je, EasyCoexistence huona jumbe za wateja wangu?
Hapana. Override hupeleka field hii kwenye endpoint yako. Kitu chochote kinachofika kwenye callback yetu ya akiba hutupwa bila kuhifadhiwa.
Je, jumbe kadhaa zinaweza kufika kwenye ombi moja?
Ndiyo. Delivery moja inaweza kuwa na zaidi ya ujumbe mmoja, kwa hiyo handlers zinapaswa kupitia yote badala ya kusoma wa kwanza tu.
Nitapataje media?
Payload hubeba media id. Tumia id hiyo kuchukua URL kwa access token ya nambari, kisha pakua.
smb_message_echoes ni nini?
Ni field inayobeba kile ambacho timu yako hutuma kutoka kwenye programu ya WhatsApp Business. Huonekana tu kwenye nambari za Coexistence.
Endelea kusoma
Uko tayari kuanza?
Sanidi WhatsApp Coexistence kwa dakika chache, si miezi. Programu inaendelea kufanya kazi kwenye simu.
Anza kipindi cha majaribio bila malipoImethibitishwa kwenye