Перейти к основному содержимому

Справочник по веб-перехватчикам user_preferences | Документация для разработчиков

Справочник веб-перехватчиков user_preferences

Обновлено: 5 ноября 2025 г
В этом справочнике описаны события-триггеры и содержимое полезной нагрузки для user_preferences .
Он пользовательские_настройки webhook notifies you of changes to a WhatsApp пользователь'пользователь'с marketing message preferences.

Триггеры

    Пользователь WhatsApp отключил получение рекламных сообщений.Пользователь WhatsApp возобновляет отправку рекламных сообщений.

    Синтаксис

    {
"object": "whatsapp_business_account", "entry": [ { "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>", "changes": [ { "value": { "messaging_product": "whatsapp", "metadata": { "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>", "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>" }, "contacts": [ { "profile": { "name": "<WHATSAPP_USER_NAME>" }, "wa_id": "<WHATSAPP_USER_ID>" } ], "user_preferences": [ { "wa_id": "<WHATSAPP_USER_ID>", "detail": "<PREFERENCE_DESCRIPTION>", "category": "marketing_messages", "value": "<PREFERENCE>", "timestamp": <WEBHOOK_SENT_TIMESTAMP> } ] }, "field": "user_preferences" } ] } ] }
    Параметры
    

    

    



Заполнитель 

Описание 

Пример значения 




    

    <BUSINESS_DISPLAY_PHONE_NUMBER>
    

    Нить
    


    

    Номер телефона компании, отображаемый на экране.
    


    

    15550783881
    



    

    <BUSINESS_PHONE_NUMBER_ID>
    

    Нить
    


    

    Идентификатор номера служебного телефона.
    


    

    106540352242922
    



    

    <PREFERENCE>
    

    Нить
    


    


    Возможные значения:
    

    останавливаться —- Indicates the WhatsApp user has opted to stop receiving marketing messages from you.
    

    resume —- Indicates the WhatsApp user has opted to resume receiving marketing messages from you.
    


    

    останавливаться
    



    

    <PREFERENCE_DESCRIPTION>
    

    Нить
    


    


    Возможные значения:
    

      Пользователь попросил прекратить получение маркетинговых сообщенийПользователь запросил возобновление получения маркетинговых сообщений
      


      

      Пользователь попросил прекратить получение маркетинговых сообщений
      



      

      <WEBHOOK_TRIGGER_TIMESTAMP>
      

      Целое число
      


      

      Временная метка Unix, указывающая на момент срабатывания веб-перехватчика.
      


      

      1739321024
      



      

      <WHATSAPP_BUSINESS_ACCOUNT_ID>
      

      Нить
      


      

      Идентификатор бизнес-аккаунта WhatsApp.
      


      

      102290129340398
      



      

      <WHATSAPP_USER_ID>
      

      Нить
      


      

      Идентификатор пользователя WhatsApp. Обратите внимание, что WhatsApp пользователь'пользователь'Идентификационный номер и номер телефона могут не всегда совпадать.
      


      

      16505551234
      



      

      <WHATSAPP_USER_PROFILE_NAME>
      

      Нить
      


      

      WhatsApp пользователь'пользователь'Имя, как оно отображается в профиле пользователя в приложении WhatsApp.
      


      

      Шина Нельсон
      Пример
      { "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_preferences": [ { "wa_id": "16505551234", "detail": "Пользователь запросил возобновление маркетинговых сообщений", "category": "marketing_messages", "value": "resume", "timestamp": 1731705721 } ] }, "field": "user_preferences" } ] } ] }
      
    
              
      
    
      

            
      
        
      
    
      

    
      

    
    
      
        
      
             Вернуться наверх