IngiaAnza kipindi cha majaribio bila malipo
Meta Tech Provider

Webhook ya user_preferences ya WhatsApp: mteja anapoacha au kuanza tena ujumbe wa masoko

Webhook ya user_preferences humjulisha biashara kwamba mtumiaji wa WhatsApp amesimamisha au kuanza tena ujumbe wa masoko kupitia mpangilio wa Ofa na matangazo. Kila tukio lina kategoria marketing_messages, thamani ya stop au resume, sentensi ya maelezo, wa_id na BSUID ya mtumiaji, pamoja na muhuri wa muda wa Unix. Maoni ya Nimevutiwa na Sivutiwi katika mpangilio huo hayachochei webhook hii.

easyCoexistence inaunganisha nambari yako ya programu ya WhatsApp Business na Cloud API ya Meta kupitia Coexistence, ili AI yako na otomatiki zifanye kazi kwenye nambari unayoweka kwenye programu.

2

Thamani ambazo mapendeleo yanaweza kuchukua: stop na resume, zote katika kategoria marketing_messages.

131050

Msimbo wa hali iliyoshindwa kwa template ya masoko iliyotumwa kwa mtumiaji aliyesimamisha ujumbe wako wa masoko.

Default callback

Meta hutuma user_preferences kwa njia ipi: ni sehemu ambayo WhatsApp Business Account au nambari haziwezi kubatilisha.

whatsapp_business_management

Ruhusa ambayo programu inahitaji kwa webhook zisizo za messages na calls, ikiwemo user_preferences.

Ni nini kinachoanzisha webhook ya user_preferences?

Mteja anapofungua Ofa na matangazo katika WhatsApp na kuchagua kusimamisha, au baadaye kuanza tena, ujumbe wa masoko kutoka kwa biashara yako. Vitendo hivyo viwili pekee ndivyo vinavyoanzisha webhook. Mpangilio huo huo pia humruhusu mteja kuweka Nimevutiwa au Sivutiwi, na maoni hayo hayatumi webhook yoyote. Hata hivyo, kuchagua Sivutiwi kunaweza kupunguza kikomo cha ujumbe wa masoko kwa kila mtumiaji kati yenu, na inafungua skrini ya pili inayotoa kusimamisha kabisa ujumbe wote wa masoko. Ni pale tu mteja anapogusa kusimamisha ndipo user_preferences hutumwa.

Payload ina nini?

Ndani ya payload kuna orodha ya user_preferences pamoja na orodha ya contacts. Muhuri wa muda hapa ni nambari kamili, ilhali webhook za hali huutuma kama mfuatano wa herufi. wa_id huachwa wakati mteja anatumia jina la mtumiaji na nambari yake ya simu haiwezi kushirikiwa, user_id huachwa wakati user IDs zilizofungwa kwenye biashara hazijawashwa kwa biashara yako, na parent_user_id huachwa isipokuwa parent BSUIDs zimewashwa. Mfano wa Meta wa kuanza tena:

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

Mfumo wako unapaswa kufanya nini na kusimamisha?

Rekodi kwa mteja huyo na umtenge na kila utumaji wa masoko hadi tukio la kuanza tena lifike. Sehemu ya detail husoma mojawapo ya sentensi mbili: ile inayosema mtumiaji ameomba kusimamisha ujumbe wa masoko, au ile inayosema ameomba kuanza tena. Lakini msimbo wako unapaswa kusoma thamani ya value.

  • Hifadhi mapendeleo kwa BSUID na kwa nambari ya simu, kwa sababu yoyote kati ya hizo inaweza kukosekana kwenye tukio fulani.
  • Mtenge mteja kutoka kwenye utumaji wa template ya masoko; Meta ingemkatalia hata hivyo kwa 131050.
  • Tumia mapendeleo kwa mteja mmoja mmoja pekee: Meta haitumii mapendeleo kamwe katika ngazi ya parent BSUID.
  • Kuanza tena kukifika, ondoa kutengwa, na uhifadhi rekodi yako mwenyewe ya idhini kama sera ya Meta ya opt-in inavyotaka.

Nini hutokea kama user_preferences haifiki kwenye server yako?

Meta bado inatekeleza kusimamisha, kwa hiyo webhook inayokosekana inakugharimu utumaji ulioshindwa, si ukiukaji wa sera. Unapotuma template ya masoko kwa mtu aliyesimamisha, API inakubali ombi, haitumi ujumbe, na inaanzisha webhook ya hali ya failed, msimbo 131050 na kichwa kinachoeleza kwamba ujumbe haukuweza kufikishwa kwa sababu mpokeaji amechagua kusimamisha ujumbe wa masoko kutoka kwa biashara hii kwenye WhatsApp. Shughulikia kushindwa huko kama tukio la kusimamisha kabisa: rekodi, kisha zuia utumaji wowote zaidi wa masoko kwa mteja huyo.

Inafanyaje kazi kwenye nambari iliyounganishwa kupitia easyCoexistence?

user_preferences si mojawapo ya sehemu ambazo Meta inaruhusu kubatilisha lengwa, kwa hiyo Meta inaituma tu kwenye callback ya kawaida ya programu iliyojisajili kwenye WhatsApp Business Account hiyo. Kwa nambari iliyounganishwa kupitia easyCoexistence, programu hiyo ni ya easyCoexistence, na kwa sasa haijajisajili kwa user_preferences, kwa hiyo tukio halifiki lengwa la moja kwa moja wala Forward URL. Hali ya 131050 inafika, kwa sababu inasafiri kupitia sehemu ya messages.

Ikiwa AI yako inatuma template za masoko kwa send_template, weka orodha ya kusimamisha kwenye mfumo wako mwenyewe na uikague kwanza: easyCoexistence haitunzi orodha hiyo.

Makosa ya kawaida

  • Kuchukulia Kipengele cha Sivutiwi kama kusimamisha. Hakituma webhook, hakisimamishi utumaji, lakini kinaweza kupunguza kikomo cha ujumbe wa masoko kwa mteja huyo.
  • Kuhifadhi mapendeleo kwa wa_id pekee. Huachwa kwa wateja wenye jina la mtumiaji ambao nambari yao haiwezi kushirikiwa; hifadhi pia BSUID.
  • Kutumia kusimamisha kwa kila mtu chini ya parent BSUID. Meta hutumia mapendeleo kwa mtumiaji mmoja mmoja, si katika ngazi ya mzazi.
  • Kujaribu tena baada ya 131050 badala ya kuirekodi kama kusimamisha. Kila jaribio linashindwa kwa namna ile ile.
Kufanya hili ukitumia EasyCoexistence

Template za masoko zinazotumwa kupitia hiyo hutoka kwenye WhatsApp Business Account yako mwenyewe, na hali zilizoshindwa zinazoripoti mteja aliyesimamisha hufika kwenye server yako moja kwa moja au kama forward zilizosainiwa. Kuanzia US$ 9 kwa kila nambari iliyounganishwa kwa mwezi hadi US$ 0.75 kadri unavyoongeza nambari, na siku 3 za kwanza bila malipo.

Maswali yanayoulizwa mara kwa mara

Je, kusimamisha pia kunazuia majibu kwa ujumbe ambao mteja mwenyewe aliandika?

Nyaraka za Meta zinaeleza kwamba kusimamisha kunahusu ujumbe wa masoko, na hitilafu inayorejeshwa inataja ujumbe wa masoko. Majibu kwa mteja aliyekuandikia ni ujumbe wa huduma, kundi tofauti.

Je, mteja akizuia biashara yako, hilo linachochea user_preferences?

Hapana. Webhook huchochewa tu na kusimamisha na kuanza tena katika mpangilio wa Ofa na matangazo. Kuzuia ni kitendo tofauti na hakuripotiwi kwenye sehemu hii.

Je, kuanza tena kunahesabiwa kama opt-in?

Kunamaanisha mteja amechagua kupokea tena ujumbe wako wa masoko. Wajibu wako wa opt-in chini ya sera ya Meta bado unatumika, kwa hiyo weka rekodi ya jinsi na lini mteja huyo alikubali kusikia kutoka kwako.

Ni sehemu ipi ya webhook ninayojisajili?

user_preferences, kwenye App Dashboard chini ya WhatsApp > Usanidi, kwenye programu iliyojisajili kwenye WhatsApp Business Account. Ni sehemu tofauti na messages, na inahitaji whatsapp_business_management.

Endelea kusoma

Uko tayari kuanza?

Sanidi WhatsApp Coexistence kwa dakika chache, si miezi. Programu inaendelea kufanya kazi kwenye simu.

Anza kipindi cha majaribio bila malipo

Imethibitishwa kwenye