Log masukMulakan percubaan percuma
Meta Tech Provider

Webhook user_preferences WhatsApp: apabila pelanggan menghentikan atau menyambung semula mesej pemasaran

Webhook user_preferences memberitahu perniagaan bahawa pengguna WhatsApp telah menghentikan atau menyambung semula mesej pemasarannya melalui tetapan Tawaran dan pengumuman. Setiap peristiwa membawa kategori marketing_messages, nilai stop atau resume, ayat penerangan, wa_id dan BSUID pengguna, serta cap masa Unix. Maklum balas Berminat dan Tidak berminat dalam tetapan yang sama tidak mencetuskannya.

easyCoexistence menyambungkan nombor aplikasi WhatsApp Business anda kepada Cloud API Meta melalui Coexistence, supaya AI dan automasi anda berfungsi pada nombor yang anda simpan dalam aplikasi.

2

Nilai yang boleh dimiliki sesuatu keutamaan: stop dan resume, kedua-duanya dalam kategori marketing_messages.

131050

Kod status gagal bagi template pemasaran yang dihantar kepada pengguna yang telah menghentikan mesej pemasaran anda.

Default callback

Lokasi penghantaran user_preferences oleh Meta: ia bukan medan yang boleh ditimpa oleh WhatsApp Business Account atau nombor.

whatsapp_business_management

Kebenaran yang diperlukan oleh aplikasi untuk webhook selain messages dan calls, termasuk user_preferences.

Apakah yang mencetuskan webhook user_preferences?

Pelanggan membuka Tawaran dan pengumuman dalam WhatsApp dan memilih untuk menghentikan, atau kemudian menyambung semula, mesej pemasaran daripada perniagaan anda. Dua tindakan itu sahaja yang mencetuskannya. Tetapan yang sama juga membolehkan pelanggan menandakan Berminat atau Tidak berminat, dan maklum balas itu tidak menghantar webhook, walaupun Tidak berminat boleh menurunkan had pemasaran bagi setiap pengguna antara anda dan pelanggan itu serta membuka skrin kedua yang menawarkan untuk menghentikan semua mesej pemasaran. Hanya jika mereka kemudian menekan stop, user_preferences dicetuskan.

Apakah yang dimuatkan dalam muatan?

Tatasusunan user_preferences berada di sebelah tatasusunan contacts, di bawah nama medan user_preferences. Cap masa di sini ialah integer, manakala webhook status menghantarnya sebagai string. wa_id tidak disertakan apabila pelanggan menggunakan nama pengguna dan nombor telefonnya tidak boleh dikongsi. user_id tidak disertakan apabila ID pengguna dalam skop perniagaan tidak diaktifkan untuk perniagaan anda. parent_user_id tidak disertakan melainkan BSUID induk diaktifkan. Contoh penyambungan semula oleh Meta:

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

Apakah yang perlu dilakukan oleh sistem anda apabila berlaku henti?

Rekodkan ia terhadap pelanggan dan kecualikan mereka daripada setiap penghantaran pemasaran sehingga peristiwa sambung semula tiba. Medan detail berbunyi sama ada "User requested to stop marketing messages" atau "User requested to resume marketing messages", tetapi medan value ialah yang perlu dibaca oleh kod.

  • Simpan keutamaan mengikut BSUID dan mengikut nombor telefon, kerana salah satunya boleh tiada pada peristiwa tertentu.
  • Kecualikan pelanggan daripada penghantaran template pemasaran; Meta akan menolaknya juga dengan 131050.
  • Gunakan secara setiap pelanggan sahaja: Meta tidak pernah menggunakan keutamaan pada peringkat BSUID induk.
  • Apabila sambung semula, angkat pengecualian, dan simpan rekod opt-in anda sendiri seperti yang dikehendaki oleh dasar opt-in Meta.

Bagaimana jika user_preferences tidak pernah sampai ke pelayan anda?

Meta tetap menguatkuasakan henti itu, jadi webhook yang hilang hanya menyebabkan penghantaran gagal, bukan pelanggaran dasar. Apabila anda menghantar template pemasaran kepada seseorang yang telah berhenti, API menerima permintaan itu, tidak menghantar mesej, dan mencetuskan webhook status dengan status failed, kod 131050 dan tajuk "Unable to deliver the message. This recipient has chosen to stop receiving marketing messages on WhatsApp from your business". Layan kegagalan itu sama seperti peristiwa henti: rekodkan dan sekat penghantaran pemasaran selanjutnya kepada pelanggan itu.

Bagaimana ini berfungsi pada nombor yang disambungkan melalui easyCoexistence?

user_preferences bukan antara medan yang dibenarkan oleh Meta untuk penimpaan destinasi, jadi Meta hanya menghantarnya ke callback lalai aplikasi yang melanggan akaun itu. Bagi nombor yang disambungkan melalui easyCoexistence, aplikasi itu ialah milik easyCoexistence, dan ia tidak melanggan user_preferences buat masa ini, jadi peristiwa itu tidak sampai ke destinasi langsung atau Forward URL. Status gagal 131050 sampai, kerana ia bergerak pada medan messages.

Jika AI anda menghantar template pemasaran melalui send_template, simpan senarai henti dalam sistem anda sendiri dan semak dahulu: easyCoexistence tidak menyimpannya.

Kesilapan biasa

  • Menganggap Tidak berminat sebagai henti. Ia tidak menghantar webhook dan tidak menghentikan penghantaran, walaupun ia boleh menurunkan had pemasaran bagi pelanggan itu.
  • Menyimpan keutamaan hanya mengikut wa_id. Ia ditinggalkan bagi pelanggan yang menggunakan nama pengguna dan nombor mereka tidak boleh dikongsi; simpan BSUID juga.
  • Mengenakan henti kepada semua di bawah BSUID induk. Meta menggunakan keutamaan bagi setiap pengguna, tidak pernah pada peringkat induk.
  • Cuba semula selepas 131050 dan bukannya merekodkannya sebagai henti. Setiap cubaan gagal dengan cara yang sama.
Menggunakan EasyCoexistence untuk ini

Template pemasaran yang dihantar melaluinya keluar daripada WhatsApp Business Account anda sendiri, dan status gagal yang melaporkan pelanggan yang berhenti sampai ke pelayan anda secara langsung atau sebagai penghantaran ke hadapan yang ditandatangani. Daripada US$ 9 hingga US$ 0.75 setiap nombor sebulan, menurun apabila anda menambah nombor, dengan percubaan percuma 3 hari.

Soalan lazim

Adakah henti juga menyekat balasan kepada mesej pelanggan sendiri?

Dokumentasi Meta menerangkan henti sebagai meliputi mesej pemasaran, dan ralat yang dikembalikan menamakan mesej pemasaran. Balasan kepada pelanggan yang menulis kepada anda ialah mesej perkhidmatan, iaitu kategori yang berbeza.

Adakah menyekat perniagaan mencetuskan user_preferences?

Tidak. Webhook hanya dicetuskan oleh henti dan sambung semula dalam tetapan Tawaran dan pengumuman. Menyekat ialah tindakan berasingan dan tidak dilaporkan pada medan ini.

Adakah sambung semula dikira sebagai opt-in?

Ia bermaksud pelanggan memilih untuk menerima mesej pemasaran anda semula. Kewajipan opt-in anda sendiri di bawah dasar Meta masih terpakai, jadi simpan rekod bagaimana dan bila pelanggan itu bersetuju untuk mendengar daripada anda.

Medan webhook yang mana perlu saya langgan?

user_preferences, dalam App Dashboard di bawah WhatsApp > Configuration, pada aplikasi yang melanggan WhatsApp Business Account. Ia medan berasingan daripada messages dan memerlukan whatsapp_business_management.

Teruskan membaca

Sedia untuk bermula?

Sediakan WhatsApp Coexistence dalam beberapa minit, bukan berbulan-bulan. Aplikasi terus berfungsi pada telefon.

Mulakan Percubaan Percuma

Disahkan pada