Справочник по веб-перехватчикам системных сообщений | Документация для разработчиков
Справочник по веб-перехватчикам системных сообщений
Обновлено: 22 октября 2025 г
сообщений бизнес-аккаунта 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_PHONE_NUMBER> ", "идентификатор": "<WHATSAPP_MESSAGE_ID> ", "временная метка": "<WEBHOOK_TRIGGER_TIMESTAMP> ", "type": "system", "system": { "body": "User<WHATSAPP_USER_PROFILE_NAME> изменился с<WHATSAPP_USER_PHONE_NUMBER> к<NEW_WHATSAPP_USER_PHONE_NUMBER> ", "wa_id": "<NEW_WHATSAPP_USER_ID> ", "type": "user_changed_number" } } ] }, "field": "messages" } ] } ] }Параметры
| Заполнитель | Описание | Пример значения |
|---|---|---|
<BUSINESS_DISPLAY_PHONE_NUMBER>Нить | Номер телефона компании, отображаемый на экране. | 15550783881 |
<BUSINESS_PHONE_NUMBER_ID>Нить | Идентификатор номера служебного телефона. | 106540352242922 |
<NEW_WHATSAPP_USER_ID>Нить | Новый идентификатор пользователя WhatsApp. Обратите внимание, что идентификатор пользователя WhatsApp и номер телефона могут не всегда совпадать. | 12195555358 |
<NEW_WHATSAPP_USER_PHONE_NUMBER>Нить | Номер телефона нового пользователя WhatsApp. Обратите внимание, что номер телефона и идентификатор пользователя WhatsApp не всегда могут совпадать. | 12195555358 |
<WEBHOOK_TRIGGER_TIMESTAMP>Нить | Временная метка Unix, указывающая на момент срабатывания веб-перехватчика. | 1739321024 |
<WHATSAPP_BUSINESS_ACCOUNT_ID>Нить | Идентификатор бизнес-аккаунта WhatsApp. | 102290129340398 |
<WHATSAPP_MESSAGE_ID>Нить | Идентификатор сообщения WhatsApp. | wamid.HBgLMTY1MDM4Nzk0MzkVAgASGBQzQUFERjg0NDEzNDdFODU3MUMxMAA= |
| Номер телефона пользователя WhatsApp. Обратите внимание, что номер телефона и идентификатор пользователя WhatsApp не всегда могут совпадать. | 16505551234 |
| Имя пользователя WhatsApp, как оно отображается в его профиле в клиенте WhatsApp. | Шина Нельсон |
Пример
{ "object": "whatsapp_business_account", "entry": [ { "id": "102290129340398", "changes": [ { "value": { "messaging_product": "whatsapp", "metadata": { "display_phone_number": "15550783881", "phone_number_id": "106540352242922" }, "messages": [ { "from": "16505551234", "id": "wamid.HBgLMTk4MzU1NTE5NzQVAgASGAoxMTgyMDg2MjY3AA==", "timestamp": "1750269342", "system": { "body": "Пользователь Шина Нельсон изменила свой номер с 16505551234 на 12195555358", "wa_id": "12195555358", "type": "user_changed_number" }, "type": "system" } ] }, "field": "messages" } ] } ] }