Переопределение веб-хуков | Документация для разработчиков
Переопределения веб-перехватчиков
Обновлено: 23 марта 2026 г
Веб-хуки отправляются на URL-адрес обратного вызова, заданный в вашем приложении, но вы можете переопределить это для своего приложения, указав альтернативный URL-адрес обратного вызова для бизнес-аккаунта WhatsApp (WABA) или номера телефона компании.
поддерживаемого поля срабатывает веб-хук , система сначала проверяет, назначило ли ваше приложение альтернативный URL-адрес обратного вызова для номера телефона компании, связанного с событием. Если да, веб-хук отправляется на ваш альтернативный URL-адрес обратного вызова. Если у номера телефона нет альтернативного URL-адреса, система проверяет, есть ли у связанного с номером WABA альтернативный URL-адрес обратного вызова, и если да, отправляет его туда. Если у WABA также нет альтернативного URL-адреса, веб-хук возвращается к URL-адресу обратного вызова вашего приложения.
Поддерживаемые поля веб-перехватчика
Данное изменение применяется только к следующим типам полей веб-хуков. Веб-хуки для типов полей, не перечисленных здесь, всегда отправляются на URL-адрес обратного вызова по умолчанию вашего приложения.
сообщенияmessage_echoesзвонкипрофиль потребителяпереадресации сообщенийgroup_lifecycle_updategroup_participants_updategroup_settings_updategroup_status_updatesmb_message_echoessmb_app_state_syncисторияaccount_settings_updateПримечание: Веб-хуки шаблонов (message_template_status_update,message_template_quality_update,message_template_components_update,template_category_update) и веб-хуки уровня учетной записи (account_update,account_review_update,account_alerts) не поддерживают переопределение обратных вызовов. Эти веб-хуки всегда доставляются по URL-адресу обратного вызова по умолчанию вашего приложения.
Требования
Прежде чем устанавливать альтернативный URL-адрес обратного вызова, убедитесь, что ваше приложение подписано на веб-хуки в WABA , и проверьте, что ваша альтернативная конечная точка обратного вызова может корректно принимать и обрабатывать веб-хуки.
Установить альтернативный обратный вызов WABA
Используйте POST /
Синтаксис запроса
ПОЧТА /<WABA_ID> /subscribed_apps
Пост тело
{ "override_callback_uri":"<WABA_ALT_CALLBACK_URL> ", "verify_token":"<WABA_ALT_CALLBACK_URL_TOKEN> " }Параметры тела
| Заполнитель | Описание | Пример значения |
|---|---|---|
<WABA_ALT_CALLBACK_URL> | Необходимый. Альтернативный URL-адрес обратного вызова, куда следует отправлять поддерживаемые веб-хуки Максимум 200 символов. | https://my-waba-alternate-callback.com/webhook |
<WABA_ALT_CALLBACK_URL_TOKEN> | Мой голос - мой паспорт? |
Ответ
В случае успеха:
{ "success": true }Пример запроса
curl -X POST \ 'https://graph.facebook.com/v25.0/102290129340398/subscribed_apps' \ -H 'Authorization: Bearer EAAJi...' \ -H 'Content-Type: application/json' \ -d ' { "override_callback_uri":"https://my-waba-alternate-callback.com/webhook", "verify_token":"myvoiceismypassport?" }'
Пример ответа
{ "success": true }Получите альтернативный обратный звонок от WABA
Используйте GET /
override_callback_uri Пример ответа
{ "data" : [ { "whatsapp_business_api_data" : { "id" : "670843887433847", "link" : "https://www.facebook.com/games/?app_id=67084...", "name" : "Lucky Shrub" }, "override_callback_uri" : "https://my-waba-alternate-callback.com/webhook" } ] }Удалить альтернативный обратный вызов WABA
Используйте POST /
Установить номер телефона для альтернативного обратного вызова
Используйте POST /
Синтаксис запроса
ПОЧТА /<BUSINESS_PHONE_NUMBER_ID>
Пост тело
{ "webhook_configuration": { "override_callback_uri": "<PHONE_ALT_CALLBACK_URL> ", "verify_token": "<PHONE_ALT_CALLBACK_URL_TOKEN> " } }Параметры тела
| Заполнитель | Описание | Пример значения |
|---|---|---|
<PHONE_ALT_CALLBACK_URL> | Необходимый. Альтернативный URL-адрес обратного вызова, куда следует отправлять поддерживаемые веб-хуки Максимум 200 символов. | https://my-phone-alternate-callback.com/webhook |
<PHONE_ALT_CALLBACK_URL_TOKEN> | Мой голос - мой паспорт? |
Ответ
В случае успеха:
{ "success": true }Пример запроса
curl -X POST 'https://graph.facebook.com/v25.0/106540352242922' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer EAAJB...' \ -d ' { "webhook_configuration": { "override_callback_uri": "https://my-phone-alternate-callback.com/webhook", "verify_token": "myvoiceismypassport?" } }'
Пример ответа
{ "success": true }Получить альтернативный номер телефона для обратного звонка
Используйте GET /
webhook_configuration , чтобы убедиться, что для номера телефона компании указан альтернативный URL-адрес обратного вызова.Синтаксис запроса
ПОЛУЧАТЬ /<BUSINESS_PHONE_NUMBER_ID> ?fields=webhook_configuration
Ответ
В случае успеха:
{ "webhook_configuration": { "phone_number": "<PHONE_ALT_CALLBACK_URL> ", "whatsapp_business_account": "<WABA_ALT_CALLBACK_URL> ", "приложение": "<APP_CALLBACK_URL> " }, "id": "106540352242922" }Обратите внимание, что
параметр whatsapp_business_account включается только в том случае, если для WABA-кода, связанного с рабочим номером телефона, также указан альтернативный URL-адрес обратного вызова.Пример запроса
curl 'https://graph.facebook.com/v17.0/106540352242922?fields=webhook_configuration' \ -H 'Авторизация: Bearer EAAJB...'
Пример ответа
{ "webhook_configuration": { "phone_number": "https://my-phone-alternate-callback.com/webhook", "whatsapp_business_account": "https://my-waba-alternate-callback.com/webhook", "application": "https://my-production-callback.com/webhook" }, "id": "106540352242922" }Удалить альтернативный номер телефона для обратного звонка
Чтобы удалить альтернативный URL-адрес обратного вызова для номера корпоративного телефона, используйте POST-запрос /
override_callback_uri , установленным в пустую строку:{ "webhook_configuration": { "override_callback_uri": "" } }
Комментарии отсутствуют
Комментарии отсутствуют