Webhook user_preferences pentru WhatsApp: când un client oprește sau reia mesajele de marketing
Webhook-ul user_preferences anunță o firmă că un utilizator WhatsApp a oprit sau a reluat mesajele sale de marketing prin setarea „Oferte și anunțuri”. Fiecare eveniment conține categoria marketing_messages, valoarea stop sau resume, o propoziție în câmpul detail, identificatorul wa_id și BSUID-ul utilizatorului și un timestamp Unix. Feedbackul Interesat și Nu mă interesează din aceeași setare nu declanșează acest webhook.
easyCoexistence conectează numărul aplicației WhatsApp Business la Cloud API prin Coexistence, astfel încât AI-ul și automatizările dumneavoastră funcționează pe numărul pe care îl păstrați în aplicație.
Valorile pe care le poate lua o preferință: stop și resume, ambele în categoria marketing_messages.
Codul de stare eșuată pentru un template de marketing trimis unui utilizator care a oprit mesajele dumneavoastră de marketing.
Unde trimite Meta user_preferences: nu este un câmp pe care un Cont WhatsApp Business sau un număr să-l poată suprascrie.
Permisiunea de care are nevoie o aplicație pentru webhook-urile altele decât messages și calls, inclusiv user_preferences.
Ce declanșează webhook-ul user_preferences?
Un client care deschide „Oferte și anunțuri” în WhatsApp și alege să oprească, sau mai târziu să reia, mesajele de marketing de la firma dumneavoastră. Doar aceste două acțiuni declanșează webhook-ul. Aceeași setare permite clientului să marcheze Interesat sau Nu mă interesează, iar acest feedback nu trimite niciun webhook, deși Nu mă interesează poate reduce limita de mesaje de marketing per utilizator dintre dumneavoastră și acel client și deschide un al doilea ecran care oferă oprirea completă a mesajelor de marketing. Doar dacă apasă apoi pe oprire se activează user_preferences.
Ce conține payload-ul?
Un array user_preferences alături de un array contacts, sub numele de câmp user_preferences. Timestamp-ul de aici este un număr întreg, în timp ce webhook-urile de status îl trimit ca șir de caractere. wa_id lipsește când clientul folosește un username și numărul său de telefon nu poate fi partajat, user_id când ID-urile de utilizator la nivel de firmă nu sunt activate pentru firma dumneavoastră și parent_user_id dacă BSUID-urile părinte nu sunt activate. Iată exemplul Meta pentru o reluare:
{
"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"
}
]
}
]
}Ce ar trebui să facă sistemul dumneavoastră la o oprire?
Înregistrați oprirea pe numele clientului și țineți-l în afara fiecărui trimis de marketing până la sosirea unei reluări. Câmpul detail afișează fie „User requested to stop marketing messages”, fie „User requested to resume marketing messages”, dar codul trebuie să citească value.
- Salvați preferința după BSUID și după numărul de telefon, deoarece oricare dintre ele poate lipsi la un anumit eveniment.
- Excludeți clientul din trimiterile de template-uri de marketing; Meta le-ar refuza oricum cu 131050.
- Aplicați preferința doar per client: Meta nu aplică niciodată o preferință la nivelul BSUID-ului părinte.
- La reluare, ridicați excluderea și păstrați propria evidență de consimțământ opt-in, cum cere politica Meta pentru opt-in.
Ce se întâmplă dacă user_preferences nu ajunge niciodată la serverul dumneavoastră?
Meta aplică oprirea oricum, așa că un webhook lipsă vă costă o trimitere eșuată, nu o încălcare a politicii. Când trimiteți un template de marketing cuiva care a oprit mesajele, API-ul acceptă cererea, nu trimite mesajul și declanșează un webhook de status cu status failed, codul 131050 și titlul „Unable to deliver the message. This recipient has chosen to stop receiving marketing messages on WhatsApp from your business”. Tratați acest eșec exact ca pe un eveniment de oprire: înregistrați-l și suprimați trimiterile de marketing ulterioare către acel client.
Cum funcționează asta pe un număr conectat prin easyCoexistence?
user_preferences nu face parte din câmpurile pentru care Meta permite suprascrierea destinației, deci Meta îl livrează doar la callback-ul implicit al aplicației abonate la cont. Pentru un număr conectat prin easyCoexistence, această aplicație este cea a easyCoexistence, iar ea nu se abonează astăzi la user_preferences, deci evenimentul nu ajunge nici la o destinație directă, nici la un Forward URL. Statusul eșuat cu codul 131050 ajunge, pentru că circulă pe câmpul messages.
Dacă AI-ul dumneavoastră trimite template-uri de marketing prin send_template, păstrați lista de opriri în sistemul propriu și verificați-o mai întâi: easyCoexistence nu ține una.
Greșeli frecvente
- Tratarea lui Nu mă interesează ca pe o oprire. Nu trimite niciun webhook și nu oprește livrarea, deși poate reduce limita de marketing per utilizator pentru acel client.
- Ținerea evidenței doar după wa_id. Acesta lipsește pentru clienții cu un username al cărui număr nu poate fi partajat; stocați și BSUID-ul.
- Aplicarea unei opriri tuturor celor de sub un BSUID părinte. Meta aplică preferințele per utilizator, niciodată la nivel părinte.
- Reîncercarea după 131050 în loc să înregistrați eroarea ca oprire. Fiecare reîncercare eșuează în același fel.
Template-urile de marketing trimise prin el pleacă din propriul dumneavoastră WhatsApp Business Account, iar statusurile eșuate care raportează un client oprit ajung la serverul dumneavoastră direct sau ca redirecționări semnate. De la US$ 9 per număr conectat pe lună, până la US$ 0,75 pe măsură ce adăugați numere, cu primele 3 zile gratuite.
Întrebări frecvente
Oprirea blochează și răspunsurile la mesajele proprii ale clientului?
Documentația Meta descrie oprirea ca acoperind mesajele de marketing, iar eroarea pe care o returnează menționează mesajele de marketing. Răspunsurile către un client care v-a scris sunt mesaje de serviciu, o categorie diferită.
Blocarea firmei declanșează user_preferences?
Nu. Webhook-ul se declanșează doar la oprire și reluare în setarea „Oferte și anunțuri”. Blocarea este o acțiune separată și nu este raportată pe acest câmp.
Reluarea contează ca opt-in?
Înseamnă că clientul a ales să primească din nou mesajele dumneavoastră de marketing. Obligațiile dumneavoastră proprii de opt-in conform politicii Meta rămân valabile, așa că păstrați evidența despre cum și când acel client a fost de acord să fie contactat de dumneavoastră.
La ce câmp webhook mă abonez?
La user_preferences, în App Dashboard, la WhatsApp > Configurare, pe aplicația abonată la WhatsApp Business Account. Este un câmp separat de messages și necesită whatsapp_business_management.
Continuați să citiți
Gata să începeți?
Configurați WhatsApp Coexistence în câteva minute, nu luni. Aplicația continuă să funcționeze pe telefon.
Începeți perioada de probă gratuităVerificat la