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

Справочник по веб-перехватчикам неподдерживаемых сообщений

Обновлено: 20 марта 2026 г

бизнес-аккаунта WhatsApp сообщений для неподдерживаемых сообщений.

Триггеры

Пользователь WhatsApp отправляет сообщение типа, не поддерживаемого Cloud API.Вы используете API для отправки сообщения на номер, уже используемый с API. В этом случае веб-хук отправляется владельцу номера получателя.отправляет сообщение компании, которая зарегистрирована в приложении WhatsApp Business, используя свой номер телефонавпервые рекламных объявлений компании, которое ведет в WhatsApp, и сразу же отправляют сообщение.

Синтаксис

{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
              "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>"
            },
            "contacts": [
              {
                "profile": {
                  "name": "<WHATSAPP_USER_PROFILE_NAME>"
                },
                "wa_id": "<WHATSAPP_USER_ID>",
                "identity_key_hash": "<IDENTITY_KEY_HASH>" <!-- only included if identity change check enabled -->
              }
            ],
            "messages": [
              {
                "from": "<WHATSAPP_USER_PHONE_NUMBER>",
                "id": "<WHATSAPP_MESSAGE_ID>",
                "timestamp": "<WEBHOOK_TRIGGER_TIMESTAMP>",
                "errors": [
                  {
                    "code": <ERROR_CODE>,
                    "title": "<ERROR_TITLE>",
                    "message": "<ERROR_MESSAGE>",
                    "error_data": {
                      "details": "<ERROR_DETAILS>"
                    }
                  }
                ],
                "type": "unsupported",
                "unsupported": {
                "type": <UNSUPPORTED_TYPE>
              }
              }
            ]
          },
          "field": "messages"
        }
      ]
    }
  ]
}

Параметры

Заполнитель	Описание	Пример значения
`<BUSINESS_DISPLAY_PHONE_NUMBER>` Нить	Номер телефона компании, отображаемый на экране.	`15550783881`
`<BUSINESS_PHONE_NUMBER_ID>` Нить	Идентификатор номера служебного телефона.	`106540352242922`
`<IDENTITY_KEY_HASH>` Нить	Хэш ключа идентификации. Включается только в том случае, если включена проверки изменений идентификатора .	`DF2lS5v2W6x=`
`<ERROR_CODE>`	Код ошибки. Возможные значения: `131051` — API облачных сервисов не поддерживает этот тип сообщений.`131060` — Сообщение в данный момент недоступно. Обычно это происходит, когда пользователь WhatsApp , зарегистрированной в приложении WhatsApp Business, используя номер телефонавпервые	`131051`
`<ERROR_DETAILS>`	Удобочитаемое описание ошибки.	`В настоящее время этот тип сообщения не поддерживается.`
`<ERROR_MESSAGE>`	Удобочитаемое сообщение об ошибке. Аналогично `ERROR_TITLE`.	`Тип сообщения неизвестен`
`<ERROR_TITLE>`	Заголовок сообщения об ошибке, понятный человеку. Возможные значения: `Тип сообщения неизвестен` — соответствует коду ошибки `131051`.`Это сообщение в данный момент недоступно.` — Соответствует коду ошибки `131060`.	`Тип сообщения неизвестен`
`<UNSUPPORTED_TYPE>`	Содержит сообщение неподдерживаемого типа. Возможные значения: `ошибки` `гифка` `групповое приглашение` `хсм` `изображение` `интерактивный` `keep_in_chat` `ссылка_предварительный просмотр` `список` `расположение` `медиа_заполнитель` `заказ` `приколоть` `создание опроса` `poll_update` `продукт` `реакция`	`poll_update`
`<WEBHOOK_TRIGGER_TIMESTAMP>` Нить	Временная метка Unix, указывающая на момент срабатывания веб-перехватчика.	`1739321024`
`<WHATSAPP_BUSINESS_ACCOUNT_ID>` Нить	Идентификатор бизнес-аккаунта WhatsApp.	`102290129340398`
`<WHATSAPP_MESSAGE_ID>` Нить	Идентификатор сообщения WhatsApp.	`wamid.HBgLMTY1MDM4Nzk0MzkVAgASGBQzQUFERjg0NDEzNDdFODU3MUMxMAA=`
`<WHATSAPP_USER_ID>` Нить	Идентификатор пользователя WhatsApp. Обратите внимание, что идентификатор пользователя WhatsApp и номер телефона могут не всегда совпадать.	`16505551234`
`<WHATSAPP_USER_PHONE_NUMBER>` Нить	Номер телефона пользователя WhatsApp. Это то же значение, которое возвращает API в качестве `входного` значения при отправке сообщения пользователю WhatsApp. Обратите внимание, что номер телефона и идентификатор пользователя WhatsApp могут не всегда совпадать.	`+16505551234`
`<WHATSAPP_USER_PROFILE_NAME>` Нить	Имя пользователя WhatsApp, как оно отображается в его профиле в клиенте WhatsApp.	`Шина Нельсон`

Пример

В следующем примере показан веб-хук, срабатывающий при отправке пользователем WhatsApp сообщения неподдерживаемого типа (код ошибки 131051). Для недоступных сообщений (код ошибки 131060) структура полезной нагрузки та же, но ошибок отличаются — ERROR_CODE подробности см. в параметре

{
"object": "whatsapp_business_account",
"entry": [
    {
"id": "102290129340398",
"changes": [
        {
"value": {
"messaging_product": "whatsapp",
"metadata": {
"display_phone_number": "15550783881",
"phone_number_id": "106540352242922"
            },
"contacts": [
              {
"profile": {
"name": "Sheena Nelson"
                },
"wa_id": "16505551234"
              }
            ],
"messages": [
              {
"from": "16505551234",
"id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgASGBQzQUFERjg0NDEzNDdFODU3MUMxMAA=",
"timestamp": "1750090702",
"errors": [
                  {
"code": 131051,
"title": "Тип сообщения неизвестен",
"message": "Тип сообщения неизвестен",
"error_data": {
"details": "Тип сообщения в настоящее время не поддерживается."
                    }
                  }
                ],
"type": "unsupported",
"unsupported": {
"type": "edit"
    }
              }
            ]
          },
"field": "messages"
        }
      ]
    }
  ]
}