MasukMulai uji coba gratis
Meta Tech Provider

Webhook user_preferences WhatsApp: saat pelanggan berhenti atau melanjutkan pesan pemasaran

Webhook user_preferences memberi tahu bisnis bahwa pengguna WhatsApp berhenti atau melanjutkan pesan pemasarannya melalui pengaturan Penawaran dan pengumuman. Setiap event membawa kategori marketing_messages, nilai stop atau resume, kalimat detail, wa_id dan BSUID pengguna, serta stempel waktu Unix. Umpan balik Tertarik dan Tidak tertarik di pengaturan yang sama tidak memicunya.

easyCoexistence menghubungkan nomor aplikasi WhatsApp Business Anda ke Cloud API Meta melalui Coexistence, sehingga AI dan otomasi Anda berjalan di nomor yang tetap Anda pakai di aplikasi.

2

Nilai yang dapat diambil sebuah preferensi: stop dan resume, keduanya dalam kategori marketing_messages.

131050

Kode status gagal untuk template pemasaran yang dikirim ke pengguna yang berhenti menerima pesan pemasaran Anda.

Default callback

Ke mana Meta mengirim user_preferences: ini bukan field yang tujuan pengirimannya dapat diganti oleh WhatsApp Business Account atau nomor.

whatsapp_business_management

Izin yang dibutuhkan aplikasi untuk webhook selain messages dan calls, termasuk user_preferences.

Apa yang memicu webhook user_preferences?

Pelanggan membuka Penawaran dan pengumuman di WhatsApp lalu memilih berhenti, atau nanti melanjutkan, menerima pesan pemasaran dari bisnis Anda. Dua tindakan itu satu-satunya pemicu. Pengaturan yang sama juga memungkinkan pelanggan menandai Tertarik atau Tidak tertarik, dan umpan balik itu tidak mengirim webhook, meski Tidak tertarik dapat menurunkan batas pemasaran per pengguna antara Anda dan pelanggan tersebut dan membuka layar kedua yang menawarkan berhenti menerima pesan pemasaran sama sekali. Hanya jika mereka kemudian mengetuk berhenti, user_preferences terpicu.

Apa isi payload?

Array user_preferences di samping array contacts, di bawah nama field user_preferences. Stempel waktunya di sini berupa bilangan bulat, sedangkan webhook status mengirimkannya sebagai string. wa_id dihilangkan saat pelanggan memakai nama pengguna dan nomor teleponnya tidak dapat dibagikan, user_id saat ID pengguna cakupan bisnis tidak diaktifkan untuk bisnis Anda, dan parent_user_id kecuali BSUID induk diaktifkan. Contoh resume dari 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"
        }
      ]
    }
  ]
}

Apa yang harus dilakukan sistem Anda saat ada stop?

Catat untuk pelanggan tersebut dan kecualikan dari setiap pengiriman pemasaran hingga resume masuk. Field detail berbunyi "User requested to stop marketing messages" atau "User requested to resume marketing messages", tetapi yang harus dibaca kode adalah value.

  • Simpan preferensi berdasarkan BSUID dan nomor telepon, karena salah satunya bisa tidak ada pada event tertentu.
  • Kecualikan pelanggan dari pengiriman template pemasaran; Meta tetap akan menolaknya dengan 131050.
  • Terapkan per pelanggan saja: Meta tidak pernah menerapkan preferensi di level BSUID induk.
  • Saat resume, hapus pengecualian, dan simpan catatan persetujuan (opt-in) Anda sendiri sebagaimana diwajibkan kebijakan opt-in Meta.

Bagaimana jika user_preferences tidak pernah sampai ke server Anda?

Meta tetap menerapkan stop, jadi webhook yang hilang hanya berakibat satu pengiriman gagal, bukan pelanggaran kebijakan. Saat Anda mengirim template pemasaran ke seseorang yang sudah berhenti, API menerima permintaan, tidak mengirim pesan, dan memicu webhook status dengan status failed, kode 131050, dan judul "Unable to deliver the message. This recipient has chosen to stop receiving marketing messages on WhatsApp from your business". Perlakukan kegagalan itu persis seperti event stop: catat dan hentikan pengiriman pemasaran lanjutan ke pelanggan tersebut.

Bagaimana ini bekerja pada nomor yang terhubung lewat easyCoexistence?

user_preferences bukan salah satu field yang diizinkan Meta untuk penggantian tujuan, jadi Meta hanya mengirimkannya ke callback default aplikasi yang berlangganan akun tersebut. Untuk nomor yang terhubung lewat easyCoexistence, aplikasi itu milik easyCoexistence, dan saat ini tidak berlangganan user_preferences, sehingga event tidak sampai ke tujuan langsung maupun Forward URL. Status gagal 131050 tetap sampai, karena dikirim lewat field messages.

Jika AI Anda mengirim template pemasaran dengan send_template, simpan daftar stop di sistem Anda sendiri dan periksa daftar itu terlebih dahulu: easyCoexistence tidak menyimpannya.

Kesalahan umum

  • Menganggap Tidak tertarik sebagai stop. Itu tidak mengirim webhook dan tidak menghentikan pengiriman, meski dapat menurunkan batas pemasaran per pengguna untuk pelanggan tersebut.
  • Memakai wa_id saja sebagai kunci preferensi. Field itu dihilangkan untuk pelanggan dengan nama pengguna yang nomornya tidak dapat dibagikan; simpan BSUID juga.
  • Menerapkan stop ke semua orang di bawah BSUID induk. Meta menerapkan preferensi per pengguna, tidak pernah di level induk.
  • Mencoba kembali setelah 131050 alih-alih mencatatnya sebagai stop. Setiap upaya mencoba kembali gagal dengan cara yang sama.
Melakukan ini dengan EasyCoexistence

Template pemasaran yang dikirim lewat layanan ini keluar dari WhatsApp Business Account Anda sendiri, dan status gagal yang melaporkan pelanggan yang berhenti sampai ke server Anda secara langsung atau sebagai forward yang ditandatangani. US$ 9 turun hingga US$ 0.75 per nomor per bulan, terus turun seiring penambahan nomor, dengan 3 hari pertama gratis.

Pertanyaan yang sering diajukan

Apakah stop juga memblokir balasan atas pesan pelanggan sendiri?

Dokumentasi Meta menjelaskan bahwa stop mencakup pesan pemasaran, dan kesalahan yang dikembalikannya menyebut pesan pemasaran. Balasan kepada pelanggan yang menulis kepada Anda adalah pesan layanan, kategori yang berbeda.

Apakah memblokir bisnis memicu user_preferences?

Tidak. Webhook hanya terpicu saat stop dan resume di pengaturan Penawaran dan pengumuman. Memblokir adalah tindakan terpisah dan tidak dilaporkan pada field ini.

Apakah resume dihitung sebagai opt-in?

Artinya pelanggan memilih untuk kembali menerima pesan pemasaran Anda. Kewajiban opt-in Anda sendiri di bawah kebijakan Meta tetap berlaku, jadi simpan catatan kapan dan bagaimana pelanggan itu setuju untuk dihubungi.

Field webhook mana yang harus saya langgani?

user_preferences, di App Dashboard pada WhatsApp > Configuration, di aplikasi yang berlangganan WhatsApp Business Account. Ini field terpisah dari messages dan memerlukan whatsapp_business_management.

Lanjut membaca

Siap memulai?

Konfigurasikan WhatsApp Coexistence dalam hitungan menit, bukan bulan. Aplikasi tetap berfungsi di ponsel.

Mulai uji coba gratis

Diverifikasi pada