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

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

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

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

Триггеры

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

Синтаксис

{

"object": "whatsapp_business_account",
  "вход": [
    {
      "идентификатор": "<Идентификатор бизнес-аккаунта WhatsApp>",
      "изменения": [
        {
          "ценить": {
            "messaging_product": "whatsapp",
            "метаданные": {
              "display_phone_number": "<НОМЕР ТЕЛЕФОНА ДЛЯ ОТОБРАЖЕНИЯ НА ТЕЛЕФОНЕ>",
              "phone_number_id": "<Идентификатор номера бизнес-телефона>"
            },
            "контакты": [
              {
                "профиль": {
                  "имя": "<ИМЯ_ПОЛЬЗОВАТЕЛЯ_WHATSAPP>"
                },
                "wa_id": "<Идентификатор_пользователя_WhatsApp>",
                "identity_key_hash": "<IDENTITY_KEY_HASH>" <!-- only included if identity change check enableд -->
              }
            ],
            "сообщения": [
              {
                "от": "<Номер телефона пользователя WhatsApp>",
                "идентификатор": "<Идентификатор сообщения WhatsApp>",
                "временная метка": "<WEBHOOK_TRIGGER_TIMESTAMP>",
                "ошибки": [
                  {
                    "код": <КОД ОШИБКИ>,
                    "заголовок": "<ЗАГОЛОВОК ОШИБКИ>",
                    "сообщение": "<СООБЩЕНИЕ ОБ ОШИБКЕ>",
                    "error_data": {
                      "подробности": "<ПОДРОБНОСТИ ОШИБКИ>"
                    }
                  }
                ],
                "type": "unsupported",
                "неподдерживаемый": {
                "тип": <UNSUPPORTED_TYPE>
              }
              }
            ]
          },
          "поле": "сообщения"
        }
      ]
    }
  ]
}

Параметры

Заполнитель Описание Пример значения

<BUSINESS_DISPLAY_PHONE_NUMBER>

Нить

Номер телефона компании, отображаемый на экране.

15550783881

<BUSINESS_PHONE_NUMBER_ID>

Нить

Идентификатор номера служебного телефона.

106540352242922

<IDENTITY_KEY_HASH>

Нить

Хэш ключа идентификации. Включается только в том случае, если включена проверки изменений идентификатора .

DF2lS5v2W6x=

<ERROR_CODE>

Код ошибки. Возможные значения:

131051 —- Cloud 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), структура полезной нагрузки та же, но ошибки Значения объектов различаются —- смотрите КОД ОШИБКИ Для получения подробной информации используйте параметр.

{
"объект": "whatsapp_business_account",
"вход": [
    {
"идентификатор": "102290129340398",
"изменения": [
        {
"ценить": {
"messaging_product": "WhatsApp",
"метаданные": {
"display_phone_number": "15550783881",
"идентификатор_номера_телефона": "106540352242922"
            },
"контакты": [
              {
"профиль": {
"имя": «Шина Нельсон»
                },
"ва_ид": "16505551234"
              }
            ],
"сообщения": [
              {
"от": "16505551234",
"идентификатор": "wamid.HBgLMTY1MDM4Nzk0MzkVAgASGBQzQUFERjg0NDEzNDdFODU3MUMxMAA=",
"временная метка": "1750090702",
"ошибки": [
                  {
"код": 131051,
"заголовок": "Тип сообщения неизвестен",
"сообщение": "Тип сообщения неизвестен",
"error_data": {
"подробности": «Тип сообщения в настоящее время не поддерживается»
                    }
                  }
                ],
"тип": "неподдерживаемый",
"неподдерживаемый": {
"тип": "редактировать"
    }
              }
            ]
          },
"поле": "сообщения"
        }
      ]
    }
  ]
}