Управление веб-хуками | Документация для разработчиков
Управление веб-хуками
Обновлено: 12 декабря 2025 г
Аккаунты WhatsApp Business (WABA) и их ресурсы являются объектами в социальной сети Facebook. Когда с одним из этих объектов происходит событие-триггер, Facebook его видит и отправляет уведомление на URL-адрес веб-перехватчика, указанный на панели управления вашего приложения Facebook.
В контексте встроенной регистрации вы можете использовать веб-хуки для получения уведомлений об изменениях в ваших WABA-кодах, номерах телефонов, шаблонах сообщений и сообщениях, отправленных на ваши номера телефонов.
Необходимо индивидуально подписаться на каждый WABA-сервер, от которого вы хотите получать веб-хуки. После получения WABA-идентификатора клиента, подпишите ваше приложение на этот идентификатор, чтобы начать получать веб-хуки.
Дополнительную информацию о веб-хуках и полях см разделе «Веб-хуки»
Подпишитесь на веб-хуки для бизнес-клиента WABA
Используйте POST /
Запрос
Ответ
В случае успеха:
{ "success": true }Повторите этот процесс для любых других WABA, для которых вы хотите получать уведомления через веб-хуки. Обратите внимание, что если вы подпишете свое приложение на веб-хуки для нескольких WABA, все уведомления через веб-хуки будут отправляться на URL-адрес обратного вызова приложения, указанный на «Веб-хуки» в панели управления приложением, если вы не отключите веб-хуки .
Получите все подписки на WABA
Чтобы получить список приложений, подписанных на веб-хуки для WABA, отправьте GET-запрос к
subscribed_apps на WABA:Отписаться от рассылки WABA
Чтобы отменить подписку вашего приложения на веб-хуки для бизнес-аккаунта WhatsApp, отправьте запрос DELETE на
subscribed_apps в WABA.Переопределение URL-адреса обратного вызова
См. раздел «Переопределение веб-перехватчиков» .
Настройте уведомления
Вы можете настроить веб-хуки для отправки уведомлений об изменениях в ваших аккаунтах WhatsApp Business, на которые вы подписаны. Вы можете подписаться на следующие типы уведомлений:
Доступные поля подписки
| Название поля | Описание |
|---|---|
|
Веб account_alerts лимита сообщений , профиля компании и официального бизнес-аккаунта для корпоративного телефонного номера . | |
|
Веб account_review_update уведомляет вас о том, что учетная запись WhatsApp Business была проверена на соответствие нашим правилам. | |
|
-хук account_update уведомляет бизнес-подтверждения, предоставленных партнером WhatsApp Business , о международной аутентификации или об основном местоположении бизнеса, когда учетная запись передается партнеру по решениям , о нарушениях политики или условий , об удалении, повторном подключении или об удалении учетной записи. | |
|
automatic_events , который отправил вам сообщение через вашу рекламу Click to WhatsApp, если вы включили по автоматическим событиям . | |
|
Веб business_capability_update уведомляет вас об изменениях в возможностях бизнес-аккаунта WhatsApp или бизнес-портфеля ( лимиты на сообщения , лимиты на номера телефонов и т. д.). | |
|
Веб истории используется для синхронизации истории чатов в приложении WhatsApp Business для бизнес-клиентов, подключенных поставщиком решений. | |
|
Веб message_template_components_update уведомляет вас об изменениях в компонентах шаблона. | |
|
Веб message_template_quality_update оценке качества шаблона . | |
|
Веб message_template_status_update уведомляет вас об изменениях статуса существующего шаблона. | |
|
Веб сообщений описывает сообщения, отправленные пользователем WhatsApp компании, а также статус сообщений, отправленных компанией пользователю WhatsApp. | |
|
Веб -хук partner_solutions описывает изменения статуса многопартнерского решения . | |
|
перехватчик payment_configuration_update уведомляет вас об изменениях в конфигурации платежей для Payments API India и Payments API Brazil . | |
|
Веб phone_number_name_update уведомляет вас о проверки отображаемого имени . | |
|
Веб phone_number_quality_update уровня пропускной способности бизнес-телефонного номера . | |
|
Веб безопасности уведомляет вас об изменениях в настройках безопасности корпоративного телефонного номера. | |
|
Веб smb_app_state_sync используется для синхронизации контактов пользователей приложения WhatsApp Business, которые были подключены через поставщика решений. | |
|
Веб smb_message_echoes уведомляет вас о сообщениях, отправленных через приложение WhatsApp Business или сопутствующее («связанное») устройство бизнес-клиентом, подключенным к Cloud API через поставщика решений. | |
|
Веб template_category_update категории шаблона . | |
|
Веб user_preferences настройках получения маркетинговых сообщений пользователем WhatsApp . |
Примеры
Привлеченный корпоративный клиент
Веб account_update
событием PARTNER_ADDED срабатывает , когда корпоративный клиент успешно завершает процесс встроенной регистрации.