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

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

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

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

Триггеры

Пользователь WhatsApp отправляет сообщение типа, не поддерживаемого Cloud API.Вы используете API для отправки сообщения на номер, уже используемый с API. В этом случае веб-хук отправляется владельцу номера получателя.A WhatsApp user messages a business that has been onboarded with a WhatsApp Business app phone number, for the first time. This is especially common when users tap one of the ~~бизнес'~~бизнес'с ads that click to WhatsApp⁠? and immediately send a message.

Синтаксис

{

"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>",
                "ошибки": [
                  {
                    "code": <ERROR_CODE>,
                    "заголовок": "<ERROR_TITLE>",
                    "message": "<ERROR_MESSAGE>",
                    "error_data": {
                      "details": "<ERROR_DETAILS>"
                    }
                  }
                ],
                "type": "unsupported",
                "unsupported": {
                "тип": <UNSUPPORTED_TYPE>
              }
              }
            ]
          },
          "поле": "сообщения"
        }
      ]
    }
  ]
}

Параметры

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

<BUSINESS_DISPLAY_PHONE_NUMBER>

Нить

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

15550783881

<BUSINESS_PHONE_NUMBER_ID>

Нить

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

106540352242922

<IDENTITY_KEY_HASH>

Нить

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

DF2lS5v2W6x=

<ERROR_CODE>

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

131051 —- Cloud API does not support the message type.131060 —- The message is currently unavailable. This typically occurs when a WhatsApp user messages a business onboarded with a WhatsApp Business app phone number, for the first time.

131051

<ERROR_DETAILS>

Удобочитаемое описание ошибки.

В настоящее время этот тип сообщения не поддерживается.

<ERROR_MESSAGE>

Удобочитаемое сообщение об ошибке. Аналогично ERROR_TITLE .

Тип сообщения неизвестен

<ERROR_TITLE>

Заголовок сообщения об ошибке, понятный человеку. Возможные значения:

Тип сообщения неизвестен —- Corresponds to error code 131051.This message is currently unavailable. —- Corresponds to error code 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.

Шина Нельсон

Пример

The following example shows a webhook triggered by a WhatsApp user sending an unsupported message type (error code 131051). For unavailable messages (error code 131060), the payload structure is the same but the ошибки object values differ —- see the ERROR_CODE parameter for details.

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