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

Справочная информация по веб-хукам: сообщения об ошибках | Документация для разработчиков

Справочная информация по веб-хукам и сообщениям об ошибках

Обновлено: 22 октября 2025 г
В этом справочнике описаны события-триггеры и содержимое полезной нагрузки для веб-перехватчика сообщений об ошибках в бизнес-аккаунте WhatsApp .

Триггеры

    Мы не можем обработать запрос из-за системной ошибки.Мы не можем обработать запрос из-за проблемы на уровне приложения или учетной записи.

    Синтаксис

    {
    "object": "whatsapp_business_account", "entry": [ { "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID> ", "изменения": [ { "значение": { "messaging_product": "whatsapp", "метаданные": { "отображаемый_номер_телефона": "<BUSINESS_DISPLAY_PHONE_NUMBER> ", "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID> " }, "errors": [ { "code":<ERROR_CODE> , "заголовок": "<ERROR_TITLE> ", "сообщение": "<ERROR_MESSAGE> ", "error_data": { "details": "<ERROR_DETAILS> " }, "href": "<ERROR_CODES_URL> " } ] }, "field": "messages" } ] } ] }

    Параметры

    Заполнитель Описание Пример значения
    <BUSINESS_DISPLAY_PHONE_NUMBER>
    Нить
    Номер телефона компании, отображаемый на экране.
    15550783881
    <BUSINESS_PHONE_NUMBER_ID>
    Нить
    Идентификатор номера служебного телефона.
    106540352242922
    <ERROR_CODE>
    Целое число
    130429
    <ERROR_CODES_URL>
    Нить
    /docs/whatsapp/cloud-api/support/error-codes/
    <ERROR_DETAILS>
    Нить
    Сообщение не удалось отправить, поскольку с этого номера телефона за короткий промежуток времени было отправлено слишком много сообщений
    <ERROR_MESSAGE>
    Нить
    об ошибке . Это значение совпадает со title .
    Сработал лимит запросов
    <ERROR_TITLE>
    Нить
    Код ошибки (заголовок). Это значение совпадает со сообщения .
    Сработал лимит запросов
    <WHATSAPP_BUSINESS_ACCOUNT_ID>
    Нить
    Идентификатор бизнес-аккаунта WhatsApp.
    102290129340398

    Пример

    
    
    { "object": "whatsapp_business_account", "entry": [ { "id": "102290129340398", "changes": [ { "value": { "messaging_product": "whatsapp", "metadata": { "display_phone_number": "15550783881", "phone_number_id": "106540352242922" }, "errors": [ { "code": 130429, "title": "Превышен лимит скорости", "message": "Превышен лимит скорости", "error_data": { "details": "Сообщение не удалось отправить, так как с этого номера телефона было отправлено слишком много сообщений за короткий период времени" }, "href": "/documentation/business-messaging/whatsapp/support/error-codes" } ] }, "field": "messages" } ] } ] }