WhatsApp user_preferences webhook: kapag huminto o nagpatuloy ang customer sa marketing na mensahe
Sinasabi ng user_preferences webhook sa negosyo na huminto o nagpatuloy ang isang WhatsApp user sa pagtanggap ng marketing na mensahe sa pamamagitan ng setting na "Offers and announcements". Bawat event ay may category na marketing_messages, value na stop o resume, isang detalyadong pangungusap, ang wa_id at BSUID ng user, at Unix timestamp. Ang feedback na "Interested" at "Not interested" sa parehong setting ay hindi nagti-trigger nito.
Ikinokonekta ng easyCoexistence ang inyong WhatsApp Business app na numero sa Cloud API ng Meta sa pamamagitan ng Coexistence, kaya gumagana ang inyong AI at automations sa numerong pinapanatili ninyo sa app.
Mga value na maaaring kunin ng preference: stop at resume, parehong nasa marketing_messages category.
Ang failed-status code para sa marketing template na ipinadala sa user na huminto sa marketing na mensahe ng inyong negosyo.
Kung saan ipinapadala ng Meta ang user_preferences: hindi ito field na maaaring i-override ng WhatsApp Business Account o numero.
Ang permission na kailangan ng app para sa webhooks maliban sa messages at calls, kasama ang user_preferences.
Ano ang nagti-trigger ng user_preferences webhook?
Ang customer na nagbukas ng "Offers and announcements" sa WhatsApp at pumili na huminto, o kalaunan ay magpatuloy, sa marketing na mensahe ng negosyo ninyo. Ang dalawang aksyon na iyon lamang ang nagti-trigger. Ang parehong setting ay nagpapahintulot din sa customer na markahan ang "Interested" o "Not interested", at ang feedback na iyon ay hindi nagpapadala ng webhook, bagaman ang "Not interested" ay maaaring magpababa ng per-user marketing limit sa pagitan ninyo ng customer na iyon at nagbubukas ng pangalawang screen na nag-aalok na ihinto nang tuluyan ang marketing na mensahe. Kapag pinindot lamang nila ang stop pagkatapos nito saka lang magpapaputok ang user_preferences.
Ano ang laman ng payload?
Isang user_preferences array sa tabi ng contacts array, sa ilalim ng field name na user_preferences. Ang timestamp dito ay integer, habang string ang timestamp sa status webhooks. Wala ang wa_id kapag gumamit ang customer ng username at hindi maibahagi ang numero ng telepono nila, wala ang user_id kapag hindi naka-enable ang business-scoped user IDs para sa negosyo ninyo, at wala ang parent_user_id maliban kung naka-on ang parent BSUIDs. Ito ang halimbawa ng Meta para sa resume:
{
"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"
}
]
}
]
}Ano ang dapat gawin ng inyong sistema sa stop?
Itala ito laban sa customer at panatilihing wala sa bawat marketing send hanggang dumating ang resume. Ang detail field ay nagbabasa ng alinman sa "User requested to stop marketing messages" o "User requested to resume marketing messages", pero ang value ang dapat basahin ng code.
- Itago ang preference ayon sa BSUID at sa numero ng telepono, dahil maaaring mawala ang alinman sa mga ito sa isang event.
- Ibukod ang customer sa marketing template sends; tatanggihan pa rin sila ng Meta gamit ang 131050.
- Ilapat ito sa bawat customer lamang: hindi kailanman ina-apply ng Meta ang preference sa parent BSUID level.
- Kapag nag-resume, alisin ang pagbubukod, at panatilihin ang sariling opt-in record gaya ng hinihingi ng opt-in policy ng Meta.
Ano ang mangyayari kung hindi kailanman umabot sa inyong server ang user_preferences?
Ipapatupad pa rin ng Meta ang stop, kaya ang nawawalang webhook ay magreresulta sa nabigong send, hindi sa paglabag sa policy. Kapag nagpadala kayo ng marketing template sa taong huminto, tinatanggap ng API ang request, hindi ipinapadala ang mensahe, at nagpapaputok ng status webhook na may status failed, code 131050 at title na "Unable to deliver the message. This recipient has chosen to stop receiving marketing messages on WhatsApp from your business". Tratuhin ang failure na iyon nang eksakto tulad ng stop event: itala ito at pigilan ang mga susunod na marketing send sa customer na iyon.
Paano ito gumagana sa numerong naka-connect sa pamamagitan ng easyCoexistence?
Ang user_preferences ay hindi isa sa mga field na pinapayagan ng Meta na i-override ang destination, kaya ipinapadala lamang ito ng Meta sa default callback ng app na nag-subscribe sa account. Para sa numerong naka-connect sa pamamagitan ng easyCoexistence, ang app na iyon ay sa easyCoexistence, at hindi ito nag-subscribe sa user_preferences ngayon, kaya hindi umaabot sa direct destination o Forward URL ang event. Ang 131050 failed status ay umaabot, dahil dumadaan ito sa messages field.
Kung nagpapadala ang inyong AI ng marketing templates gamit ang send_template, panatilihin ang stop list sa sariling sistema ninyo at suriin ito muna: hindi ito pinapanatili ng easyCoexistence.
Mga karaniwang pagkakamali
- Pagtrato sa Not interested bilang stop. Hindi ito nagpapadala ng webhook at hindi nito pinipigilan ang delivery, bagaman maaari nitong pababain ang per-user marketing limit ng customer na iyon.
- Pag-key ng preferences sa wa_id lamang. Wala ito sa mga customer na may username na hindi maibahagi ang numero; itago rin ang BSUID.
- Pag-apply ng stop sa lahat sa ilalim ng parent BSUID. Ina-apply ng Meta ang preferences bawat user, hindi kailanman sa parent level.
- Pag-retry pagkatapos ng 131050 sa halip na itala ito bilang stop. Pareho ang pagkabigo ng bawat retry.
Ang marketing templates na ipinapadala dito ay lumalabas sa sariling WhatsApp Business Account ninyo, at ang failed statuses na nag-uulat ng customer na huminto ay umaabot sa server ninyo nang direkta o bilang signed forwards. Mula US$ 9 kada naka-connect na numero kada buwan hanggang limang numero, bumababa hanggang US$ 0.75 habang dumarami ang mga numero, na may free trial sa unang 3 araw.
Mga madalas itanong
Hinihinto ba rin ng stop ang pagsagot sa sariling mensahe ng customer?
Inilalarawan ng dokumentasyon ng Meta ang stop bilang sumasaklaw sa marketing messages, at tumutukoy sa marketing messages ang error na ibinabalik nito. Ang mga sagot sa customer na sumulat sa inyo ay service messages, ibang kategorya.
Nagti-trigger ba ng user_preferences ang pag-block sa negosyo?
Hindi. Nagti-trigger lamang ang webhook sa stop at resume sa setting na "Offers and announcements". Ang pag-block ay hiwalay na aksyon at hindi ito iniuulat sa field na ito.
Bilang opt-in ba ang resume?
Ibig sabihin, pinili ng customer na tumanggap muli ng marketing na mensahe mula sa inyo. Nalalapat pa rin ang sariling opt-in obligations ninyo sa ilalim ng policy ng Meta, kaya itala kung paano at kailan sumang-ayon ang customer na makatanggap ng mensahe mula sa inyo.
Aling webhook field ang dapat kong i-subscribe?
user_preferences, sa App Dashboard sa ilalim ng WhatsApp > Configuration, sa app na naka-subscribe sa WhatsApp Business Account. Hiwalay ito sa messages field at nangangailangan ng whatsapp_business_management.
Magpatuloy sa pagbabasa
Handa na po ba kayong magsimula?
I-set up ang WhatsApp Coexistence sa loob ng ilang minuto, hindi buwan. Patuloy na gumagana ang app sa telepono.
Magsimula ng Libreng TrialNa-verify noong