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

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

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

Веб сообщений описывает сообщения, отправленные пользователем WhatsApp компании, а также статус сообщений, отправленных компанией пользователю 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": [ { "from": "16505551234", "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgASGBQzQTRBNjU5OUFFRTAzODEwMTQ0RgA=", "timestamp": "1749416383", "type": "text", "text": { "body": "Есть ли он в другом цвете?" } } ] }, "field": "messages" } ] } ] }

Объекты в сообщения Массив может сильно различаться в зависимости от типа сообщения (обозначаемого символом...) ~~объект'~~объект'с тип свойство). По этой причине для каждого типа входящих сообщений существует отдельная ссылка, доступная в меню слева.

Исходящие сообщения

Веб-хуки сообщений, описывающие сообщение, отправленное компанией пользователю WhatsApp, имеют другую структуру. Их легко узнать по наличию следующего элемента: статусы массив. Например, этот веб-хук описывает сообщение, доставленное в WhatsApp ~~пользователь'~~пользователь'устройство:

"object": "whatsapp_business_account", "entry": [ { "id": "102290129340398", "changes": [ { "value": { "messaging_product": "whatsapp", "metadata": { "display_phone_number": "15550783881", "phone_number_id": "106540352242922" }, "statuses": [ { "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgARGBI3MTE5MjVBOTE3MDk5QUVFM0YA", "status": "delivered", "timestamp": "1750263773", "recipient_id": "16505551234", "conversation": { "id": "6ceb9d929c9bdc4f90e967a32f8639b4", "origin": { "type": "service" } }, "pricing": { "billable": true, "pricing_model": "CBP", "category": "service" } } ] }, "field": "messages" } ] } ] }

Обратите внимание, что эти веб-хуки ~~дон'~~дон'Для описания содержимого самого исходящего сообщения используется только его статус, и каждое исходящее сообщение может иметь до трех отдельных веб-хуков (один для статуса «отправлено», один для «доставлено» и один для «прочитано»).

Для вебхуков статуса также существует отдельная справочная информация .

Ошибки

Ошибки в веб-хуках сообщений могут проявляться в трех местах:

Ошибки на системном, прикладном и учётном уровнях отображаются как значения ( entry.changes.value.errors ). См. по ошибкам .Ошибки входящих сообщений отображаются в messages ( entry.changes.value.messages.errors ). Для этих веб-хуков установлен тип unsupported . См. по unsupported .Ошибки исходящих сообщений отображаются в статусов ( entry.changes.value.statuses.errors ). См. статусов .