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

Справочник по веб-перехватчикам групповых сообщений

Обновлено: 10 ноября 2025 г

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

Триггеры

Пользователь 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 > " d --> }
 ],
 "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 групп. В этом поле отображается информация о том, когда сообщения были отправлены, получены или прочитаны из группы. Узнайте больше об 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"
 : "HBgLMTY1MDM4Nzk0MzkVAgASGBQzQTRBNjU5OUFFRTAzODEwM TQ0RgA" , "id"
 : "wamid.HASDI128HJOPUERIH82ahdasd09ASDHi5>" , "timestamp"
 : "1744344496" , "text"
 : { "body"
 : "Что все думают об этом?" },
 "type"
 : "text" }
 ]
 },
 "field"
 : "messages" }
 ]
 }
 ]
 }