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

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

Справочник веб-хуков для сообщений-реакций

Обновлено: 14 ноября 2025 г
сообщений бизнес-аккаунта WhatsApp, содержащих реакцию на предыдущее сообщение, отправленное компанией.
Примечание: когда конечный пользователь удаляет эмодзи-реакцию, будет отправлен веб-хук без поля «emoji», как показано в примерах веб-хуков ниже.

Триггеры

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

    Синтаксис

    { "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 --> } ], "сообщения": [ { "из": "<WHATSAPP_USER_PHONE_NUMBER> ", "идентификатор": "<WHATSAPP_MESSAGE_ID> ", "временная метка": "<REACTION_TIMESTAMP> ", "type": "reaction", "reaction": { "message_id": "<CONTEXTUAL_WHATSAPP_MESSAGE_ID> ", "emoji": "<EMOJI_UNICODE> "<!-- omitted if user removes reaction --> } } ] }, "field": "messages" } ] } ] }
    Параметры
    
Заполнитель

Описание

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

    <BUSINESS_DISPLAY_PHONE_NUMBER>
    Нить
    Номер телефона компании, отображаемый на экране.
    15550783881
    <BUSINESS_PHONE_NUMBER_ID>
    Нить
    Идентификатор номера служебного телефона.
    106540352242922
    <CONTEXTUAL_WHATSAPP_MESSAGE_ID>
    Нить
    Идентификатор сообщения WhatsApp, на которое отреагировал пользователь WhatsApp.
    wamid.HBgLMTQxMjU1NTA4MjkVAgASGBQzQUNCNjk5RDUwNUZGMUZEM0VBRAA=
    <EMOJI_UNICODE>
    Нить
    Юникод эмодзи, отправленного пользователем WhatsApp в качестве реакции.
    Если пользователь уберет свою первоначальную реакцию, сработает другой веб-хук, но  emoji будет опущено в полезной нагрузке.
    U+1F44D
    <IDENTITY_KEY_HASH>
    Нить
    Хэш ключа идентификации. Включается только в том случае, если включена  проверки изменений идентификатора .
    DF2lS5v2W6x=
    <REACTION_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": [ { "from": "16505551234", "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgASGBQzQUFERjg0NDEzNDdFODU3MUMxMAA=", "timestamp": "1749419544", "type": "reaction", "reaction": { "message_id": "wamid.HBgLMTQxMjU1NTA4MjkVAgASGBQzQUNCNjk5RDUwNUZGMUZEM0VBRAA=", "emoji": "👍" } } ] }, "field": "messages" } ] } ] }
    Реакция удалена конечным пользователем
    { "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": [ { "from": "16505551234", "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgASGBQzQUFERjg0NDEzNDdFODU3MUMxMAA=", "timestamp": "1749419544", "type": "reaction", "reaction": { "message_id": "wamid.HBgLMTQxMjU1NTA4MjkVAgASGBQzQUNCNjk5RDUwNUZGMUZEM0VBRAA=" } } ] }, "field": "messages" } ] } ] }
    
    
            
    
    
    

            
    
        
    
    
    

    
    

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