Kirjaudu sisäänAloita ilmainen kokeilu
Meta Tech Provider

WhatsApp user_preferences -webhook: kun asiakas lopettaa tai jatkaa markkinointiviestit

user_preferences-webhook kertoo yritykselle, että WhatsApp-käyttäjä lopetti tai jatkoi markkinointiviestien vastaanottamisen asetuksesta ”Tarjoukset ja ilmoitukset”. Jokainen tapahtuma sisältää kategorian marketing_messages, arvon stop tai resume, selitteen, käyttäjän wa_id:n ja BSUID:n sekä Unix-aikaleiman. Saman asetuksen ”Kiinnostunut” ja ”Ei kiinnostunut” -palaute ei laukaise sitä.

easyCoexistence yhdistää WhatsApp Business -sovelluksesi numeron Metan Cloud API -rajapintaan Coexistencen kautta, joten tekoälysi ja automaatiosi toimivat sovelluksessa pitämäsi numeron kanssa.

2

Arvot, jotka asetus voi saada: stop ja resume, molemmat kategoriassa marketing_messages.

131050

Epäonnistuneen tilan koodi, kun markkinoinnin viestipohja lähetetään käyttäjälle, joka on lopettanut markkinointiviestisi.

Default callback

Minne Meta lähettää user_preferences: kenttää ei voi ohittaa WhatsApp Business -tilillä tai numerolla.

whatsapp_business_management

Oikeus, jonka sovellus tarvitsee muihin webhookeihin kuin messages- ja calls-kenttiin, user_preferences mukaan lukien.

Mikä laukaisee user_preferences-webhookin?

Asiakas avaa WhatsAppissa asetuksen ”Tarjoukset ja ilmoitukset” ja valitsee lopettaa markkinointiviestit yritykseltäsi tai myöhemmin jatkaa niitä. Nämä kaksi toimintoa ovat ainoat laukaisijat. Saman asetuksen kautta asiakas voi merkitä myös ”Kiinnostunut” tai ”Ei kiinnostunut”, eikä tuo palaute lähetä webhookia. Ei kiinnostunut voi kuitenkin laskea käyttäjäkohtaista markkinointirajaa teidän välillänne ja avata toisen näytön, joka tarjoaa markkinoinnin kokonaan lopettamista. Vasta jos asiakas tämän jälkeen napauttaa lopetusta, user_preferences laukeaa.

Mitä payload sisältää?

Hyötykuormassa on user_preferences-taulukko contacts-taulukon rinnalla, kentän nimen user_preferences alla. Aikaleima on tässä kokonaisluku, kun taas tilan webhookit lähettävät sen merkkijonona. wa_id jää pois, kun asiakas käyttää käyttäjätunnusta eikä puhelinnumeroa voi jakaa. user_id jää pois, kun yrityskohtaiset käyttäjätunnukset eivät ole käytössä yrityksellesi, ja parent_user_id jää pois, ellei parent BSUID:t ole päällä. Metan esimerkki jatkamisesta:

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"
        }
      ]
    }
  ]
}

Mitä järjestelmäsi tekee pysäytyksen kanssa?

Tallenna se asiakkaan kohdalle ja pidä asiakas pois kaikista markkinointilähetyksistä, kunnes jatkaminen saapuu. Kenttä detail kertoo joko ”User requested to stop marketing messages” tai ”User requested to resume marketing messages”, mutta koodin pitää lukea value.

  • Tallenna asetus BSUID:n ja puhelinnumeron mukaan, koska kumpi tahansa voi puuttua tietystä tapahtumasta.
  • Jätä asiakas pois markkinointipohjien lähetyksistä, sillä Meta hylkäisi ne joka tapauksessa virheellä 131050.
  • Sovella asetus vain asiakaskohtaisesti: Meta ei koskaan sovella sitä parent BSUID -tasolla.
  • Jatkamisen kohdalla poista rajaus, mutta säilytä oma suostumustietosi, sillä Metan suostumuskäytäntö vaatii sitä.

Entä jos user_preferences ei koskaan saavu palvelimellesi?

Meta panee pysäytyksen joka tapauksessa täytäntöön, joten puuttuva webhook maksaa sinulle epäonnistuneen lähetyksen, ei käytäntörikkomusta. Kun lähetät markkinointipohjan henkilölle, joka on lopettanut, API hyväksyy pyynnön, mutta ei lähetä viestiä. Se käynnistää tilan webhookin, jonka tila on failed, koodi 131050 ja otsikko ”Unable to deliver the message. This recipient has chosen to stop receiving marketing messages on WhatsApp from your business”. Käsittele tämä virhe täsmälleen kuten pysäytystapahtuma: tallenna se ja estä markkinointilähetykset kyseiselle asiakkaalle.

Miten tämä toimii easyCoexistencen kautta yhdistetyssä numerossa?

user_preferences ei kuulu kenttiin, joihin Meta sallii kohdeohituksen, joten Meta toimittaa sen vain tilin tilanneen sovelluksen oletusmäärityksen mukaiseen takaisinkutsuun. Numerolla, joka on yhdistetty easyCoexistencen kautta, tuo sovellus on easyCoexistencen, eikä se tilaa user_preferences-kenttää tällä hetkellä. Tapahtuma ei siis tavoita suoraa kohdetta eikä Forward URL -osoitetta. 131050-virhe sen sijaan tavoittaa, koska se kulkee messages-kentässä.

Jos tekoälysi lähettää markkinointipohjia send_templatella, pidä pysäytyslista omassa järjestelmässäsi ja tarkista se ensin: easyCoexistence ei ylläpidä sellaista.

Yleiset virheet

  • Ei kiinnostunut -palautteen käsittely pysäytyksenä. Se ei lähetä webhookia eikä pysäytä toimitusta, vaikka se voi laskea asiakkaan markkinointirajaa.
  • Asetusten tallentaminen pelkän wa_id:n varaan. Se jää pois asiakkailta, joilla on käyttäjätunnus eikä numeroa voi jakaa, joten tallenna myös BSUID.
  • Pysäytyksen soveltaminen kaikkiin parent BSUID:n alla oleviin. Meta soveltaa asetuksia käyttäjäkohtaisesti, ei koskaan parent-tasolla.
  • Uudelleenyritys 131050-virheen jälkeen pysäytyksen kirjaamisen sijaan. Jokainen yritys epäonnistuu samalla tavalla.
Näin teet tämän EasyCoexistencen avulla

Sen kautta lähetetyt markkinointipohjat lähtevät omalta WhatsApp Business -tililtäsi, ja pysäytetyn asiakkaan ilmoittavat epäonnistuneet tilat tavoittavat palvelimesi suoraan tai allekirjoitettuina välityksinä. US$ 9:stä US$ 0.75:een numeroa kohden kuukaudessa, hinta laskee numeroita lisätessäsi, ja ensimmäiset 3 päivää ovat ilmaista kokeilua.

Usein kysytyt kysymykset

Estääkö pysäytys myös vastaukset asiakkaan omiin viesteihin?

Metan dokumentaatio kuvaa pysäytyksen kattavan markkinointiviestit, ja palautettu virhe nimeää markkinointiviestit. Vastaukset asiakkaalle, joka kirjoitti sinulle, ovat palveluviestejä, eli eri luokka.

Laukaiseeko yrityksen estäminen user_preferences-webhookin?

Ei. Webhook laukeaa vain pysäytyksestä ja jatkamisesta asetuksessa ”Tarjoukset ja ilmoitukset”. Estäminen on erillinen toiminto, eikä sitä raportoida tässä kentässä.

Lasketaanko jatkaminen suostumukseksi?

Se tarkoittaa, että asiakas valitsi vastaanottaa markkinointiviestisi taas. Metan käytännön mukaiset suostumusvelvoitteesi pätevät silti, joten säilytä tieto siitä, miten ja milloin asiakas suostui kuulemaan sinulta.

Mihin webhook-kenttään tilaan?

user_preferences, App Dashboardissa kohdassa WhatsApp > Configuration, sovelluksessa, joka on tilattu WhatsApp Business -tilille. Se on erillinen kenttä messages-kentästä ja vaatii oikeuden whatsapp_business_management.

Lue lisää

Valmis aloittamaan?

Ota WhatsApp Coexistence käyttöön minuuteissa, ei kuukausissa. Sovellus toimii edelleen puhelimessa.

Aloita ilmainen kokeilu

Vahvistettu