WhatsApp webhookovi: usmjeravanje poruka izravno na vaš poslužitelj

Što Meta zapravo šalje webhooku?

Događaje, podijeljene u kategorije, a razlika među njima određuje vašu arhitekturu.

Put poruka prenosi ono što korisnici šalju i, na Coexistence broju, odjeke onoga što vaš tim šalje iz aplikacije WhatsApp Business. To su polja messages i smb_message_echoes, koja sadrže sadržaj razgovora.

Operativni put prenosi sve ostalo: account_update kada se promijeni stanje veze, phone_number_quality_update kada se promijene kvaliteta ili propusnost, account_alerts, account_review_update, business_capability_update i phone_number_name_update. Oni ne sadrže sadržaj razgovora i na njima se temelji nadzor.

Pružatelj koji se postavi na put poruka prima prvu skupinu. Onaj koji to ne učini, ne prima je.

Kako Meta provjerava endpoint?

GET zahtjevom prije isporuke bilo čega, a neuspješna provjera najčešći je razlog zašto postavljanje koje izgleda dovršeno nikad ne primi poruku.

Meta poziva vaš URL s hub.mode postavljenim na subscribe, vašim hub.verify_token i vrijednošću hub.challenge. Vaš endpoint mora vratiti taj challenge kao sirovo tijelo odgovora, bez JSON-a i bez ikakvih dodataka. Ako to ne učini, Meta nikad ne počinje s isporukom, a nijedna nadzorna ploča to neće prikazati.

Endpoint mora biti i HTTPS. Endpoint koji vraća tihu pogrešku 404 ili onaj iza sloja provjere autentičnosti koji odbija Metu izgleda jednako kao ispravno postavljeno rješenje sve do trenutka kada prva poruka ne stigne.

Može li odredište upućivati na vaš poslužitelj?

Da, i upravo se u tome pružatelji razlikuju.

Meta dopušta aplikaciji da nadjača mjesto na koje određeni WhatsApp Business Account isporučuje webhookove. To nadjačavanje postavljamo na vaš URL, čime događaje puta poruka premještamo s našeg callbacka na vaš. Operativne događaje zadržavamo jer se od njih sastoje nadzorna ploča i upozorenja.

Posljedica je arhitektonska, a ne pravilo koje objavljujemo. Sadržaj razgovora nema gdje biti pohranjen na našoj strani jer nam se nikad ne isporučuje. Račun bez postavljenog nadjačavanja vraća se na naš zadani callback, gdje rukovatelj odbacuje te događaje bez pohrane.

Što se događa s odredištem kada se broj ponovno poveže?

Uklanja se, a to je kvar za koji gotovo nitko ne planira.

Odredište nije svojstvo telefonskog broja. To je nadjačavanje pretplate naše aplikacije na WhatsApp Business Account. Kada se veza ukloni, zbog Metina pravila o neaktivnosti od četrnaest dana ili iz drugog razloga, aplikacija se deinstalira s tog računa, a s njom nestaje i nadjačavanje.

Ponovno povezivanje vraća slanje i nadzor. Ne vraća isporuku na vaš poslužitelj i ništa ne prijavljuje pogrešku, pa je prvi znak često korisnik koji kaže da mu nitko nije odgovorio. Nadjačavanje ponovno primjenjujemo pri svakom povezivanju jer se to dogodilo stvarnom broju koji se uredno ponovno povezao, a zatim utihnuo.

Uobičajene pogreške

• Vraćanje JSON-a iz verifikacijskog GET-a. Meta želi sirovu vrijednost hub.challenge i ništa drugo.
• Upotreba privremenog ili testnog URL-a. Meta će na njega nastaviti slati podatke nakon što alat koji ga je generirao prestane slušati.
• Pretpostavka da odredište preživljava ponovno povezivanje. Ono živi na pretplati aplikacije i deinstalira se zajedno s njom.
• Postavljanje endpointa iza provjere autentičnosti koja odbija Metin zahtjev.

Često postavljana pitanja

Nastavite čitati