Giriş yapınÜcretsiz denemeyi başlatın
Meta Tech Provider

WhatsApp user_preferences webhook'u: müşteri pazarlama mesajlarını durdurduğunda ya da yeniden açtığında

user_preferences webhook'u, bir WhatsApp kullanıcısının Teklifler ve duyurular ayarı üzerinden pazarlama mesajlarını durdurduğunu ya da yeniden açtığını işletmeye bildirir. Her olay, marketing_messages kategorisini, stop ya da resume değerini, bir açıklama cümlesini, kullanıcının wa_id ve BSUID bilgisini ile bir Unix zaman damgasını taşır. Aynı ayardaki İlgileniyorum ve İlgilenmiyorum geri bildirimleri bu webhook'u tetiklemez.

easyCoexistence, WhatsApp Business uygulamanızdaki numarayı Coexistence üzerinden Meta'nın Cloud API'sine bağlar; böylece AI'nız ve otomasyonlarınız uygulamada tuttuğunuz numarada çalışır.

2

Bir tercihin alabileceği değerler: stop ve resume, ikisi de marketing_messages kategorisinde.

131050

Pazarlama mesajlarınızı durdurmuş bir kullanıcıya gönderilen pazarlama şablonunun başarısız durum kodu.

Default callback

Meta user_preferences bildirimini nereye gönderir: bu, bir WhatsApp Business Hesabının ya da numaranın geçersiz kılabileceği bir alan değildir.

whatsapp_business_management

user_preferences dahil, messages ve calls dışındaki webhook'lar için uygulamanın ihtiyaç duyduğu izin.

user_preferences webhook'unu ne tetikler?

Müşterinin WhatsApp'ta Teklifler ve duyurular ayarını açıp işletmenizden gelen pazarlama mesajlarını durdurmayı ya da daha sonra yeniden açmayı seçmesi. Bu iki eylem tek tetikleyicidir. Aynı ayarda müşteri İlgileniyorum ya da İlgilenmiyorum da işaretleyebilir. Bu geri bildirim webhook göndermez, ancak İlgilenmiyorum, o müşteri ile aranızdaki kullanıcı başına pazarlama limitini düşürebilir ve pazarlama mesajlarını tamamen durdurmayı öneren ikinci bir ekran açar. user_preferences ancak müşteri bu ekranda durdurmayı seçerse tetiklenir.

Payload neleri içerir?

Alan adı user_preferences olan bir user_preferences dizisi, contacts dizisinin yanında yer alır. Buradaki zaman damgası tam sayıdır, oysa durum webhook'ları bunu metin olarak gönderir. wa_id, müşteri bir kullanıcı adı kullanıyorsa ve telefon numarası paylaşılamıyorsa atlanır. user_id, işletmeniz için işletmeye özgü kullanıcı kimlikleri etkin değilse atlanır. parent_user_id ise üst BSUID'ler açık değilse atlanır. Meta'nın bir devam etme olayına ait örneği:

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

Durdurma geldiğinde sisteminiz ne yapmalı?

Kaydı müşteriye bağlayın ve devam etme olayı gelene kadar her pazarlama gönderiminin dışında tutun. detail alanı "User requested to stop marketing messages" ya da "User requested to resume marketing messages" metnini taşır, ancak kodunuzun okuması gereken değer value'dur.

  • Tercihi hem BSUID hem telefon numarasıyla saklayın, çünkü bir olayda ikisinden biri eksik olabilir.
  • Müşteriyi pazarlama şablonu gönderimlerinden çıkarın; Meta zaten 131050 ile reddederdi.
  • Tercihi yalnızca müşteri bazında uygulayın, Meta hiçbir zaman tercihi üst BSUID düzeyinde uygulamaz.
  • Devam etme gelince dışlamayı kaldırın, ancak Meta'nın opt-in politikasının gerektirdiği kendi opt-in kaydınızı tutmaya devam edin.

user_preferences sunucunuza hiç ulaşmazsa ne olur?

Meta durdurmayı yine de uygular; eksik webhook size başarısız bir gönderim maliyeti çıkarır, bir politika ihlali değil. Durdurmuş birine pazarlama şablonu gönderdiğinizde API isteği kabul eder, mesajı göndermez ve status değeri failed, kod 131050 ve "Unable to deliver the message. This recipient has chosen to stop receiving marketing messages on WhatsApp from your business" başlığı olan bir durum webhook'u tetikler. Bu hatayı tam olarak bir durdurma olayı gibi ele alın: kaydedin ve o müşteriye yapılacak pazarlama gönderimlerini bastırın.

easyCoexistence üzerinden bağlanan bir numarada bu nasıl işler?

user_preferences, Meta'nın hedef geçersiz kılmasına izin verdiği alanlardan biri değildir. Bu yüzden Meta bunu yalnızca hesaba abone olan uygulamanın varsayılan geri çağırma adresine iletir. easyCoexistence üzerinden bağlanan bir numara için bu uygulama easyCoexistence'ın uygulamasıdır ve bugün user_preferences'a abone olmaz. Dolayısıyla olay doğrudan bir hedefe ya da Forward URL'ye ulaşmaz. 131050 başarısız durumu ise messages alanı üzerinden iletildiği için ulaşır.

AI'nız pazarlama şablonlarını send_template ile gönderiyorsa, durdurma listesini kendi sisteminizde tutun ve göndermeden önce orada kontrol edin: easyCoexistence böyle bir liste tutmaz.

Yaygın hatalar

  • İlgilenmiyorum'u durdurma sanmak. Webhook göndermez ve teslimatı durdurmaz, ancak o müşteri için kullanıcı başına pazarlama limitini düşürebilir.
  • Tercihleri yalnızca wa_id ile anahtarlamak. Telefon numarası paylaşılamayan kullanıcı adlı müşteriler için wa_id atlanır; BSUID'yi de saklayın.
  • Üst BSUID altındaki herkese durdurmayı uygulamak. Meta tercihleri kullanıcı başına uygular, hiçbir zaman üst düzeyde uygulamaz.
  • 131050 sonrası yeniden denemek, durdurma olarak kaydetmek yerine. Her yeniden deneme aynı şekilde başarısız olur.
Bunu EasyCoexistence'la yapmak

Bu yoldan gönderilen pazarlama şablonları kendi WhatsApp Business Hesabınızdan çıkar ve müşterinin durdurduğunu bildiren başarısız durumlar doğrudan sunucunuza ya da imzalı yönlendirmeler olarak ulaşır. Numara başına, ayda US$ 9'dan US$ 0.75'e kadar; numara ekledikçe düşer, ilk 3 gün ücretsiz deneme.

Sık sorulan sorular

Durdurma, müşterinin kendi mesajlarınıza verdiği yanıtları da engeller mi?

Meta'nın dokümantasyonu durdurmayı pazarlama mesajlarını kapsayan bir durum olarak tanımlar ve döndürdüğü hata da pazarlama mesajlarını adıyla anar. Size yazan bir müşteriye verilen yanıtlar hizmet mesajıdır; bu farklı bir kategoridir.

İşletmeyi engellemek user_preferences'ı tetikler mi?

Hayır. Webhook yalnızca Teklifler ve duyurular ayarındaki durdurma ve devam etme eylemlerinde tetiklenir. Engellemek ayrı bir eylemdir ve bu alanda bildirilmez.

Devam etme, opt-in sayılır mı?

Müşterinin pazarlama mesajlarınızı yeniden almayı seçtiği anlamına gelir. Meta politikası kapsamındaki kendi opt-in yükümlülükleriniz yine geçerlidir, bu yüzden o müşterinin size ne zaman ve nasıl onay verdiğine dair kaydı tutun.

Hangi webhook alanına abone olmalıyım?

user_preferences alanına; uygulama panelinde, WhatsApp Business Hesabına abone olan uygulamanın WhatsApp > Configuration bölümünden. messages'tan ayrı bir alandır ve whatsapp_business_management iznine ihtiyaç duyar.

Okumaya devam edin

Başlamaya hazır mısınız?

WhatsApp Coexistence'ı aylar değil, dakikalar içinde kurun. Uygulama telefonda çalışmaya devam eder.

Ücretsiz denemeyi başlatın

Doğrulama tarihi