WhatsApp webhookovi: usmerite poruke direktno na svoj server
WhatsApp webhook je HTTPS endpoint koji odredite, a Meta na njega šalje događaje: dolazne poruke, statuse isporuke, promene kvaliteta i ažuriranja naloga. Kod Coexistence broja odredište može biti vaš server, pa razgovori uopšte ne prolaze kroz provajdera.
- Meta šalje događaje direktno na vaš URL
- Vaš endpoint, a ne platforma provajdera
- Jedno preusmeravanje po WhatsApp Business Account-u
7 dana bez naplate. Otkažite bilo kada.
Šta obuhvata cela integracija: jedno HTTPS odredište po nalogu.
messages i smb_message_echoes, događaji putanje poruka koji se usmeravaju ka vama.
Vrednost koju Meta šalje tokom GET rukovanja i koju vaš endpoint mora da vrati.
Šta Meta zapravo šalje webhooku?
Događaje, razvrstane po kategorijama, a razlika među njima određuje vašu arhitekturu.
Putanja poruka prenosi ono što korisnici šalju i, kod Coexistence broja, odjeke onoga što vaš tim šalje iz aplikacije WhatsApp Business. To su polja messages i smb_message_echoes i ona sadrže sadržaj razgovora.
Operativna putanja prenosi sve ostalo: account_update kada se stanje veze promeni, phone_number_quality_update kada se promene kvalitet ili propusnost, account_alerts, account_review_update, business_capability_update i phone_number_name_update. Ona ne sadrže sadržaj razgovora i na njima se zasnivaju praćenje i upozorenja.
Provajder koji se postavi na putanju poruka prima prvu grupu. Onaj koji to ne uradi, ne prima je.
Kako Meta verifikuje endpoint?
GET zahtevom, pre nego što počne da isporučuje bilo šta, a neuspešna provera je najčešći razlog zbog kog podešavanje koje deluje završeno nikada ne primi poruku.
Meta poziva vaš URL sa vrednošću hub.mode postavljenom na subscribe, vašim hub.verify_token i vrednošću hub.challenge. Endpoint mora da vrati taj izazov kao sirovo telo odgovora, bez JSON omota i bez bilo kakvog dodatka. Ako to ne uradi, Meta nikada ne počinje isporuku, a nijedna kontrolna tabla to neće prikazati.
Endpoint mora biti i HTTPS. Endpoint koji vraća tihu grešku 404 ili onaj iza sloja za autentifikaciju koji odbija Metu izgleda isto kao ispravno podešavanje sve do trenutka kada prva poruka ne stigne.
Može li odredište da bude vaš server?
Da, i upravo se tu provajderi razlikuju.
Meta dozvoljava aplikaciji da promeni mesto na koje određeni WhatsApp Business Account isporučuje webhookove. Mi to preusmeravanje postavljamo na vaš URL, čime događaji putanje poruka prelaze sa našeg callbacka na vaš. Operativne događaje zadržavamo, jer se od njih sastoje kontrolna tabla i upozorenja.
Posledica je arhitektonska, a ne pravilo koje objavljujemo. Sadržaj razgovora nema gde da se čuva kod nas, jer nam se nikada ne isporučuje. Nalog bez podešenog preusmeravanja vraća se na naš podrazumevani callback, gde rukovalac odbacuje te događaje bez čuvanja.
Šta se dešava sa odredištem kada se broj ponovo poveže?
Uklanja se, a na taj kvar gotovo niko ne računa.
Odredište nije svojstvo telefonskog broja. To je preusmeravanje na pretplatu naše aplikacije na WhatsApp Business Account. Kada se veza ukloni, zbog Metinog pravila o neaktivnosti od četrnaest dana ili iz drugog razloga, aplikacija se deinstalira sa tog naloga, a preusmeravanje nestaje zajedno s njom.
Ponovno povezivanje vraća slanje i praćenje. Ne vraća isporuku na vaš server i ništa ne prijavljuje grešku, pa je prvi znak to što korisnik kaže da mu niko nije odgovorio. Preusmeravanje ponovo primenjujemo pri svakom povezivanju, jer se to desilo stvarnom broju koji se uspešno ponovo povezao, a zatim utihnuo.
Česte greške
- Vraćanje JSON-a iz GET provere. Meta želi sirovu vrednost hub.challenge i ništa drugo.
- Korišćenje privremenog ili testnog URL-a. Meta nastavlja da šalje podatke na njega i kada alat koji ga je napravio prestane da osluškuje.
- Pretpostavka da odredište preživljava ponovno povezivanje. Ono pripada pretplati aplikacije i deinstalira se zajedno s njom.
- Postavljanje endpointa iza autentifikacije koja odbija Metin zahtev.
EasyCoexistence postavlja preusmeravanje webhooka na vaš endpoint, proverava ga pre poziva i automatski ga ponovo primenjuje posle svakog povezivanja. Od US$ 9 po broju mesečno, do US$ 2 pri većem obimu, uz prvih 7 dana besplatno.
Često postavljana pitanja
Da li moje poruke prolaze kroz EasyCoexistence?
Ne. Preusmeravanje šalje događaje putanje poruka iz Mete direktno na vaš endpoint. Događaji za nalog bez preusmeravanja vraćaju se na naš callback i odbacuju bez čuvanja.
Mogu li kasnije da promenim odredište?
Da, u bilo kom trenutku, preko kontrolne table ili MCP konektora. Prosleđivanje vrednosti null vraća ga na naše podrazumevano odredište.
Šta ako moj server nije dostupan kada Meta šalje podatke?
Meta pokušava ponovo određeni period, a zatim prestaje. Poruke i dalje stižu u aplikaciju WhatsApp Business na telefonu, pa firma ništa ne gubi čak ni kada integracija zakaže.
Da li je jedan webhook dovoljan za više brojeva?
Da. Usmerite svaki broj na isti endpoint i granajte na osnovu id-a telefonskog broja koji se prima u payload-u.
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 period7 dana bez naplate. Otkažite bilo kada.Provereno na