Переопределение веб-хуков | Документация для разработчиков
Переопределения веб-перехватчиков
Обновлено: 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 альтернативный обратный звонок
Синтаксис запроса
ПОЧТА /<WABA_ID> /subscribed_apps
Пост тело
{ "override_callback_uri":"<WABA_ALT_CALLBACK_URL> ", "verify_token":"<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 / Конечная точка для получения списка всех приложений, подписанных на веб-хуки в WABA. Ответ должен содержать
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
Используйте ПОЧТА /<WABA_ID> /subscribed_apps Конечная точка для подписки вашего приложения на веб-хуки в WABA как обычно (то есть без каких-либо параметров тела сообщения). Это удалит альтернативный вариант конечная точкаконечная точкаURL-адрес обратного вызова от WABA и веб-хуки для WABA будут снова отправляться на URL-адрес обратного вызова, заданный в панели управления приложения.
Набор
альтернативный номер телефона для обратного звонка
Синтаксис запроса
ПОЧТА /<BUSINESS_PHONE_NUMBER_ID>
Пост тело
{ "webhook_configuration": { "override_callback_uri": "<PHONE_ALT_CALLBACK_URL> ", "verify_token": "<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 }
Получить альтернативный номер телефона для обратного звонка
webhook_configurationСинтаксис запроса
ПОЛУЧАТЬ /<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Пример запроса
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-адреса для обратного вызова используйте.. ПОЧТА /<BUSINESS_PHONE_NUMBER_ID> конечная точка с
override_callback_uri свойство установлено в пустую строку:{ "webhook_configuration": { "override_callback_uri": "" } }