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

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

Обновлено: 22 октября 2025 г

сообщений бизнес-аккаунта 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_PROFILE_NAME>" }, "wa_id": "<WHATSAPP_USER_ID>", "identity_key_hash": "<IDENTITY_KEY_HASH>" <!-- only included if identity change check enabled --> } ], "messages": [ { "context": { "from": "<BUSINESS_DISPLAY_PHONE_NUMBER>", "id": "<CONTEXTUAL_WHATSAPP_MESSAGE_ID>" }, "from": "<WHATSAPP_USER_PHONE_NUMBER>", "id": "<WHATSAPP_MESSAGE_ID>", "timestamp": "<WEBHOOK_TRIGGER_TIMESTAMP>", "type": "button", "button": { "payload": "<BUTTON_LABEL_TEXT>", "text": "<BUTTON_LABEL_TEXT>" } } ] }, "field": "messages" } ] } ] }

Параметры

Заполнитель Описание Пример значения

<BUSINESS_DISPLAY_PHONE_NUMBER>

Нить

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

15550783881

<BUSINESS_PHONE_NUMBER_ID>

Нить

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

106540352242922

<BUTTON_LABEL_TEXT>

Нить

Текст подписи кнопки быстрого ответа.

Отписаться

<CONTEXTUAL_WHATSAPP_MESSAGE_ID>

Нить

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

wamid.HBgLMTQxMjU1NTA4MjkVAgASGBQzQUNCNjk5RDUwNUZGMUZEM0VBRAA=

<IDENTITY_KEY_HASH>

Нить

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

DF2lS5v2W6x=

<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": "1750091045", "type": "button", "button": { "payload": "Unsubscribe", "text": "Unsubscribe" } } ] }, "field": "messages" } ] } ] }