Справочник по веб-перехватчикам групповых сообщений | Документация для разработчиков
Справочник по веб-перехватчикам групповых сообщений
Обновлено: 10 ноября 2025 г
бизнес-аккаунта 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": [
{
"from": "<WHATSAPP_USER_PHONE_NUMBER>",
"group_id": "<GROUP_ID>",
"id": "<WHATSAPP_MESSAGE_ID>",
"timestamp": "<WEBHOOK_TRIGGER_TIMESTAMP>",
"text": {
"body": "<MESSAGE_TEXT_BODY>"
},
"type": "<MESSAGE_TYPE>"
}
],
},
"field": "messages"
}
]
}
]
}
Параметры
| Заполнитель | Описание | Пример значения |
|---|---|---|
<BUSINESS_DISPLAY_PHONE_NUMBER>Нить | Номер телефона компании, отображаемый на экране. | 15550783881 |
<BUSINESS_PHONE_NUMBER_ID>Нить | Идентификатор номера служебного телефона. | 106540352242922 |
<GROUP_ID>Нить | Строковый идентификатор группы, созданной с помощью API групп. В этом поле отображается информация о том, когда сообщения были отправлены, получены или прочитаны из группы. | "Y2FwaV9ncm91cDoxNzA1NTU1MDEzOToxMjAzNjM0MDQ2OTQyMzM4MjAZD" |
<IDENTITY_KEY_HASH>Нить | Хэш ключа идентификации. Включается только в том случае, если включена проверки изменений идентификатора . | DF2lS5v2W6x= |
<MESSAGE_TEXT_BODY>Нить | Текст сообщения. | Что вы все думаете по этому поводу? |
<MESSAGE_TYPE>Нить | Тип отправляемого сообщения. Будет меняться в зависимости от сообщения, отправляемого группе. В настоящее время API групп поддерживает: | текст |
<WHATSAPP_BUSINESS_ACCOUNT_ID>Нить | Идентификатор бизнес-аккаунта WhatsApp. | 102290129340398 |
<WHATSAPP_MESSAGE_ID>Нить | Идентификатор сообщения WhatsApp. | wamid.HBgLMTY1MDM4Nzk0MzkVAgASGBQzQUFERjg0NDEzNDdFODU3MUMxMAA= |
<WEBHOOK_TRIGGER_TIMESTAMP>Нить | Временная метка Unix, указывающая на момент срабатывания веб-перехватчика. | 1739321024 |
<WHATSAPP_USER_PHONE_NUMBER>Нить | Номер телефона пользователя WhatsApp. Это то же значение, которое возвращает API в качестве входного значения при отправке сообщения пользователю WhatsApp. Обратите внимание, что номер телефона и идентификатор пользователя WhatsApp могут не всегда совпадать. | +16505551234 |
<WHATSAPP_USER_PROFILE_NAME>Нить | Имя пользователя WhatsApp, как оно отображается в его профиле в клиенте WhatsApp. | Шина Нельсон |
<WHATSAPP_USER_ID>Нить | Идентификатор пользователя WhatsApp. Обратите внимание, что идентификатор пользователя WhatsApp и номер телефона могут не всегда совпадать. | 16505551234 |
Пример
{
"object": "whatsapp_business_account",
"entry": [
{
"id": "102290129340398",
"changes": [
{
"value": {
"messaging_product": "whatsapp",
"metadata": {
"display_phone_number": "15550783881",
"phone_number_id": "106540352242922"
},
"contacts": [
{
"profile": {
"name": "Tiago Mingo"
},
"wa_id": "16505551234"
}
],
"messages": [
{
"from": "16505551234",
"group_id": "HBgLMTY1MDM4Nzk0MzkVAgASGBQzQTRBNjU5OUFFRTAzODEwMTQ0RgA",
"id": "wamid.HASDI128HJOPUERIH82ahdasd09ASDHi5>",
"timestamp": "1744344496",
"text": {
"body": "Что все думают об этом?"
},
"type": "text"
}
]
},
"field": "messages"
}
]
}
]
}