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

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

Управление веб-хуками

Обновлено: 12 декабря 2025 г
Аккаунты WhatsApp Business (WABA) и их ресурсы являются объектами в социальной сети Facebook. Когда с одним из этих объектов происходит событие-триггер, Facebook его видит и отправляет уведомление на URL-адрес веб-перехватчика, указанный на панели управления вашего приложения Facebook.
В контексте встроенной регистрации вы можете использовать веб-хуки для получения уведомлений об изменениях в ваших WABA-кодах, номерах телефонов, шаблонах сообщений и сообщениях, отправленных на ваши номера телефонов.
Необходимо индивидуально подписаться на каждый WABA-сервер, от которого вы хотите получать веб-хуки. После получения WABA-идентификатора клиента, подпишите ваше приложение на этот идентификатор, чтобы начать получать веб-хуки.
Дополнительную информацию о веб-хуках и полях см разделе «Веб-хуки»

Подпишитесь на веб-хуки для бизнес-клиента WABA

Используйте POST / /subscribed_apps используется для подписки вашего приложения на веб-хуки в WABA бизнес-клиента. Если вы хотите, чтобы веб-хуки клиента отправлялись на другой URL-адрес обратного вызова, отличный от того, который установлен в вашем приложении, у вас есть несколько переопределения веб-хуков .

Запрос



локон

-X

ПОЧТА

'https://graph.facebook.com/<API_VERSION> /<WABA_ID> /subscribed_apps'

\ -H 'Авторизация: Предъявитель<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" }
Обновление номеров телефонов








Получено обновление имени




{

"объект":

"whatsapp_business_account",

"вход":

[ { "id": "495709166956424", "time": 1731617831, "changes": [ { "field": "phone_number_name_update", "value": { "display_phone_number": "124545784358810", "decision": "APPROVED", "requested_verified_name": "WhatsApp", "rejection_reason": null } } ] } ] }
Получено обновление качества




{

"объект":

"whatsapp_business_account",

"вход":

[ { "id": "495709166956424", "time": 1731617831, "changes": [ { "field": "phone_number_quality_update", "value": { "display_phone_number": "124545784358810", "event": "FLAGGED", "current_limit": "TIER_10K" } } ] } ] }
Обновления WABA








Номер тестовой среды повышен до подтвержденного аккаунта




{

"объект":

"whatsapp_business_account",

"вход":

[ { "id": "495709166956424", "time": 1731617831, "changes": [ { "field": "account_update", "value": { "phone_number": "124545784358810", "event": "VERIFIED_ACCOUNT" } } ] } ] }
Аккаунт WhatsApp Business заблокирован




{

"объект":

"whatsapp_business_account",

"вход":

[ { "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 завершена




{

"объект":

"whatsapp_business_account",

"вход":

[ { "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" }

    
        

    


            

        

    


    


    
    

        

             Вернуться наверх