Webhook za messages
`messages` je polje koje nosi sve što korisnik pošalje na vaš broj: tekst, medije, odgovore, reakcije i interaktivne odgovore. Na rutiranom Coexistence broju ide direktno od Meta do vašeg endpointa, nikad preko provajdera.
Webhook polje koje nosi dolazne poruke korisnika.
Prefiks u identifikatoru poruke koji se koristi za uklanjanje duplikata pri ponovljenim pokušajima.
Status koji Meta brzo očekuje, pre obrade.
Šta payload sadrži
Jednu ili više poruka u jednoj isporuci, a svaka sadrži pošiljaoca, identifikator i tip. Tip određuje koji su drugi ključevi prisutni.
- Broj telefona pošiljaoca i identifikator broja kome je poruka poslata.
- `wamid` identifikator poruke, na kome se zasniva uklanjanje duplikata.
- Unix timestamp.
- Tip: `text`, `image`, `audio`, `video`, `document`, `sticker`, `location`, `contacts`, `reaction`, `button` ili `interactive`.
- Kod medijskih tipova, identifikator medija za preuzimanje, a ne sami bajtovi.
Zašto na rutiranom broju nikad ne stiže nama
Zato što override premešta ovo polje, zajedno sa `smb_message_echoes`, na odredište koje navedete.
Meta omogućava aplikaciji da promeni mesto na koje WhatsApp Business Account isporučuje webhookove. Taj override postavljamo na vaš URL, čime se put poruke u potpunosti uklanja iz naše infrastrukture. Kod nas nema kopije, reda čekanja ni zadržavanja, jer isporuka tamo nikad ne stiže.
Kada odredište nije podešeno, ovi događaji se vraćaju na naš podrazumevani callback, gde ih obrađivač odbacuje bez čuvanja. To je razlika između tvrdnje o skladištenju i putanje koda: sadržaj razgovora nema gde da ode.
Ispravno potvrđivanje prijema
Vratite 200 pre nego što počnete rad, ne nakon toga.
Meta spor odgovor smatra greškom i ponavlja zahtev, pa će obrađivač koji obrađuje poruku unutar zahteva istu poruku videti više puta. Odmah odgovorite, stavite payload u red čekanja ili pozadinski zadatak i obavite rad izvan zahteva.
Na serverless infrastrukturi ovo nije opciono. Funkcija koja vrati odgovor, a zatim nastavi da radi, može biti zamrznuta čim odgovori, zato potvrđivanje prijema i obrada moraju zaista biti odvojeni.
Uklanjanje duplikata
Uvek koristite `wamid`, jer su ponovljeni pokušaji uobičajeni, a ne izuzetak.
Ista poruka može stići dvaput iz razloga koji nemaju veze sa greškom na vašoj strani: spor odgovor, mrežno prekoračenje vremena ili objavljivanje nove verzije tokom isporuke. Čuvanje viđenih identifikatora i preskakanje ponavljanja zahteva svega nekoliko linija i predstavlja razliku između toga da korisniku odgovorite jednom ili dvaput.
Na Coexistence broju ovo je još važnije, jer `smb_message_echoes` stiže istom putanjom, a obrađivač koji svaki događaj smatra novim odgovoriće preko čoveka koji je već odgovorio.
Česte greške
- Obrada pre vraćanja 200. Meta ponavlja spor odgovor, pa poruku obrađujete dvaput.
- Preskakanje uklanjanja duplikata. Ponovljeni pokušaji su predviđeni, nisu rubni slučaj.
- Očekivanje bajtova medija u payloadu. On nosi identifikator medija za preuzimanje.
EasyCoexistence usmerava ovo polje direktno od Meta do vašeg endpointa i zadržava samo operativne događaje potrebne za nadzor, pa sadržaj razgovora uopšte nema put do našeg skladišta.
Često postavljana pitanja
Da li EasyCoexistence vidi poruke mojih korisnika?
Ne. Override isporučuje ovo polje vašem endpointu. Sve što stigne do našeg rezervnog callbacka odbacuje se bez čuvanja.
Može li više poruka stići u jednom zahtevu?
Da. Jedna isporuka može sadržati više poruka, zato obrađivači treba da prođu kroz sve, umesto da čitaju prvu.
Kako da preuzmem medij?
Payload nosi identifikator medija. Pomoću njega preuzmite URL koristeći access token tog broja, a zatim preuzmite fajl.
Šta je `smb_message_echoes`?
Prateće polje koje nosi ono što vaš tim šalje iz aplikacije WhatsApp Business. Postoji samo na Coexistence brojevima.
Nastavite sa čitanjem
Spremni da počnete?
Podesite WhatsApp Coexistence za nekoliko minuta, a ne meseci. Aplikacija nastavlja da radi na telefonu.
Započnite besplatni probni periodProvereno na