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

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

Справочник по веб-перехватчикам интерактивных сообщений

Обновлено: 22 октября 2025 г
бизнес-аккаунта WhatsApp, сообщений предназначенного для ответов на интерактивные сообщения.

Триггеры

    Пользователь WhatsApp нажимает на строку в интерактивном списке сообщений.Пользователь WhatsApp нажимает кнопку в интерактивном сообщении с кнопкой ответа.

    Синтаксис

    {
"object": "whatsapp_business_account", "entry": [ { "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID> ", "изменения": [ { "значение": { "messaging_product": "whatsapp", "метаданные": { "отображаемый_номер_телефона": "<BUSINESS_DISPLAY_PHONE_NUMBER> ", "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID> " }, "контакты": [ { "профиль": { "имя": "<WHATSAPP_USER_PROFILE_NAME> " }, "wa_id": "<WHATSAPP_USER_ID> ", "identity_key_hash": "<IDENTITY_KEY_HASH> "<!-- only included if identity change check enabled --> } ], "сообщения": [ { "контекст": { "из": "<BUSINESS_DISPLAY_PHONE_NUMBER> ", "идентификатор": "<CONTEXTUAL_WHATSAPP_MESSAGE_ID> " }, "от": "<WHATSAPP_USER_PHONE_NUMBER> ", "идентификатор": "<WHATSAPP_MESSAGE_ID> ", "временная метка": "<WEBHOOK_TRIGGER_TIMESTAMP> ", "type": "interactive",<!-- interactive list message replies only --> "interactive": { "type": "list_reply", "list_reply": { "id": "<ROW_ID> ", "заголовок": "<ROW_TITLE> ", "описание": "<ROW_DESCRIPTION> " } },<!-- interactive reply button message replies only --> "interactive": { "type": "button_reply", "button_reply": { "id": "<BUTTON_ID> ", "заголовок": "<BUTTON_LABEL_TEXT> " } } } ] }, "field": "messages" } ] } ] }
    Параметры
    

    

    



Заполнитель 

Описание 

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




    

    <BUSINESS_DISPLAY_PHONE_NUMBER>
    

    Нить
    


    

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


    

    15550783881
    



    

    <BUSINESS_PHONE_NUMBER_ID>
    

    Нить
    


    

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


    

    106540352242922
    



    

    <BUTTON_ID>
    

    Нить
    


    

    Идентификатор кнопки.
    


    

    кнопка отмены
    



    

    <BUTTON_LABEL_TEXT>
    

    Нить
    


    

    Текст надписи на кнопке.
    


    

    Отмена
    



    

    <CONTEXTUAL_WHATSAPP_MESSAGE_ID>
    

    Нить
    


    

    Идентификатор сообщения WhatsApp, содержащего кнопку, на которую нажал пользователь WhatsApp.
    


    

    wamid.HBgLMTQxMjU1NTA4MjkVAgASGBQzQUNCNjk5RDUwNUZGMUZEM0VBRAA=
    



    

    <IDENTITY_KEY_HASH>
    

    Нить
    


    

    Хэш ключа идентификации. Включается только в том случае, если включена проверки изменений идентификатора .
    


    

    DF2lS5v2W6x=
    



    

    <ROW_DESCRIPTION>
    

    Нить
    


    

    Описание строки.
    


    

    От следующего дня до двух дней
    



    

    <ROW_ID>
    

    Нить
    


    

    Идентификатор строки.
    


    

    приоритет_экспресс
    



    

    <ROW_TITLE>
    

    Нить
    


    

    Заголовок строки.
    


    

    Экспресс-почта Priority Mail
    



    

    <WEBHOOK_TRIGGER_TIMESTAMP>
    

    Нить
    


    

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


    

    1739321024
    



    

    <WHATSAPP_BUSINESS_ACCOUNT_ID>
    

    Нить
    


    

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


    

    102290129340398
    



    

    <WHATSAPP_MESSAGE_ID>
    

    Нить
    


    

    Идентификатор сообщения WhatsApp.
    


    

    wamid.HBgLMTY1MDM4Nzk0MzkVAgASGBQzQUFERjg0NDEzNDdFODU3MUMxMAA=
    



    

    <WHATSAPP_USER_ID>
    

    Нить
    


    

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


    

    16505551234
    



    

    <WHATSAPP_USER_PHONE_NUMBER>
    

    Нить
    


    

    Номер телефона пользователя WhatsApp. Это то же самое значение, которое возвращает API вход Значение при отправке сообщения пользователю 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": [ { "profile": { "name": "Sheena Nelson" }, "wa_id": "16505551234" } ], "messages": [ { "context": { "from": "15550783881", "id": "wamid.HBgLMTQxMjU1NTA4MjkVAgASGBQzQUNCNjk5RDUwNUZGMUZEM0VBRAA=" }, "from": "16505551234", "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgASGBQzQUFERjg0NDEzNDdFODU3MUMxMAA=", "timestamp": "1749854575", "type": "interactive", "interactive": { "type": "list_reply", "list_reply": { "id": "priority_express", "title": "Priority Mail Express", "description": "Next Day to 2 Days" } } } ] }, "field": "messages" } ] } ] }
    В этом примере веб-перехватчика описывается нажатие пользователем WhatsApp кнопки в интерактивном сообщении с кнопкой ответа.
    

    

    { "object": "whatsapp_business_account", "entry": [ { "id": "102290129340398", "changes": [ { "value": { "messaging_product": "whatsapp", "metadata": { "display_phone_number": "15550783881", "phone_number_id": "106540352242922" }, "contacts": [ { "profile": { "name": "Sheena Nelson" }, "wa_id": "16505551234" } ], "messages": [ { "context": { "from": "15550783881", "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgARGBI3MEM2RUJFNkI0RENGQTVDRjUA" }, "from": "16505551234", "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgASGBQzQTZBQzg0MzQ4QjRCM0NGNkVGOAA=", "timestamp": "1750025136", "type": "interactive", "interactive": { "type": "button_reply", "button_reply": { "id": "cancel-button", "title": "Cancel" } } } ] }, "field": "messages" } ] } ] }
    
    
            
    
    
    

            
    
        
    
    
    

    
    

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