Prijavite seZapočnite besplatno probno razdoblje
Meta Tech Provider

WhatsApp user_preferences webhook: kada kupac zaustavi ili nastavi marketinške poruke

Webhook user_preferences obavještava tvrtku da je korisnik u WhatsAppu zaustavio ili nastavio primati njezine marketinške poruke putem postavke Offers and announcements. Svaki događaj sadrži kategoriju marketing_messages, vrijednost stop ili resume, opisnu rečenicu, wa_id i BSUID korisnika te Unix vremensku oznaku. Ocjene Interested i Not interested u istoj postavci ne pokreću ovaj webhook.

easyCoexistence povezuje vaš broj iz aplikacije WhatsApp Business s Metinim Cloud API-jem putem Coexistencea, pa vaša AI i automatizacije rade na broju koji zadržavate u aplikaciji.

2

Vrijednosti koje preferencija može poprimiti: stop i resume, obje u kategoriji marketing_messages.

131050

Kôd statusa neuspjeha za predložak marketinške poruke poslan korisniku koji je zaustavio marketinške poruke.

Default callback

Kamo Meta šalje user_preferences: to nije polje koje WhatsApp Business Account ili broj mogu nadjačati.

whatsapp_business_management

Dopuštenje koje aplikacija treba za webhookove osim messages i calls, uključujući user_preferences.

Što pokreće webhook user_preferences?

Kupac koji u WhatsAppu otvori Offers and announcements i odabere zaustaviti, ili kasnije nastaviti, primanje marketinških poruka vaše tvrtke. Te dvije radnje jedine su okidači. Ista postavka omogućuje kupcu da označi Interested ili Not interested, a ta povratna informacija ne šalje webhook. Ipak, Not interested može sniziti ograničenje marketinških poruka po korisniku između vas i tog kupca te otvara drugi ekran koji nudi zaustavljanje svih marketinških poruka. Tek ako tada odabere zaustavljanje, pokreće se user_preferences.

Što sadrži payload?

Polje user_preferences, pored polja contacts, sadrži niz user_preferences. Vremenska oznaka ovdje je integer, dok status webhookovi šalju svoju kao string. wa_id izostaje kad kupac koristi korisničko ime i ne može podijeliti broj telefona, user_id kad poslovno ograničeni ID-jevi korisnika nisu uključeni za vašu tvrtku, a parent_user_id osim ako roditeljski BSUID-ovi nisu uključeni. Evo Metinog primjera nastavka:

Meta's example: a customer resumes marketing messages
{
  "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"
        }
      ]
    }
  ]
}

Što vaš sustav treba napraviti sa zaustavljanjem?

Zabilježite ga uz kupca i isključite ga iz svakog marketinškog slanja dok ne stigne nastavak. Polje detail glasi ili „User requested to stop marketing messages” ili „User requested to resume marketing messages”, ali kôd treba čitati vrijednost value.

  • Spremite preferenciju po BSUID-u i po broju telefona, jer jedno od to dvoje može nedostajati u pojedinom događaju.
  • Isključite kupca iz slanja marketinških predložaka; Meta bi ih ionako odbila s 131050.
  • Primjenjujte je samo po kupcu: Meta nikad ne primjenjuje preferenciju na razini roditeljskog BSUID-a.
  • Kad stigne nastavak, ukinite isključenje, a vlastitu evidenciju pristanka zadržite jer to zahtijevaju Metina pravila o pristanku.

Što ako user_preferences nikad ne stigne na vaš poslužitelj?

Meta svejedno provodi zaustavljanje, pa izostali webhook znači neuspjelo slanje, a ne kršenje pravila. Kad pošaljete marketinški predložak nekome tko je zaustavio poruke, API prihvaća zahtjev, ne šalje poruku i pokreće status webhook sa statusom failed, kodom 131050 i naslovom „Unable to deliver the message. This recipient has chosen to stop receiving marketing messages on WhatsApp from your business”. Takav neuspjeh tretirajte točno kao događaj zaustavljanja: zabilježite ga i obustavite daljnja marketinška slanja tom kupcu.

Kako to funkcionira kad je broj povezan preko easyCoexistence?

user_preferences nije jedno od polja za koja Meta dopušta nadjačavanje odredišta, pa ga Meta isporučuje samo na zadani callback aplikacije koja je pretplaćena na račun. Za broj koji je povezan kroz easyCoexistence, ta aplikacija je easyCoexistence, a ona se danas ne pretplaćuje na user_preferences, pa događaj ne stiže ni na izravno odredište ni na Forward URL. Neuspjeli status 131050 hoće stići, jer putuje poljem messages.

Ako vaša AI šalje marketinške predloške putem send_template, prvo provjerite vlastiti popis zaustavljanja, jer easyCoexistence takav popis ne vodi.

Uobičajene pogreške

  • Tretiranje Not interested kao zaustavljanja. Ne šalje webhook i ne zaustavlja isporuku, iako može sniziti ograničenje po korisniku za tog kupca.
  • Vođenje preferencija samo po wa_id-u. Polje izostaje kod kupaca s korisničkim imenom čiji broj nije moguće podijeliti; spremite i BSUID.
  • Primjena zaustavljanja na sve pod roditeljskim BSUID-om. Meta primjenjuje preferencije po korisniku, nikad na razini roditelja.
  • Ponovno slanje nakon 131050 umjesto bilježenja kao zaustavljanja. Svaki pokušaj ne uspijeva na isti način.
Radite ovo uz EasyCoexistence

Marketinški predlošci poslani kroz nju idu s vašeg WhatsApp Business Accounta, a neuspjeli statusi koji javljaju o zaustavljenom kupcu stižu na vaš poslužitelj izravno ili kao potpisani prosljeđeni zahtjevi. Od US$ 9 do US$ 0,75 po broju mjesečno, uz pad kako dodajete brojeve, s prva 3 dana besplatno.

Često postavljana pitanja

Blokira li zaustavljanje i odgovore na vlastite poruke kupca?

Metina dokumentacija opisuje zaustavljanje kao obuhvat marketinških poruka, a greška koju vraća navodi marketinške poruke. Odgovori kupcu koji je pisao vama su servisne poruke, druga kategorija.

Pokreće li blokiranje tvrtke user_preferences?

Ne. Webhook se pokreće samo na zaustavljanje i nastavak u postavci Offers and announcements. Blokiranje je zasebna radnja i ne prijavljuje se u ovom polju.

Računa li se nastavak kao pristanak?

Znači da je kupac ponovno odlučio primati vaše marketinške poruke. Vaše vlastite obveze pristanka prema Metinim pravilima i dalje vrijede, pa čuvajte zapis o tome kako i kada se kupac pristao na primanje poruka od vas.

Na koje webhook polje se pretplaćujem?

user_preferences, u App Dashboardu pod WhatsApp > Configuration, na aplikaciji pretplaćenoj na WhatsApp Business Account. To je zasebno polje od messages i zahtijeva whatsapp_business_management.

Nastavite čitati

Spremni za početak?

Postavite WhatsApp Coexistence u nekoliko minuta, a ne mjeseci. Aplikacija i dalje radi na telefonu.

Započnite besplatno probno razdoblje

Provjereno na