WhatsApp user_preferences webhook: kada korisnik zaustavi ili nastavi marketing poruke
Webhook user_preferences obaveštava firmu da je korisnik WhatsApp-a zaustavio ili nastavio marketing poruke preko podešavanja Offers and announcements. Svaki događaj sadrži kategoriju marketing_messages, vrednost stop ili resume, rečenicu s detaljima, wa_id i BSUID korisnika i Unix vremensku oznaku. Opcije Interested i Not interested u istom podešavanju ne aktiviraju ga.
easyCoexistence povezuje vaš broj iz WhatsApp Business aplikacije s Metinim Cloud API-jem preko Coexistence, pa vaša AI i automatizacije rade na broju koji zadržavate u aplikaciji.
Vrednosti koje preferencija može imati: stop i resume, obe u kategoriji marketing_messages.
Šifra neuspelog statusa za marketing šablon poslat korisniku koji je zaustavio marketing poruke.
Gde Meta šalje user_preferences: to nije polje koje WhatsApp Business Account ili broj mogu da nadjačaju.
Dozvola koju aplikacija treba za webhook-ove osim messages i calls, uključujući user_preferences.
Šta aktivira webhook user_preferences?
Korisnik otvori Offers and announcements u WhatsApp-u i izabere da zaustavi, ili kasnije da nastavi, marketing poruke vaše firme. Ove dve radnje su jedini okidači. Ista podešavanja omogućavaju i da korisnik označi Interested ili Not interested, a takva povratna informacija ne šalje webhook, iako Not interested može da snizi limit marketing poruka po korisniku između vas i tog klijenta i otvara drugi ekran s ponudom da se zaustave sve marketing poruke. user_preferences se aktivira tek ako korisnik zatim dodirne stop.
Šta sadrži payload?
Niz user_preferences uz niz contacts, pod nazivom polja user_preferences. Vremenska oznaka je ovde ceo broj, dok statusi šalju svoju kao string. wa_id se izostavlja kada korisnik koristi korisničko ime i ne može da podeli broj telefona, user_id kada korisnički ID-jevi ograničeni na firmu nisu uključeni za vašu firmu, a parent_user_id osim ako roditeljski BSUID-ovi nisu uključeni. Metin primer nastavka:
{
"object": "whatsapp_business_account",
"entry": [
{
"id": "102290129340398",
"changes": [
{
"value": {
"messaging_product": "whatsapp",
"metadata": {
"display_phone_number": "15550783881",
"phone_number_id": "106540352242922"
},
"contacts": [
{
"wa_id": "16505551234",
"user_id": "US.13491208655302741918",
"parent_user_id": "US.ENT.506847293015824"
}
],
"user_preferences": [
{
"wa_id": "16505551234",
"user_id": "US.13491208655302741918",
"parent_user_id": "US.ENT.506847293015824",
"detail": "User requested to resume marketing messages",
"category": "marketing_messages",
"value": "resume",
"timestamp": 1731705721
}
]
},
"field": "user_preferences"
}
]
}
]
}Šta vaš sistem treba da uradi sa zaustavljanjem?
Zabeležite ga uz klijenta i isključite ga iz svakog slanja marketinga dok ne stigne nastavak. Polje detail glasi ili „User requested to stop marketing messages“ ili „User requested to resume marketing messages“, ali kod treba da čita vrednost value.
- Čuvajte preferenciju po BSUID-u i po broju telefona, jer bilo koji od njih može nedostajati u datom događaju.
- Isključite klijenta iz slanja marketing šablona; Meta bi ih ionako odbila sa 131050.
- Primenjujte je samo po klijentu: Meta nikada ne primenjuje preferenciju na nivou roditeljskog BSUID-a.
- Pri nastavku ukinite isključenje, a sopstveni zapis o pristanku čuvajte kako Metina politika o pristanku zahteva.
Šta ako user_preferences nikada ne stigne na vaš server?
Meta ipak primenjuje zaustavljanje, pa vam nedostajući webhook košta neuspelo slanje, a ne kršenje pravila. Kada pošaljete marketing šablon nekome ko je zaustavio poruke, API prihvata zahtev, ali ne šalje poruku, i aktivira webhook statusa failed, sa kodom 131050 i naslovom „Unable to deliver the message. This recipient has chosen to stop receiving marketing messages on WhatsApp from your business“. S tim neuspehom postupajte kao s događajem zaustavljanja: zabeležite ga i obustavite dalja marketing slanja tom klijentu.
Kako ovo funkcioniše na broju povezanom preko easyCoexistence?
user_preferences nije među poljima za koja Meta dozvoljava preusmeravanje odredišta, pa ga Meta isporučuje samo na podrazumevani callback aplikacije koja je pretplaćena na nalog. Za broj povezan preko easyCoexistence, to je aplikacija easyCoexistence, a ona danas nije pretplaćena na user_preferences, pa događaj ne stiže ni na direktno odredište ni na Forward URL. Status neuspeha 131050 stiže, jer putuje preko polja messages.
Ako vaša AI šalje marketing šablone preko send_template, čuvajte listu zaustavljenih u sopstvenom sistemu i proverite je pre slanja: easyCoexistence takvu listu ne čuva.
Česte greške
- Tretiranje Not interested kao zaustavljanja. Ne šalje webhook i ne zaustavlja isporuku, iako može da snizi limit marketing poruka za tog klijenta.
- Vođenje preferencija samo po wa_id-u. Polje nedostaje za klijente s korisničkim imenom čiji broj ne može da se podeli; sačuvajte i BSUID.
- Primena zaustavljanja na sve pod roditeljskim BSUID-om. Meta primenjuje preferencije po korisniku, nikada na roditeljskom nivou.
- Ponovni pokušaj posle 131050 umesto da se zabeleži kao zaustavljanje. Svaki pokušaj ne uspe na isti način.
Marketing šabloni poslati preko njega odlaze sa vašeg naloga WhatsApp Business Account, a neuspeli statusi koji prijavljuju zaustavljenog klijenta stižu na vaš server direktno ili kao potpisani prosleđeni zahtevi. Od US$ 9 do US$ 0.75 po broju mesečno, opadajući kako dodajete brojeve, uz prvih 3 dana besplatno.
Često postavljana pitanja
Da li zaustavljanje blokira i odgovore na sopstvene poruke klijenta?
Metina dokumentacija opisuje zaustavljanje kao obuhvat marketing poruka, a greška koju vraća pominje marketing poruke. Odgovori klijentu koji je pisao vama spadaju u servisne poruke, što je druga kategorija.
Da li blokiranje firme aktivira user_preferences?
Ne. Webhook se aktivira samo pri zaustavljanju i nastavku u podešavanju Offers and announcements. Blokiranje je zasebna radnja i ne prijavljuje se u ovom polju.
Da li se nastavak računa kao pristanak?
To znači da je klijent ponovo izabrao da prima vaše marketing poruke. Vaše sopstvene obaveze pristanka po Metinoj politici i dalje važe, zato čuvajte zapis o tome kako i kada se taj klijent saglasio da od vas čuje.
Na koje webhook polje se pretplaćujem?
user_preferences, u App Dashboard pod WhatsApp > Configuration, na aplikaciji pretplaćenoj na WhatsApp Business Account. To je zasebno polje od messages i zahteva whatsapp_business_management.
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