Справочник по веб-перехватчикам системных сообщений | Документация для разработчиков
Справочник по веб-перехватчикам системных сообщений
Обновлено: 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_USER_PHONE_NUMBER> НитьНомер телефона пользователя 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" }, "messages": [ { "from": "16505551234", "id": "wamid.HBgLMTk4MzU1NTE5NzQVAgASGAoxMTgyMDg2MjY3AA==", "timestamp": "1750269342", "system": { "body": "Пользователь Шина Нельсон изменила свой номер с 16505551234 на 12195555358", "wa_id": "12195555358", "type": "user_changed_number" }, "type": "system" } ] }, "field": "messages" } ] } ] }