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

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

Обновлено: 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 > " d --> }
 ],
 "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.HBgLMTY1MDM4Nzk0MzkVAgASGBQzQUFERjg0NDEzNDd FODU3MUMxMAA=" , "timestamp"
 : "1750090702" , "errors"
 : [ {
 "code"
 : 131051 , "title"
 : "Тип сообщения неизвестен" , "message"
 : "Тип сообщения неизвестен" , "error_data"
 : { "details"
 : "Тип сообщения в настоящее время не поддерживается." }
 }
 ],
 "type"
 : "unsupported" , "unsupported"
 : { "type"
 : "edit" }
 }
 ]
 },
 "field"
 : "messages" }
 ]
 }
 ]
 }