Управление веб-хуками | Документация для разработчиков
Управление веб-хуками
Обновлено: 12 декабря 2025 г
Аккаунты WhatsApp Business (WABA) и их ресурсы являются объектами в социальной сети Facebook. Когда с одним из этих объектов происходит событие-триггер, Facebook его видит и отправляет уведомление на URL-адрес веб-перехватчика, указанный на панели управления вашего приложения Facebook.
В контексте встроенной регистрации вы можете использовать веб-хуки для получения уведомлений об изменениях в ваших WABA-кодах, номерах телефонов, шаблонах сообщений и сообщениях, отправленных на ваши номера телефонов.
Необходимо индивидуально подписаться на каждый WABA-сервер, от которого вы хотите получать веб-хуки. После получения WABA-идентификатора клиента, подпишите ваше приложение на этот идентификатор, чтобы начать получать веб-хуки.
Дополнительную информацию о веб-хуках и полях см разделе «Веб-хуки»
Подпишитесь на веб-хуки для бизнес-клиента WABA
Используйте POST /
Запрос
curl -X POST 'https://graph.facebook.com/<API_VERSION> /<WABA_ID> /subscribed_apps' \ -H 'Авторизация: Bearer'<ACCESS_TOKEN> '
Ответ
В случае успеха:
{ "success": true }Повторите этот процесс для любых других WABA, для которых вы хотите получать уведомления через веб-хуки. Обратите внимание, что если вы подпишете свое приложение на веб-хуки для нескольких WABA, все уведомления через веб-хуки будут отправляться на URL-адрес обратного вызова приложения, указанный на «Веб-хуки» в панели управления приложением, если вы не отключите веб-хуки .
Получите все подписки на WABA
Чтобы получить список приложений, подписанных на веб-хуки для WABA, отправьте GET-запрос к
subscribed_apps на WABA:Синтаксис запроса
Получите https://graph.facebook.com/<API_VERSION> /<WABA_ID> /subscribed_apps
Успешный ответ включает в себя набор приложений, подписанных на WABA, с указанием ссылок, названий и идентификаторов для каждого приложения.
Образец запроса
curl \ 'https://graph.facebook.com/v25.0/102289599326934/subscribed_apps' \ -H 'Авторизация: Bearer EAAJi...'
Пример ответа
{ "data" : [ { "whatsapp_business_api_data" : { "id" : "67084...", "link" : "https://www.facebook.com/games/?app_id=67084...", "name" : "Jaspers Market" } }, { "whatsapp_business_api_data" : { "id" : "52565...", "link" : "https://www.facebook.com/games/?app_id=52565...", "name" : "Jaspers Fresh Finds" } } ] }Отписаться от рассылки WABA
Чтобы отменить подписку вашего приложения на веб-хуки для бизнес-аккаунта WhatsApp, отправьте запрос DELETE на
subscribed_apps в WABA.Синтаксис запроса
УДАЛИТЬ https://graph.facebook.com/<API_VERSION> /<WABA_ID> /subscribed_apps
Образец запроса
curl -X DELETE \ 'https://graph.facebook.com/v25.0/102289599326934/subscribed_apps' \ -H 'Авторизация: Bearer EAAJi...'
Пример ответа
{ "success" : true }Переопределение 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 срабатывает , когда корпоративный клиент успешно завершает процесс встроенной регистрации.Синтаксис
{ "entry": [ { "id": "<BUSINESS_PORTFOLIO_ID> ", "время":<WEBHOOK_SENT_TIMESTAMP> , "изменения": [ { "значение": { "событие": "<EVENT> ", "waba_info": { "waba_id": "<CUSTOMER_WABA_ID> ", "owner_business_id": "<CUSTOMER_BUSINESS_PORTFOLIO_ID> " } }, "field": "account_update" } ] } ], "object": "whatsapp_business_account" }Пример
{ "entry": [ { "id": "35602282435505", "time": 1731617831, "changes": [ { "value": { "event": "PARTNER_ADDED", "waba_info": { "waba_id": "495709166956424", "owner_business_id": "942647313864044" } }, "field": "account_update" } ] } ], "object": "whatsapp_business_account" }Обновление номеров телефонов
Получено обновление имени
{ "object": "whatsapp_business_account", "entry": [ { "id": "495709166956424", "time": 1731617831, "changes": [ { "field": "phone_number_name_update", "value": { "display_phone_number": "124545784358810", "decision": "APPROVED", "requested_verified_name": "WhatsApp", "rejection_reason": null } } ] } ] }Получено обновление качества
{ "object": "whatsapp_business_account", "entry": [ { "id": "495709166956424", "time": 1731617831, "changes": [ { "field": "phone_number_quality_update", "value": { "display_phone_number": "124545784358810", "event": "FLAGGED", "current_limit": "TIER_10K" } } ] } ] }Обновления WABA
Номер тестовой среды повышен до подтвержденного аккаунта
{ "object": "whatsapp_business_account", "entry": [ { "id": "495709166956424", "time": 1731617831, "changes": [ { "field": "account_update", "value": { "phone_number": "124545784358810", "event": "VERIFIED_ACCOUNT" } } ] } ] }Аккаунт WhatsApp Business заблокирован
{ "object": "whatsapp_business_account", "entry": [ { "id": "495709166956424", "time": 1731617831, "changes": [ { "field": "account_update", "value": { "event": "DISABLED_UPDATE" "ban_info": { "waba_ban_state": ["SCHEDULE_FOR_DISABLE", "DISABLE", "REINSTATE"], "waba_ban_date": "DATE" } } } ] } ] }Проверка аккаунта WhatsApp Business завершена
{ "object": "whatsapp_business_account", "entry": [ { "id": "495709166956424", "time": 1731617831, "changes": [ { "field": "account_review_update", "value": { "decision": "APPROVED" } } ] } ] }Обновления шаблонов сообщений
Одобренный
{ "entry": [ { "id": "495709166956424", "time": 1731617831, "changes": [ { "value": { "event": "APPROVED", "message_template_id": 64244916695, "message_template_name": "Summer 20 Template", "message_template_language": "en_US", "reason": "NONE" }, "field": "message_template_status_update" } ] } ], "object": "whatsapp_business_account" }
Комментарии отсутствуют
Комментарии отсутствуют