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

Аккаунты WhatsApp Business (WABA) и их ресурсы являются объектами в социальной сети Facebook. Когда с одним из этих объектов происходит событие-триггер, Facebook его видит и отправляет уведомление на URL-адрес веб-перехватчика, указанный на панели управления вашего приложения Facebook.

В контексте встроенной регистрации вы можете использовать веб-хуки для получения уведомлений об изменениях в ваших WABA-кодах, номерах телефонов, шаблонах сообщений и сообщениях, отправленных на ваши номера телефонов.

Необходимо индивидуально подписаться на каждый WABA-сервер, от которого вы хотите получать веб-хуки. После получения WABA-идентификатора клиента, подпишите ваше приложение на этот идентификатор, чтобы начать получать веб-хуки.

см разделе «Веб-хуки» Дополнительную информацию о веб-хуках и полях

В случае успеха:

Повторите этот процесс для любых других WABA, для которых вы хотите получать уведомления через веб-хуки. Обратите внимание, что если вы подпишете свое приложение на веб-хуки для нескольких WABA, все уведомления через веб-хуки будут отправляться на URL-адрес обратного вызова приложения, указанный на «Веб-хуки» в панели управления приложением, если вы не отключите веб-хуки.

Чтобы получить список приложений, подписанных на веб-хуки для WABA, отправьте GET-запрос к subscribed_apps на WABA:

Чтобы отменить подписку вашего приложения на веб-хуки для бизнес-аккаунта WhatsApp, отправьте запрос DELETE на subscribed_apps в WABA.

См. раздел «Переопределение веб-перехватчиков».

Вы можете настроить веб-хуки для отправки уведомлений об изменениях в ваших аккаунтах WhatsApp Business, на которые вы подписаны. Вы можете подписаться на следующие типы уведомлений:

Название поля	Описание
account_alerts	Веб account_alerts для корпоративного телефонного номера лимита сообщений, профиля компаниии официального бизнес-аккаунта .
account_review_update	Веб account_review_update уведомляет вас о том, что учетная запись WhatsApp Business была проверена на соответствие нашим правилам.
account_update	уведомляет -хук account_update WhatsApp Business бизнес-подтверждения, предоставленных партнером , о международной аутентификации или об основном местоположении бизнеса, когда учетная запись передается партнеру по решениям, о нарушениях политики или условий, об удалении, повторном подключении или об удалении учетной записи.
автоматические события	automatic_events , который отправил вам сообщение через вашу рекламу Click to WhatsApp, если вы включили по автоматическим событиям .
обновление_возможностей_бизнеса	Веб business_capability_update уведомляет вас об изменениях в возможностях бизнес-аккаунта WhatsApp или бизнес-портфеля (лимиты на сообщения, лимиты на номера телефонови т. д.).
история	Веб истории используется для синхронизации истории чатов в приложении WhatsApp Business для бизнес-клиентов, подключенных поставщиком решений.
message_template_components_update	Веб message_template_components_update уведомляет вас об изменениях в компонентах шаблона.
message_template_quality_update	Веб message_template_quality_update шаблона оценке качества.
message_template_status_update	Веб message_template_status_update уведомляет вас об изменениях статуса существующего шаблона.
сообщения	Веб сообщений описывает сообщения, отправленные пользователем WhatsApp компании, а также статус сообщений, отправленных компанией пользователю WhatsApp.
партнерские_решения	Веб -хук partner_solutions описывает изменения статуса многопартнерского решения.
payment_configuration_update	уведомляет перехватчик payment_configuration_update вас об изменениях в конфигурации платежей для Payments API India и Payments API Brazil.
номер_имя_телефона_обновление	Веб phone_number_name_update уведомляет вас о проверки отображаемого имени .
обновление_качества_телефонного_номера	Веб phone_number_quality_update бизнес-телефонного номера уровня пропускной способности.
безопасность	Веб безопасности уведомляет вас об изменениях в настройках безопасности корпоративного телефонного номера.
smb_app_state_sync	Веб smb_app_state_sync используется для синхронизации контактов пользователей приложения WhatsApp Business, которые были подключены через поставщика решений.
smb_message_echoes	Веб smb_message_echoes уведомляет вас о сообщениях, отправленных через приложение WhatsApp Business или сопутствующее («связанное») устройство бизнес-клиентом, подключенным к Cloud API через поставщика решений.
template_category_update	Веб template_category_update шаблона категории.
пользовательские_настройки	Веб user_preferences пользователем WhatsApp настройках получения маркетинговых сообщений.