Перейти к основному содержимому

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

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

Обновлено: 22 октября 2025 г
Веб сообщений описывает сообщения, отправленные пользователем WhatsApp компании, а также статус сообщений, отправленных компанией пользователю WhatsApp.

Структуры полезной нагрузки

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

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

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

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

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

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

Ошибки

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