> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# whatsapp.smb.message.created

> Происходит при отправке сообщения из приложения WhatsApp Business.

Используйте `whatsapp.smb.message.created` для обработки этого события на вашей конечной точке Webhook.

## Триггеры

Происходит при отправке сообщения из приложения WhatsApp Business.

Подпишитесь на `whatsapp.smb.message.created`, когда будете [настраивать конечную точку Webhook](https://docs.ycloud.com/ru/api-reference/guides/api-fundamentals/configure-webhooks.md).

## Синтаксис

YCloud отправляет HTTP-запрос `POST` на настроенный вами URL Webhook. Следующая структура показывает один из вариантов полезной нагрузки. Значения в угловых скобках являются плейсхолдерами; их типы перечислены в разделе **Параметры**. Необязательные поля и другие варианты описаны ниже.

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "id": "<ID>",
  "type": "whatsapp.smb.message.created",
  "apiVersion": "<API_VERSION>",
  "createTime": "<CREATE_TIME>",
  "whatsappMessage": {
    "id": "<ID>",
    "wamid": "<WAMID>",
    "wabaId": "<WABA_ID>",
    "from": "<FROM>",
    "to": "<TO>",
    "type": "<TYPE>",
    "text": {
      "body": "<BODY>"
    },
    "status": "<STATUS>",
    "createTime": "<CREATE_TIME>",
    "sendTime": "<SEND_TIME>"
  }
}
```

## Параметры

Проверяйте HTTP-заголовок `YCloud-Signature` перед обработкой тела JSON. См. раздел [проверка подписи](https://docs.ycloud.com/ru/api-reference/guides/api-fundamentals/configure-webhooks.md).

### Конверт события

| Параметр | Тип | Обязательный | Описание |
| - | - | - | - |
| `id` | string | Да | Уникальный идентификатор события. Минимальная длина: `6`. Максимальная длина: `128`. |
| `type` | string | Да | Всегда `whatsapp.smb.message.created`. |
| `apiVersion` | string | Да | Версия API, использованная для формирования этого события. |
| `createTime` | string (date-time) | Да | Время создания этого события в формате [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339). Например, `2022-06-01T12:00:00.000Z`. |

### Полезная нагрузка события

| Параметр | Тип | Обязательный | Описание |
| - | - | - | - |
| `whatsappMessage` | object | Нет | Специфичная для события полезная нагрузка `whatsappMessage`. |

Четыре общих поля конверта являются обязательными. Поля полезной нагрузки зависят от варианта события. В каждой таблице объектов статус **Обязательный** применяется, если присутствует родительский объект. Необязательные поля могут быть опущены; наличие поля в примере не делает его обязательным.

#### whatsappMessage

| Параметр | Тип | Обязательный | Описание |
| - | - | - | - |
| `id` | string | Да | Уникальный идентификатор сообщения. |
| `wamid` | string | Нет | Исходный идентификатор сообщения на платформе WhatsApp. |
| `wabaId` | string | Да | Идентификатор WhatsApp Business Account. |
| `from` | string | Да | Номер телефона отправителя в формате [E.164](https://en.wikipedia.org/wiki/E.164). |
| `to` | string | Нет | Номер телефона получателя в формате [E.164](https://en.wikipedia.org/wiki/E.164). |
| `recipient` | string | Нет | Значение получателя, переданное в запросе при использовании BSUID или родительского BSUID. |
| `recipientUserId` | string | Нет | Идентификатор пользователя WhatsApp Business-scoped (BSUID) получателя. |
| `toUserId` | string | Нет | Псевдоним `recipientUserId`, сохраненный для совместимости. |
| `parentRecipientUserId` | string | Нет | Родительский идентификатор WhatsApp Business-scoped пользователя получателя. |
| `toParentUserId` | string | Нет | Псевдоним `parentRecipientUserId`, сохраненный для совместимости. |
| `customerProfile` | object | Нет | Информация профиля получателя, включая имя пользователя WhatsApp, если оно доступно. |
| `conversation` | object | Нет | WhatsApp определяет переписку как 24-часовую сессию обмена сообщениями между пользователем и компанией. Это поле присутствует после того, как статус сообщения изменяется на `sent`. См. также [Тарифы на основе переписок](https://developers.facebook.com/docs/whatsapp/pricing). |
| `type` | string | Нет | Тип исходящего сообщения WhatsApp. См. также раздел [Сообщения WhatsApp](https://developers.facebook.com/docs/whatsapp/cloud-api/reference/messages).Значения: `template`, `text`, `image`, `audio`, `video`, `document`, `sticker`, `location`, `interactive`, `contacts`, `reaction`. |
| `template` | object | Нет | Используется для отправки сообщения WhatsApp типа `template`. |
| `text` | object | Нет | Объект WhatsApp Message Text. |
| `image` | object | Нет | Используйте для сообщений `image`, `gif`, `video`, `audio`, `document` или `sticker`. См. также раздел [Поддерживаемые типы медиа](https://developers.facebook.com/docs/whatsapp/cloud-api/reference/media#supported-media-types). |
| `video` | object | Нет | Используйте для сообщений `image`, `gif`, `video`, `audio`, `document` или `sticker`. См. также раздел [Поддерживаемые типы медиа](https://developers.facebook.com/docs/whatsapp/cloud-api/reference/media#supported-media-types). |
| `audio` | object | Нет | Используйте для сообщений `image`, `gif`, `video`, `audio`, `document` или `sticker`. См. также раздел [Поддерживаемые типы медиа](https://developers.facebook.com/docs/whatsapp/cloud-api/reference/media#supported-media-types). |
| `document` | object | Нет | Используйте для сообщений `image`, `gif`, `video`, `audio`, `document` или `sticker`. См. также раздел [Поддерживаемые типы медиа](https://developers.facebook.com/docs/whatsapp/cloud-api/reference/media#supported-media-types). |
| `sticker` | object | Нет | Используйте для сообщений `image`, `gif`, `video`, `audio`, `document` или `sticker`. См. также раздел [Поддерживаемые типы медиа](https://developers.facebook.com/docs/whatsapp/cloud-api/reference/media#supported-media-types). |
| `location` | object | Нет | Используйте для сообщений `location`. |
| `interactive` | object | Нет | Используйте для сообщений `interactive`. |
| `contacts` | object\[] | Нет | Элементы массива описаны ниже. |
| `reaction` | object | Нет | Когда пользователь реагирует на сообщение с помощью эмодзи, типу сообщения присваивается значение `reaction`, и это поле включается. |
| `context` | object | Нет | Используется для указания конкретного сообщения, на которое вы отвечаете. Ответ может быть сообщением любого типа. |
| `externalId` | string | Нет | Уникальная (рекомендуется) строка для ссылки на объект. Это может быть номер заказа или аналогичный идентификатор, который можно использовать для сверки объекта с вашими внутренними системами. |
| `category` | string | Нет | Категория Direct Send, например `utility` или `authentication`, если применимо. |
| `ttlSeconds` | integer | Нет | Настроенный срок жизни сообщения Direct Send в секундах, если применимо. |
| `status` | string | Нет | Статус сообщения WhatsApp. Одно из значений: `accepted`, `failed`, `sent`, `delivered`, `read`.<ul><li>`accepted`: запрос на отправку сообщения принят нашей системой.</li><li>`failed`: не удалось отправить сообщение, отправленное вашей компанией.</li><li>`sent`: сообщение, отправленное вашей компанией, находится в процессе доставки в системах WhatsApp.</li><li>`delivered`: сообщение, отправленное вашей компанией, доставлено на устройство пользователя.</li><li>`read`: сообщение, отправленное вашей компанией, прочитано пользователем.</li></ul> |
| `errorCode` | string | Нет | Код ошибки, если статус сообщения — `failed`. |
| `errorMessage` | string | Нет | Текст ошибки, если статус сообщения — `failed`. |
| `createTime` | string (date-time) | Нет | Время создания этого сообщения в формате [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339), например `2022-06-01T12:00:00.000Z`. |
| `updateTime` | string (date-time) | Нет | Время обновления этого сообщения в формате [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339), например `2022-06-01T12:00:00.000Z`. |
| `sendTime` | string (date-time) | Нет | Время, когда `status` этого сообщения изменился на `sent`, в формате [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339), например `2022-06-01T12:00:00.000Z`. |
| `deliverTime` | string (date-time) | Нет | Время, когда `status` этого сообщения изменился на `delivered`, в формате [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339), например `2022-06-01T12:00:00.000Z`. |
| `readTime` | string (date-time) | Нет | Время, когда это сообщение `status` изменилось на `read`, в формате [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339). Например, `2022-06-01T12:00:00.000Z`. |
| `totalPrice` | number (double) | Нет | Итоговая стоимость этого сообщения. **Примечание: это лишь предварительная расчетная стоимость, когда `status` имеет значение `accepted` или `sent`. Она становится окончательной ценой после доставки сообщения, то есть когда `status` равен `delivered` или `read`.**Для сообщений с максимальной ценой (Max Price) сумма в момент отправки является ориентировочной. Используйте событие whatsapp.message.updated со статусом delivered/read для получения окончательной стоимости; maxBid не является окончательной списанной суммой. |
| `currency` | string | Нет | Валюта цены. [Код валюты ISO 4217](https://en.wikipedia.org/wiki/ISO_4217). |
| `regionCode` | string | Нет | [Код региона](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) номера телефона получателя. |
| `pricingCategory` | string | Нет | Тарифная категория сообщения. **Примечание: это лишь предварительная тарифная категория, когда `status` имеет значение `accepted` или `sent`. Она становится окончательной после доставки сообщения, то есть когда `status` равен `delivered` или `read`.**Значения: `referral_conversion`, `authentication`, `authentication_international`, `marketing`, `marketing_lite`, `utility`, `service`, `marketing_lite_bidding`. |
| `pricingModel` | string | Нет | Модель ценообразования сообщения.<ul><li>`PMP`: применяется тарификация за каждое сообщение (Per-message pricing).</li><li>`CBP`: применяется тарификация на основе переписок (Conversation-based pricing).</li></ul> |
| `pricingType` | string | Нет | Тип тарификации сообщения. Это поле доступно только в режиме PMP (Per-Message Pricing).<ul><li>`regular`: указывает, что сообщение подлежит оплате.</li><li>`free_customer_service`: указывает, что сообщение бесплатно, поскольку оно является сервисным шаблонным сообщением (utility template) или нешаблонным сообщением, отправленным в рамках окна клиентского обслуживания.</li><li>`free_entry_point`: указывает, что сообщение бесплатно, так как оно является частью переписки через бесплатную точку входа.</li></ul> |
| `whatsappApiError` | object | Нет | Исходный объект ошибки, возвращенный WhatsApp. См. [Handling Errors](https://developers.facebook.com/docs/graph-api/guides/error-handling), [Cloud API Error Codes](https://developers.facebook.com/docs/whatsapp/cloud-api/support/error-codes). |
| `bizType` | string | Нет | Может быть пустым либо принимать одно из значений: `whatsapp` или `verify`. По умолчанию: `whatsapp`.<ul><li>`whatsapp`: указывает, что сообщение отправлено через продукт **WhatsApp**.</li><li>`verify`: указывает, что сообщение отправлено через продукт **Verify**.</li></ul> |
| `verificationId` | string | Нет | Идентификатор верификации. Включается только когда `bizType` равно `verify`. |
| `bidPricingFlag` | boolean | Нет | True, если сообщение определено как ставка Marketing Lite (Marketing Lite bidding). Его значение pricingCategory — marketing\_lite\_bidding. |

> [accordion] whatsappMessage.customerProfile
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `name` | string | Нет | Имя аккаунта WhatsApp. |
> | `username` | string | Нет | Имя пользователя WhatsApp. |

> [accordion] whatsappMessage.conversation
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `id` | string | Нет | Уникальный идентификатор объекта. |
> | `type` | string | Нет | Тип переписки. Плата взимается при доставке первого бизнес-сообщения этой переписки, открывающего 24-часовую сессию. Таким образом, тип переписки может быть `null` до доставки первого сообщения.<ul><li>`FREE_ENTRY`: переписки, начатые с [бесплатной точки входа](https://developers.facebook.com/docs/whatsapp/pricing#free-entry-point-conversations).</li><li>`FREE_TIER`: переписки в рамках ежемесячного [бесплатного пакета](https://developers.facebook.com/docs/whatsapp/pricing#free-tier-conversations).</li><li>`REGULAR`: любые переписки, которые не были начаты с [бесплатной точки входа](https://developers.facebook.com/docs/whatsapp/pricing#free-entry-point-conversations) или превышают ежемесячный лимит [бесплатного пакета](https://developers.facebook.com/docs/whatsapp/pricing#free-tier-conversations).</li></ul> |
> | `originType` | string | Нет | Указывает [категорию переписки](https://developers.facebook.com/docs/whatsapp/pricing#conversation-categories). Это также может называться точкой входа в переписку.<ul><li>`referral_conversion`: указывает на [переписку с бесплатной точки входа](https://developers.facebook.com/docs/whatsapp/pricing#free-entry-point-conversations).</li><li>`authentication`: указывает, что переписка была открыта компанией путем отправки клиенту шаблона категории `AUTHENTICATION`. Это применяется всегда, когда с момента последнего сообщения клиента прошло более 24 часов.</li><li>`marketing`: указывает, что переписка была открыта компанией путем отправки клиенту шаблона категории `MARKETING`. Это применяется всегда, когда с момента последнего сообщения клиента прошло более 24 часов.</li><li>`utility`: указывает, что переписка была открыта компанией путем отправки клиенту шаблона категории `UTILITY`. Это применяется всегда, когда с момента последнего сообщения клиента прошло более 24 часов.</li><li>`service`: указывает, что переписка была открыта компанией путем ответа клиенту в пределах [окна обслуживания клиентов](https://developers.facebook.com/docs/whatsapp/pricing#customer-service-windows).</li></ul> |
> | `expireTime` | string (date-time) | Нет | Дата истечения срока действия переписки в формате [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339), например `2022-06-01T12:00:00.000Z`. |

> [accordion] whatsappMessage.template
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `name` | string | Да | Название шаблона. |
> | `language` | object | Да | Содержит объект языка. Указывает язык, на котором может отображаться шаблон. |
> | `components` | object\[] | Нет | **Обязательно, если указанный шаблон содержит переменные или медиафайлы.** Массив объектов компонентов, содержащих параметры сообщения. |

> [accordion] whatsappMessage.template.language
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `code` | string | Да | Код используемого языка или локали. Принимает форматы как языка, так и языка\_локали (например, en и en\_US). Все коды см. в разделе [Поддерживаемые языки](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/supported-languages). |
> | `policy` | string | Нет | Языковая политика, которой должно следовать сообщение. По умолчанию (и единственный поддерживаемый вариант): `deterministic`, что означает, что WhatsApp доставляет шаблон сообщения в точности на запрошенном языке и локали. |

> [accordion] whatsappMessage.template.components\[]
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `type` | string | Да | Тип компонента.Значения: `header`, `body`, `button`, `limited_time_offer`, `carousel`, `order_status`. |
> | `sub_type` | string | Нет | **Обязательно, если type равен `button`.** Тип кнопки.<ul><li>`quick_reply`: указывает на ранее созданную кнопку быстрого ответа, которая позволяет клиенту отправить предопределенное сообщение.</li><li>`url`: указывает на ранее созданную кнопку URL, которая позволяет клиенту перейти по URL-адресу, сформированному путем добавления параметра text к предопределенному префиксу URL в шаблоне.</li><li>`copy_code`: указывает на ранее созданную кнопку копирования кода, которая позволяет клиенту скопировать текстовую строку (определяемую при отправке шаблона в шаблонном сообщении) в буфер обмена устройства при нажатии пользователем приложения.</li><li>`catalog`: указывает на ранее созданную кнопку каталога, которая позволяет клиенту просматривать ваш каталог товаров.</li><li>`mpm`: указывает на ранее созданную кнопку MPM (многопродуктовое сообщение), которая позволяет клиенту просматривать товары и разделы.</li><li>`flow`: указывает на ранее созданную кнопку flow, которая позволяет клиенту взаимодействовать с [flow](https://developers.facebook.com/docs/whatsapp/flows).</li><li>`order_details`: указывает на ранее созданную кнопку сведений о заказе, которая позволяет клиенту просматривать сведения о заказе.</li></ul> |
> | `index` | integer (int32) | Нет | **Обязательно, если `type` = `button`. Не используется для других типов.** Указывает порядок отображения кнопки, если в шаблоне используется несколько кнопок. Кнопки индексируются с нуля, поэтому при значении 0 кнопка будет отображаться первой, следующая кнопка с индексом 1 появится следом и т. д.Минимум: `0`. Максимум: `9`. |
> | `parameters` | object\[] | Нет | **Обязательно, если `type` = `button`, либо если в соответствующем компоненте шаблона есть переменные, либо если формат `HEADER` шаблона относится к медиа (`IMAGE`, `VIDEO` или `DOCUMENT`).** Массив объектов параметров с содержимым сообщения. |
> | `cards` | object\[] | Нет | Используется для компонентов `carousel`. Предоставляет компоненты карточек, содержащие параметры сообщения. |

> [accordion] whatsappMessage.template.components\[].parameters\[]
>
> | Параметр | Тип | Обязательно | Описание |
> | - | - | - | - |
> | `type` | string | Нет | **Обязательный.** Тип параметра компонента.<ul><li>`text`: используется, когда тип компонента шаблона — `BODY`, либо формат компонента `HEADER` — `TEXT`.</li><li>`image`: используется, когда компонент шаблона `HEADER` имеет тип `IMAGE`.</li><li>`gif`: используется, когда компонент шаблона `HEADER` имеет тип `GIF`.</li><li>`video`: используется, когда компонент шаблона `HEADER` имеет тип `VIDEO`.</li><li>`document`: используется, когда компонент шаблона `HEADER` имеет тип `DOCUMENT`.</li><li>`payload`: используется, когда тип кнопки компонента шаблона — `QUICK_REPLY`.</li><li>`coupon_code`: используется, когда тип кнопки компонента шаблона — `COPY_CODE`.</li><li>`limited_time_offer`: используется, когда тип компонента шаблона — `LIMITED_TIME_OFFER`.</li><li>`action`: используется, когда тип кнопки компонента шаблона — `CATALOG`, `MPM`, `FLOW` или `ORDER_DETAILS`.</li><li>`order_status`: используется, когда подкатегория шаблона — `ORDER_STATUS`.</li><li>`location`: используется, когда компонент шаблона `HEADER` имеет тип `LOCATION`.</li></ul> |
> | `text` | string | Нет | **Обязательно, если `type` = `text`.** Текст сообщения. Для компонента заголовка ограничение составляет 60 символов. Для компонента тела ограничение составляет 1024 символа. Для кнопок с URL указывает суффикс, заданный разработчиком, который добавляется к предварительно определенному префиксу URL в шаблоне. |
> | `payload` | string | Нет | Обязательно для кнопок `quick_reply`. Полезная нагрузка (payload), заданная разработчиком, которая возвращается при нажатии на кнопку в дополнение к отображаемому тексту кнопки. |
> | `coupon_code` | string | Нет | **Обязательно, если `type` = `coupon_code`.** Код купона, копируемый при нажатии клиентом на кнопку. |
> | `image` | object | Нет | **Обязательно, если формат шаблона `HEADER` — `IMAGE`.** |
> | `gif` | object | Нет | **Обязательно, если формат шаблона `HEADER` — `GIF`.** |
> | `video` | object | Нет | **Обязательно, если формат шаблона `HEADER` — `VIDEO`.** |
> | `document` | object | Нет | **Обязательно, если формат шаблона `HEADER` — `DOCUMENT`.** |
> | `limited_time_offer` | object | Нет | Обязательно, если шаблон использует информацию об истечении срока действия предложения. |
> | `action` | object | Нет | Обязательно, если шаблон использует кнопки каталога или MPM (многопродуктового сообщения). |
> | `order_status` | object | Нет | Поля объекта перечислены ниже. |
> | `location` | object | Нет | **Обязательно, если `type` = `location`.** |

> [accordion] whatsappMessage.template.components\[].parameters\[].image
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `id` | string | Нет | \*\*Используйте этот параметр, если медиафайл загружен на серверы WhatsApp.\*\*Укажите ID медиаобъекта, полученный из API загрузки медиа WhatsApp (\[[https://docs.ycloud.com/reference/whatsapp\_media-upload#/](https://docs.ycloud.com/reference/whatsapp_media-upload#/)]\([https://docs.ycloud.com/reference/whatsapp\_media-upload#/)).Примечание](https://docs.ycloud.com/reference/whatsapp_media-upload#/\)\).Примечание). Необходимо указать либо `id`, либо `link`. Если указаны оба параметра, приоритет имеет `id`. |
> | `link` | string | Нет | \*\*Используйте этот параметр при отправке медиафайла напрямую с вашего сервера.\*\*Протокол и URL отправляемого медиафайла. Используйте только с URL HTTP/HTTPS.Примечание. WhatsApp Cloud API кэширует медиаресурсы на 10 минут. Чтобы обеспечить доставку актуального контента, добавляйте к URL случайные параметры строки запроса.Примечание. Необходимо указать либо `id`, либо `link`. Если указаны оба параметра, приоритет имеет `id`, а `link` игнорируется. |
> | `caption` | string | Нет | Описывает указанный медиафайл: `image`, `gif`, `video` или `document`. Не применяется в `header` сообщений типа `template` или `interactive`. |
> | `filename` | string | Нет | Описывает имя файла для указанного документа. Используется только с медиафайлами `document`. |

> [accordion] whatsappMessage.template.components\[].parameters\[].gif
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `id` | string | Нет | \*\*Используйте этот параметр, если медиафайл загружен на серверы WhatsApp.\*\*Укажите ID медиаобъекта, полученный из API загрузки медиа WhatsApp (\[[https://docs.ycloud.com/reference/whatsapp\_media-upload#/](https://docs.ycloud.com/reference/whatsapp_media-upload#/)]\([https://docs.ycloud.com/reference/whatsapp\_media-upload#/)).Примечание](https://docs.ycloud.com/reference/whatsapp_media-upload#/\)\).Примечание). Необходимо указать либо `id`, либо `link`. Если указаны оба параметра, приоритет имеет `id`. |
> | `link` | string | Нет | \*\*Используйте этот параметр при отправке медиафайла напрямую с вашего сервера.\*\*Протокол и URL отправляемого медиафайла. Используйте только с URL HTTP/HTTPS.Примечание. WhatsApp Cloud API кэширует медиаресурсы на 10 минут. Чтобы обеспечить доставку актуального контента, добавляйте к URL случайные параметры строки запроса.Примечание. Необходимо указать либо `id`, либо `link`. Если указаны оба параметра, приоритет имеет `id`, а `link` игнорируется. |
> | `caption` | string | Нет | Описывает указанный медиафайл: `image`, `gif`, `video` или `document`. Не применяется в `header` сообщений типа `template` или `interactive`. |
> | `filename` | string | Нет | Описывает имя файла для указанного документа. Используется только с медиафайлами `document`. |

> [accordion] whatsappMessage.template.components\[].parameters\[].video
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `id` | string | Нет | \*\*Используйте этот параметр, если медиафайл загружен на серверы WhatsApp.\*\*Укажите ID медиаобъекта, полученный из API загрузки медиа WhatsApp (\[[https://docs.ycloud.com/reference/whatsapp\_media-upload#/](https://docs.ycloud.com/reference/whatsapp_media-upload#/)]\([https://docs.ycloud.com/reference/whatsapp\_media-upload#/)).Примечание](https://docs.ycloud.com/reference/whatsapp_media-upload#/\)\).Примечание). Необходимо указать либо `id`, либо `link`. Если указаны оба параметра, приоритет имеет `id`. |
> | `link` | string | Нет | \*\*Используйте этот параметр при отправке медиафайла напрямую с вашего сервера.\*\*Протокол и URL отправляемого медиафайла. Используйте только с URL HTTP/HTTPS.Примечание. WhatsApp Cloud API кэширует медиаресурсы на 10 минут. Чтобы обеспечить доставку актуального контента, добавляйте к URL случайные параметры строки запроса.Примечание. Необходимо указать либо `id`, либо `link`. Если указаны оба параметра, приоритет имеет `id`, а `link` игнорируется. |
> | `caption` | string | Нет | Описывает указанный медиафайл `image`, `gif`, `video` или `document`. Неприменимо в `header` для сообщений `template` или `interactive`. |
> | `filename` | string | Нет | Описывает имя файла для конкретного документа. Используйте только для медиафайлов `document`. |

> [accordion] whatsappMessage.template.components\[].parameters\[].document
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `id` | string | Нет | \*\*Используйте это, если медиафайл загружен на серверы WhatsApp.\*\*Укажите ID медиаобъекта, полученный через API загрузки медиафайлов WhatsApp (\[[https://docs.ycloud.com/reference/whatsapp\_media-upload#/](https://docs.ycloud.com/reference/whatsapp_media-upload#/)]\([https://docs.ycloud.com/reference/whatsapp\_media-upload#/)).Примечание](https://docs.ycloud.com/reference/whatsapp_media-upload#/\)\).Примечание): необходимо указать либо `id`, либо `link`. Если указаны оба, приоритет имеет `id`. |
> | `link` | string | Нет | \*\*Используйте это при отправке медиафайлов напрямую со своего сервера.\*\*Протокол и URL отправляемого медиафайла. Используйте только URL с протоколами HTTP/HTTPS.Примечание: WhatsApp Cloud API кэширует медиаресурсы на 10 минут. Чтобы гарантировать получение актуального содержимого, добавьте к URL случайные параметры строки запроса.Примечание: необходимо указать либо `id`, либо `link`. Если указаны оба, приоритет имеет `id`, а `link` будет проигнорирован. |
> | `caption` | string | Нет | Описывает указанный медиафайл `image`, `gif`, `video` или `document`. Неприменимо в `header` для сообщений `template` или `interactive`. |
> | `filename` | string | Нет | Описывает имя файла для конкретного документа. Используйте только для медиафайлов `document`. |

> [accordion] whatsappMessage.template.components\[].parameters\[].limited\_time\_offer
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `expiration_time_ms` | integer (int64) | Нет | **Обязательно.** Время истечения срока действия кода предложения в виде UNIX timestamp в миллисекундах. |

> [accordion] whatsappMessage.template.components\[].parameters\[].action
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `thumbnail_product_retailer_id` | string | Нет | **Необязательно.** Используется для шаблонных сообщений каталога и MPM. Артикул (SKU) товара. Обозначается как Content ID в Commerce Manager. Миниатюра этого товара будет использоваться в качестве изображения в заголовке сообщения. Если объект `parameters` не указан, будет использовано изображение первого товара из вашего каталога. |
> | `sections` | object\[] | Нет | Используется для шаблонов MPM. Разделы товаров. Можно указать до 10 разделов. |
> | `flow_token` | string | Нет | Используется для кнопок `FLOW`. Токен Flow, созданный компанией для использования в качестве идентификатора. По умолчанию принимает значение `unused`. |
> | `flow_action_data` | object | Нет | Используется для кнопок `FLOW`. Объект JSON с полезной нагрузкой данных для первого экрана. |
> | `order_details` | object | Нет | Обязательно для кнопок `order_details`. |

> [accordion] whatsappMessage.template.components\[].parameters\[].action.sections\[]
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `title` | string | Нет | Текст названия раздела. Не более 24 символов. Markdown не поддерживается.Максимальная длина: `24`. |
> | `product_items` | object\[] | Нет | Массив артикулов (SKU) товаров. Минимум 1 товар на раздел и максимум 30 товаров во всех разделах. |

> [accordion] whatsappMessage.template.components\[].parameters\[].action.sections\[].product\_items\[]
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `product_retailer_id` | string | Нет | Номер артикула (SKU) товара, который должен отображаться в разделе. Номера SKU обозначаются как **Content ID** в [Commerce Manager](https://business.facebook.com/commerce). |

> [accordion] whatsappMessage.template.components\[].parameters\[].action.order\_details
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `currency` | string | Да | Валюта для этого заказа. В настоящее время единственное поддерживаемое значение — `INR`. |
> | `order` | object | Да | Предоставляет параметры заказа: `status`, `items`, `subtotal`, `tax` и т. д. |
> | `reference_id` | string | Да | Уникальный идентификатор заказа, предоставленный компанией. Он чувствителен к регистру, не может быть пустой строкой, может содержать только английские буквы, цифры, символы подчеркивания, дефисы или точки и не должен превышать 35 символов.Значение `reference_id` должно быть уникальным для каждого сообщения order\_details конкретной компании. Если необходимо отправить несколько сообщений order\_details для одного и того же заказа, рекомендуется включить порядковый номер в reference\_id (например, "BM345A-12"), чтобы обеспечить уникальность reference\_id. |
> | `total_amount` | object | Да | Общая сумма заказа. |
> | `type` | string | Да | Тип товаров, оплачиваемых в этом заказе. В настоящее время поддерживаются варианты `digital-goods` и `physical-goods`. |
> | `payment_settings` | object\[] | Да | Настройки оплаты для заказа. |

> [accordion] whatsappMessage.template.components\[].parameters\[].action.order\_details.order
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `status` | string | Нет | Единственное поддерживаемое значение в сообщении `order_details` — `pending`. В сообщении `order_status` значение `status` может быть: `pending`, `processing`, `partially_shipped`, `shipped`, `completed` или `canceled`. |
> | `type` | string | Нет | Единственное поддерживаемое значение — `quick_pay`. При передаче этого поля кнопка «Проверить и оплатить» скрывается, и в сообщении с деталями заказа отображается только кнопка «Оплатить сейчас». |
> | `catalog_id` | string | Нет | Уникальный идентификатор каталога Facebook, используемого компанией. Если вы не укажете это поле, вы должны указать следующие поля внутри объекта items: `country_of_origin`, `importer_name` и `importer_address`. |
> | `items` | object\[] | Нет | Массив товаров в заказе. |
> | `subtotal` | object | Нет | Значение **должно быть равно** сумме `order.amount.value` \* `order.amount.quantity`. |
> | `tax` | object | Нет | Информация о налогах для этого заказа. |
> | `shipping` | object | Нет | Стоимость доставки заказа. |
> | `discount` | object | Нет | Сумма скидки для этого заказа. |
> | `expiration` | object | Нет | Срок действия этого заказа. |
> | `description` | string | Нет | **Необязательно.** Текст для передачи информации, связанной со статусом. Может быть полезен при отправке отмены. Максимальный лимит символов — 120 символов.Максимальная длина: `120`. |

> [accordion] whatsappMessage.template.components\[].parameters\[].action.order\_details.order.items\[]
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `retailer_id` | string | Нет | Идентификатор контента (Content ID) для позиции в заказе из вашего каталога. |
> | `name` | string | Да | Название товара, отображаемое пользователю. Не может превышать 60 символов.Максимальная длина: `60`. |
> | `image` | object | Нет | Пользовательское изображение товара, отображаемое пользователю. |
> | `amount` | object | Да | Цена за единицу товара. |
> | `sale_amount` | object | Нет | Цена со скидкой за единицу товара. Она должна быть меньше исходной суммы. Если поле указано, оно используется для расчета промежуточного итога (subtotal). |
> | `quantity` | integer (int32) | Да | Количество позиций в заказе. |
> | `country_of_origin` | string | Нет | Обязательно, если не указан `catalog_id`. Страна происхождения товара. |
> | `importer_name` | string | Нет | Обязательно, если отсутствует `catalog_id`. Название компании-импортера. |
> | `importer_address` | string | Нет | Обязательно, если не указан `catalog_id`. Адрес компании-импортера. |

> [accordion] whatsappMessage.template.components\[].parameters\[].action.order\_details.order.items\[].image
>
> | Параметр | Тип | Обязательно | Описание |
> | - | - | - | - |
> | `id` | string | Нет | \*\*Используйте это, когда медиафайл загружен на серверы WhatsApp.\*\*Укажите идентификатор медиаобъекта, полученный из WhatsApp media upload API (\[[https://docs.ycloud.com/reference/whatsapp\_media-upload#/](https://docs.ycloud.com/reference/whatsapp_media-upload#/)]\([https://docs.ycloud.com/reference/whatsapp\_media-upload#/)).Примечание](https://docs.ycloud.com/reference/whatsapp_media-upload#/\)\).Примечание): необходимо указать либо `id`, либо `link`. Если указаны оба параметра, приоритет имеет `id`. |
> | `link` | string | Нет | \*\*Используйте это при отправке медиафайлов напрямую с вашего сервера.\*\*Протокол и URL отправляемого медиафайла. Используйте только с URL HTTP/HTTPS.Примечание: WhatsApp Cloud API кэширует медиаресурсы на 10 минут. Чтобы гарантировать актуальность контента, добавьте случайные строки запроса к URL.Примечание: необходимо указать либо `id`, либо `link`. Если указаны оба, приоритет имеет `id`, а `link` будет проигнорирован. |
> | `caption` | string | Нет | Описывает указанный медиафайл: `image`, `gif`, `video` или `document`. Неприменимо в `header` сообщений `template` или `interactive`. |
> | `filename` | string | Нет | Описывает имя файла для конкретного документа. Используйте только с медиафайлами `document`. |

> [accordion] whatsappMessage.template.components\[].parameters\[].action.order\_details.order.items\[].amount
>
> | Параметр | Тип | Обязательно | Описание |
> | - | - | - | - |
> | `offset` | целое число (int32) | Да | Должно быть `100` для `INR`. |
> | `value` | integer (int32) | Да | Положительное целое число, представляющее сумму, умноженную на коэффициент (offset). Например, для ₹12.34 значение равно 1234. |
> | `description` | string | Нет | Используйте только для `tax`, `shipping` или `discount`. Описание суммы. Максимальное количество символов — 60.Максимальная длина: `60`. |
> | `discount_program_name` | string | Нет | Используйте только для `discount`. Текст, используемый для описания поощрительных заказов. Если заказ поощрительный, продавец должен указать эту информацию. Максимальный лимит — 60 символов.Максимальная длина: `60`. |

> [accordion] whatsappMessage.template.components\[].parameters\[].action.order\_details.order.items\[].sale\_amount
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `offset` | integer (int32) | Да | Должно быть `100` для `INR`. |
> | `value` | integer (int32) | Да | Положительное целое число, представляющее сумму, умноженную на коэффициент offset. Например, ₹12.34 соответствует значению 1234. |
> | `description` | string | Нет | Используйте только для `tax`, `shipping` или `discount`. Описание суммы. Максимальная длина — 60 символов.Максимальная длина: `60`. |
> | `discount_program_name` | string | Нет | Используйте только для `discount`. Текст, используемый для обозначения поощрительных заказов. Если заказ поощрительный, продавец должен указать эту информацию. Максимальная длина — 60 символов.Максимальная длина: `60`. |

> [accordion] whatsappMessage.template.components\[].parameters\[].action.order\_details.order.subtotal
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `offset` | integer (int32) | Да | Должно быть `100` для `INR`. |
> | `value` | integer (int32) | Да | Положительное целое число, представляющее сумму, умноженную на коэффициент offset. Например, ₹12.34 соответствует значению 1234. |
> | `description` | string | Нет | Используйте только для `tax`, `shipping` или `discount`. Описание суммы. Максимальная длина — 60 символов.Максимальная длина: `60`. |
> | `discount_program_name` | string | Нет | Используйте только для `discount`. Текст, используемый для обозначения поощрительных заказов. Если заказ поощрительный, продавец должен указать эту информацию. Максимальная длина — 60 символов.Максимальная длина: `60`. |

> [accordion] whatsappMessage.template.components\[].parameters\[].action.order\_details.order.tax
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `offset` | integer (int32) | Да | Должно быть `100` для `INR`. |
> | `value` | integer (int32) | Да | Положительное целое число, представляющее сумму, умноженную на коэффициент offset. Например, ₹12.34 соответствует значению 1234. |
> | `description` | string | Нет | Используйте только для `tax`, `shipping` или `discount`. Описание суммы. Максимальная длина — 60 символов.Максимальная длина: `60`. |
> | `discount_program_name` | string | Нет | Используйте только для `discount`. Текст, используемый для обозначения поощрительных заказов. Если заказ поощрительный, продавец должен указать эту информацию. Максимальная длина — 60 символов.Максимальная длина: `60`. |

> [accordion] whatsappMessage.template.components\[].parameters\[].action.order\_details.order.shipping
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `offset` | integer (int32) | Да | Должно быть `100` для `INR`. |
> | `value` | integer (int32) | Да | Положительное целое число, представляющее сумму, умноженную на коэффициент offset. Например, ₹12.34 соответствует значению 1234. |
> | `description` | string | Нет | Используйте только для `tax`, `shipping` или `discount`. Описание суммы. Максимальная длина — 60 символов.Максимальная длина: `60`. |
> | `discount_program_name` | string | Нет | Используйте только для `discount`. Текст, используемый для определения поощрительных заказов. Если заказ является поощрительным, продавцу необходимо указать эту информацию. Максимальный лимит — 60 символов.Максимальная длина: `60`. |

> [accordion] whatsappMessage.template.components\[].parameters\[].action.order\_details.order.discount
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `offset` | integer (int32) | Да | Должно быть `100` для `INR`. |
> | `value` | integer (int32) | Да | Положительное целое число, представляющее сумму, умноженную на offset. Например, для ₹12.34 значение равно 1234. |
> | `description` | string | Нет | Используйте только для `tax`, `shipping` или `discount`. Описание суммы. Максимальный лимит — 60 символов.Максимальная длина: `60`. |
> | `discount_program_name` | string | Нет | Используйте только для `discount`. Текст, используемый для определения поощрительных заказов. Если заказ является поощрительным, продавцу необходимо указать эту информацию. Максимальный лимит — 60 символов.Максимальная длина: `60`. |

> [accordion] whatsappMessage.template.components\[].parameters\[].action.order\_details.order.expiration
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `timestamp` | string | Да | Строка с меткой времени UTC в секундах, указывающая, когда должен истечь срок действия заказа. Минимальный порог — 300 секунд. |
> | `description` | string | Нет | Текстовое пояснение истечения срока действия.Максимальная длина: `120`. |

> [accordion] whatsappMessage.template.components\[].parameters\[].action.order\_details.total\_amount
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `offset` | integer (int32) | Да | Должно быть `100` для `INR`. |
> | `value` | integer (int32) | Да | Положительное целое число, представляющее сумму, умноженную на offset. Например, для ₹12.34 значение равно 1234. |
> | `description` | string | Нет | Используйте только для `tax`, `shipping` или `discount`. Описание суммы. Максимальный лимит — 60 символов.Максимальная длина: `60`. |
> | `discount_program_name` | string | Нет | Используйте только для `discount`. Текст, используемый для определения поощрительных заказов. Если заказ является поощрительным, продавцу необходимо указать эту информацию. Максимальный лимит — 60 символов.Максимальная длина: `60`. |

> [accordion] whatsappMessage.template.components\[].parameters\[].action.order\_details.payment\_settings\[]
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `type` | string | Да | Должно иметь значение `payment_gateway`. |
> | `payment_gateway` | object | Да | Объект, описывающий информацию о платежном счете. |

> [accordion] whatsappMessage.template.components\[].parameters\[].action.order\_details.payment\_settings\[].payment\_gateway
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `type` | string | Да | Тип платежа. Необходимо указать `billdesk`, `razorpay`, `payu` или `zaakpay`, если вы подключили платежный шлюз BillDesk, Razorpay, PayU или Zaakpay для приема платежей. |
> | `configuration_name` | string | Да | Имя предварительно настроенной конфигурации платежей, используемой для этого заказа; длина не должна превышать 60 символов. Это значение должно совпадать с конфигурацией платежей, настроенной в WhatsApp Business Manager.Максимальная длина: `60`. |
> | `billdesk` | object | Нет | Дополнительная информация для BillDesk. Пользовательские поля (extra) используются для хранения любых сведений, относящихся к конкретному заказу. Для каждого поля extra максимальный лимит составляет 120 символов. |
> | `payu` | object | Нет | Дополнительная информация для PayU. Пользовательские поля (udf) используются для хранения любых сведений, относящихся к конкретному заказу. Для каждого поля UDF максимальный лимит составляет 255 символов. |
> | `razorpay` | object | Нет | Дополнительная информация для Razorpay. |
> | `zaakpay` | object | Нет | Дополнительная информация для Zaakpay. Пользовательские поля (extra) используются для хранения любых сведений, относящихся к конкретному заказу. Для каждого поля extra максимальный лимит составляет 180 символов. |

> [accordion] whatsappMessage.template.components\[].parameters\[].action.order\_details.payment\_settings\[].payment\_gateway.billdesk
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `additional_info1` | string | Нет | Пользовательская информация об этом заказе для BillDesk.Максимальная длина: `120` символов. |
> | `additional_info2` | string | Нет | Пользовательская информация об этом заказе для BillDesk.Максимальная длина: `120` символов. |
> | `additional_info3` | string | Нет | Пользовательская информация об этом заказе для BillDesk.Максимальная длина: `120` символов. |
> | `additional_info4` | string | Нет | Пользовательская информация об этом заказе для BillDesk.Максимальная длина: `120` символов. |
> | `additional_info5` | string | Нет | Пользовательская информация об этом заказе для BillDesk.Максимальная длина: `120` символов. |
> | `additional_info6` | string | Нет | Пользовательская информация об этом заказе для BillDesk.Максимальная длина: `120` символов. |
> | `additional_info7` | string | Нет | Пользовательская информация об этом заказе для BillDesk.Максимальная длина: `120` символов. |

> [accordion] whatsappMessage.template.components\[].parameters\[].action.order\_details.payment\_settings\[].payment\_gateway.payu
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `udf1` | string | Нет | Пользовательская информация об этом заказе для PayU.Максимальная длина: `255` символов. |
> | `udf2` | string | Нет | Пользовательская информация об этом заказе для PayU.Максимальная длина: `255` символов. |
> | `udf3` | string | Нет | Пользовательская информация об этом заказе для PayU.Максимальная длина: `255` символов. |
> | `udf4` | string | Нет | Пользовательская информация об этом заказе для PayU.Максимальная длина: `255` символов. |

> [accordion] whatsappMessage.template.components\[].parameters\[].action.order\_details.payment\_settings\[].payment\_gateway.razorpay
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `receipt` | string | Нет | Номер квитанции, соответствующий этому заказу, задаваемый для внутренних ссылок. Поддерживается максимальная длина 40 символов при минимальной длине более 0 символов. |
> | `notes` | object | Нет | Объект может представлять собой пары «ключ-значение» максимум с 15 ключами, при этом длина каждого значения ограничена 256 символами. |

> [accordion] whatsappMessage.template.components\[].parameters\[].action.order\_details.payment\_settings\[].payment\_gateway.zaakpay
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `extra1` | string | Нет | Пользовательская информация об этом заказе для Zaakpay.Максимальная длина: `180` символов. |
> | `extra2` | string | Нет | Пользовательская информация об этом заказе для Zaakpay.Максимальная длина: `180` символов. |

> [accordion] whatsappMessage.template.components\[].parameters\[].order\_status
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `reference_id` | string | Нет | Уникальный идентификатор заказа, предоставленный компанией. |
> | `order` | object | Нет | Предоставляет только `status` и `description` этого заказа для сообщений `order_status`. |

> [accordion] whatsappMessage.template.components\[].parameters\[].order\_status.order
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `status` | string | Нет | Единственное поддерживаемое значение в сообщении `order_details` — `pending`. В сообщении `order_status` поле `status` может иметь значение: `pending`, `processing`, `partially_shipped`, `shipped`, `completed` или `canceled`. |
> | `type` | string | Нет | Единственное поддерживаемое значение — `quick_pay`. При передаче этого поля мы скрываем кнопку «Review and Pay» и отображаем только кнопку «Pay Now» во всплывающем окне сведений о заказе. |
> | `catalog_id` | string | Нет | Уникальный идентификатор каталога Facebook, используемого компанией. Если вы не укажете это поле, вы должны указать следующие поля внутри объекта items: `country_of_origin`, `importer_name` и `importer_address`. |
> | `items` | object\[] | Нет | Массив товаров в заказе. |
> | `subtotal` | object | Нет | Значение **должно быть равно** сумме `order.amount.value` \* `order.amount.quantity`. |
> | `tax` | object | Нет | Информация о налогах для этого заказа. |
> | `shipping` | object | Нет | Стоимость доставки заказа. |
> | `discount` | object | Нет | Сумма скидки для этого заказа. |
> | `expiration` | object | Нет | Срок действия этого заказа. |
> | `description` | string | Нет | **Необязательно.** Текст для передачи информации о статусе. Может быть полезен при отправке отмены. Максимальное ограничение — 120 символов.Максимальная длина: `120`. |

> [accordion] whatsappMessage.template.components\[].parameters\[].order\_status.order.items\[]
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `retailer_id` | string | Нет | Идентификатор контента для позиции в заказе из вашего каталога. |
> | `name` | string | Да | Название товара, отображаемое пользователю. Не может превышать 60 символов.Максимальная длина: `60`. |
> | `image` | object | Нет | Пользовательское изображение товара, отображаемое пользователю. |
> | `amount` | object | Да | Цена за единицу товара. |
> | `sale_amount` | object | Нет | Цена за единицу товара со скидкой. Значение должно быть меньше исходной суммы. Если указано, это поле используется для расчета промежуточного итога. |
> | `quantity` | integer (int32) | Да | Количество товаров в заказе. |
> | `country_of_origin` | string | Нет | Обязательно, если не указано `catalog_id`. Страна происхождения товара. |
> | `importer_name` | string | Нет | Обязательно, если не указано `catalog_id`. Название компании-импортера. |
> | `importer_address` | string | Нет | Обязательно, если не указано `catalog_id`. Адрес компании-импортера. |

> [accordion] whatsappMessage.template.components\[].parameters\[].order\_status.order.items\[].image
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `id` | string | Нет | \*\*Используйте это, когда медиафайл загружен на серверы WhatsApp.\*\*Укажите идентификатор медиаобъекта, полученный из WhatsApp media upload API (\[[https://docs.ycloud.com/reference/whatsapp\_media-upload#/](https://docs.ycloud.com/reference/whatsapp_media-upload#/)]\([https://docs.ycloud.com/reference/whatsapp\_media-upload#/)).Примечание](https://docs.ycloud.com/reference/whatsapp_media-upload#/\)\).Примечание): необходимо указать либо `id`, либо `link`. Если указаны оба параметра, приоритет имеет `id`. |
> | `link` | string | Нет | \*\*Используйте это при отправке медиафайла напрямую с вашего сервера.\*\*Протокол и URL отправляемого медиафайла. Используйте только с URL HTTP/HTTPS.Примечание: WhatsApp Cloud API кеширует медиаресурсы на 10 минут. Чтобы гарантировать актуальность контента, добавьте к URL случайные параметры строки запроса.Примечание: необходимо указать либо `id`, либо `link`. Если указаны оба параметра, приоритет имеет `id`, а `link` будет проигнорирован. |
> | `caption` | string | Нет | Описывает указанный медиафайл `image`, `gif`, `video` или `document`. Не применяется в `header` сообщений `template` или `interactive`. |
> | `filename` | string | Нет | Описывает имя файла для конкретного документа. Используйте только с медиафайлами `document`. |

> [accordion] whatsappMessage.template.components\[].parameters\[].order\_status.order.items\[].amount
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `offset` | integer (int32) | Да | Должно быть `100` для `INR`. |
> | `value` | integer (int32) | Да | Положительное целое число, представляющее значение суммы, умноженное на смещение (offset). Например, ₹12.34 имеет значение 1234. |
> | `description` | string | Нет | Используйте только для `tax`, `shipping` или `discount`. Описание суммы. Максимальный лимит составляет 60 символов.Максимальная длина: `60`. |
> | `discount_program_name` | string | Нет | Используйте только для `discount`. Текст, используемый для определения поощрительных заказов. Если заказ поощрительный, продавец должен указать эту информацию. Максимальный лимит составляет 60 символов.Максимальная длина: `60`. |

> [accordion] whatsappMessage.template.components\[].parameters\[].order\_status.order.items\[].sale\_amount
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `offset` | integer (int32) | Да | Должно быть `100` для `INR`. |
> | `value` | integer (int32) | Да | Положительное целое число, представляющее сумму, умноженную на коэффициент offset. Например, ₹12.34 имеет значение 1234. |
> | `description` | string | Нет | Используйте только для `tax`, `shipping` или `discount`. Описание суммы. Максимальная длина — 60 символов.Максимальная длина: `60`. |
> | `discount_program_name` | string | Нет | Используйте только для `discount`. Текст, используемый для обозначения поощрительных заказов. Если заказ поощрительный, продавец должен указать эту информацию. Максимальная длина — 60 символов.Максимальная длина: `60`. |

> [accordion] whatsappMessage.template.components\[].parameters\[].order\_status.order.subtotal
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `offset` | integer (int32) | Да | Должно быть `100` для `INR`. |
> | `value` | integer (int32) | Да | Положительное целое число, представляющее сумму, умноженную на коэффициент offset. Например, ₹12.34 имеет значение 1234. |
> | `description` | string | Нет | Используйте только для `tax`, `shipping` или `discount`. Описание суммы. Максимальная длина — 60 символов.Максимальная длина: `60`. |
> | `discount_program_name` | string | Нет | Используйте только для `discount`. Текст, используемый для обозначения поощрительных заказов. Если заказ поощрительный, продавец должен указать эту информацию. Максимальная длина — 60 символов.Максимальная длина: `60`. |

> [accordion] whatsappMessage.template.components\[].parameters\[].order\_status.order.tax
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `offset` | integer (int32) | Да | Должно быть `100` для `INR`. |
> | `value` | integer (int32) | Да | Положительное целое число, представляющее сумму, умноженную на коэффициент offset. Например, ₹12.34 имеет значение 1234. |
> | `description` | string | Нет | Используйте только для `tax`, `shipping` или `discount`. Описание суммы. Максимальная длина — 60 символов.Максимальная длина: `60`. |
> | `discount_program_name` | string | Нет | Используйте только для `discount`. Текст, используемый для обозначения поощрительных заказов. Если заказ поощрительный, продавец должен указать эту информацию. Максимальная длина — 60 символов.Максимальная длина: `60`. |

> [accordion] whatsappMessage.template.components\[].parameters\[].order\_status.order.shipping
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `offset` | integer (int32) | Да | Должно быть `100` для `INR`. |
> | `value` | integer (int32) | Да | Положительное целое число, представляющее сумму, умноженную на коэффициент offset. Например, ₹12.34 имеет значение 1234. |
> | `description` | string | Нет | Используйте только для `tax`, `shipping` или `discount`. Описание суммы. Максимальная длина — 60 символов.Максимальная длина: `60`. |
> | `discount_program_name` | string | Нет | Используйте только для `discount`. Текст, используемый для определения стимулированных заказов. Если заказ является стимулированным, продавец должен указать эту информацию. Максимальный лимит — 60 символов.Максимальная длина: `60`. |

> [accordion] whatsappMessage.template.components\[].parameters\[].order\_status.order.discount
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `offset` | integer (int32) | Да | Должно быть `100` для `INR`. |
> | `value` | integer (int32) | Да | Положительное целое число, представляющее значение суммы, умноженное на смещение (offset). Например, ₹12.34 имеет значение 1234. |
> | `description` | string | Нет | Используйте только для `tax`, `shipping` или `discount`. Описание суммы. Максимальный лимит — 60 символов.Максимальная длина: `60`. |
> | `discount_program_name` | string | Нет | Используйте только для `discount`. Текст, используемый для определения стимулированных заказов. Если заказ является стимулированным, продавец должен указать эту информацию. Максимальный лимит — 60 символов.Максимальная длина: `60`. |

> [accordion] whatsappMessage.template.components\[].parameters\[].order\_status.order.expiration
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `timestamp` | string | Да | Строка с меткой времени UTC в секундах, указывающая время истечения срока действия заказа. Минимальный порог — 300 секунд. |
> | `description` | string | Нет | Текстовое пояснение истечения срока действия.Максимальная длина: `120`. |

> [accordion] whatsappMessage.template.components\[].parameters\[].location
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `latitude` | number (double) | Да | Широта местоположения. |
> | `longitude` | number (double) | Да | Долгота местоположения. |
> | `name` | string | Нет | Название местоположения. |
> | `address` | string | Нет | Адрес местоположения. Отображается только при наличии `name`. |

> [accordion] whatsappMessage.template.components\[].cards\[]
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `card_index` | integer (int32) | Нет | **Обязательно.** Порядковый номер карточки в карусели карточек, начинающийся с нуля. 0 указывает на первую карточку, 1 — на вторую карточку и т. д.Минимум: `0`. Максимум: `9`. |
> | `components` | object\[] | Нет | Компонент карточки. |

> [accordion] whatsappMessage.template.components\[].cards\[].components\[]
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `type` | string | Да | Тип компонента.Значения: `header`, `body`, `button`. |
> | `sub_type` | string | Нет | **Обязательно, если тип — `button`.** Тип кнопки.<ul><li>`quick_reply`: относится к ранее созданной кнопке быстрого ответа, позволяющей клиенту отправить предопределенное сообщение.</li><li>`url`: относится к ранее созданной кнопке URL, позволяющей клиенту перейти по URL-адресу, сформированному путем добавления текстового параметра к предопределенному префиксу URL в шаблоне.</li></ul> |
> | `index` | integer (int32) | Нет | **Обязательно, если `type` = `button`. Для других типов не используется.** Указывает порядок отображения кнопки, если в шаблоне используется несколько кнопок. Кнопки индексируются с нуля, поэтому значение 0 задает первую кнопку, 1 — следующую кнопку и т. д.Минимум: `0`. Максимум: `9`. |
> | `parameters` | object\[] | Нет | **Обязательно, если `type` = `button`, или если в соответствующем компоненте шаблона есть переменные, или если формат компонента карточки `HEADER` относится к медиа (`IMAGE`, `VIDEO`).** Массив объектов параметров с содержимым сообщения. |

> [accordion] whatsappMessage.template.components\[].cards\[].components\[].parameters\[]
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `type` | string | Нет | **Обязательно.** Тип параметра компонента.<ul><li>`text`: используется, когда тип компонента шаблона — `BODY`, или формат компонента `HEADER` — `TEXT`.</li><li>`image`: используется, когда компонент шаблона `HEADER` — `IMAGE`.</li><li>`gif`: используется, когда компонент шаблона `HEADER` — `GIF`.</li><li>`video`: используется, когда компонент шаблона `HEADER` — `VIDEO`.</li><li>`document`: используется, когда компонент шаблона `HEADER` — `DOCUMENT`.</li><li>`payload`: используется, когда тип кнопки компонента шаблона — `QUICK_REPLY`.</li><li>`coupon_code`: используется, когда тип кнопки компонента шаблона — `COPY_CODE`.</li><li>`limited_time_offer`: используется, когда тип компонента шаблона — `LIMITED_TIME_OFFER`.</li><li>`action`: используется, когда тип кнопки компонента шаблона — `CATALOG`, `MPM`, `FLOW` или `ORDER_DETAILS`.</li><li>`order_status`: используется, когда подкатегория шаблона — `ORDER_STATUS`.</li><li>`location`: используется, когда компонент шаблона `HEADER` — `LOCATION`.</li></ul> |
> | `text` | string | Нет | **Обязательно, если `type` = `text`.** Текст сообщения. Для компонента header ограничение длины составляет 60 символов. Для компонента body ограничение длины составляет 1024 символа. Для кнопок url указывает предоставляемый разработчиком суффикс, который добавляется к предварительно определенному префиксу URL в шаблоне. |
> | `payload` | string | Нет | Обязательно для кнопок `quick_reply`. Определяемый разработчиком payload, возвращаемый при нажатии на кнопку в дополнение к отображаемому тексту кнопки. |
> | `coupon_code` | string | Нет | **Обязательно, если `type` = `coupon_code`.** Код купона, копируемый при нажатии клиентом на кнопку. |
> | `image` | object | Нет | **Обязательно, если формат `HEADER` шаблона — `IMAGE`.** |
> | `gif` | object | Нет | **Обязательно, если формат `HEADER` шаблона — `GIF`.** |
> | `video` | object | Нет | **Обязательно, если формат `HEADER` шаблона — `VIDEO`.** |
> | `document` | object | Нет | **Обязательно, когда формат шаблона `HEADER` равен `DOCUMENT`.** |
> | `limited_time_offer` | object | Нет | Обязательно, если шаблон использует информацию о сроке действия предложения. |
> | `action` | object | Нет | Обязательно, если шаблон использует кнопки каталога или MPM (многопродуктовых сообщений). |
> | `order_status` | object | Нет | Поля объекта перечислены ниже. |
> | `location` | object | Нет | **Обязательно, когда `type` = `location`.** |

> [accordion] whatsappMessage.template.components\[].cards\[].components\[].parameters\[].image
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `id` | string | Нет | \*\*Используйте это, когда медиафайл загружен на серверы WhatsApp.\*\*Укажите ID медиаобъекта, полученный из WhatsApp media upload API (\[[https://docs.ycloud.com/reference/whatsapp\_media-upload#/](https://docs.ycloud.com/reference/whatsapp_media-upload#/)]\([https://docs.ycloud.com/reference/whatsapp\_media-upload#/)).Примечание](https://docs.ycloud.com/reference/whatsapp_media-upload#/\)\).Примечание): необходимо указать либо `id`, либо `link`. Если указаны оба, приоритет имеет `id`. |
> | `link` | string | Нет | \*\*Используйте это при отправке медиафайлов напрямую с вашего сервера.\*\*Протокол и URL отправляемого медиафайла. Используйте только URL HTTP/HTTPS.Примечание: WhatsApp Cloud API кэширует медиаресурсы на 10 минут. Чтобы гарантировать получение актуального контента, добавьте к URL случайные параметры строки запроса.Примечание: необходимо указать либо `id`, либо `link`. Если указаны оба, приоритет имеет `id`, а `link` будет проигнорирован. |
> | `caption` | string | Нет | Описывает указанный медиафайл типа `image`, `gif`, `video` или `document`. Не применяется в `header` сообщений типа `template` или `interactive`. |
> | `filename` | string | Нет | Описывает имя файла для указанного документа. Используется только с медиафайлами типа `document`. |

> [accordion] whatsappMessage.template.components\[].cards\[].components\[].parameters\[].gif
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `id` | string | Нет | \*\*Используйте это, когда медиафайл загружен на серверы WhatsApp.\*\*Укажите ID медиаобъекта, полученный из WhatsApp media upload API (\[[https://docs.ycloud.com/reference/whatsapp\_media-upload#/](https://docs.ycloud.com/reference/whatsapp_media-upload#/)]\([https://docs.ycloud.com/reference/whatsapp\_media-upload#/)).Примечание](https://docs.ycloud.com/reference/whatsapp_media-upload#/\)\).Примечание): необходимо указать либо `id`, либо `link`. Если указаны оба, приоритет имеет `id`. |
> | `link` | string | Нет | \*\*Используйте это при отправке медиафайлов напрямую с вашего сервера.\*\*Протокол и URL отправляемого медиафайла. Используйте только URL HTTP/HTTPS.Примечание: WhatsApp Cloud API кэширует медиаресурсы на 10 минут. Чтобы гарантировать получение актуального контента, добавьте к URL случайные параметры строки запроса.Примечание: необходимо указать либо `id`, либо `link`. Если указаны оба, приоритет имеет `id`, а `link` будет проигнорирован. |
> | `caption` | string | Нет | Описывает указанный медиафайл типа `image`, `gif`, `video` или `document`. Не применяется в `header` сообщений типа `template` или `interactive`. |
> | `filename` | string | Нет | Описывает имя файла для указанного документа. Используется только с медиафайлами типа `document`. |

> [accordion] whatsappMessage.template.components\[].cards\[].components\[].parameters\[].video
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `id` | string | Нет | \*\*Используйте этот параметр, когда медиафайл загружен на серверы WhatsApp.\*\*Укажите ID медиаобъекта, полученный из WhatsApp media upload API (\[[https://docs.ycloud.com/reference/whatsapp\_media-upload#/](https://docs.ycloud.com/reference/whatsapp_media-upload#/)]\([https://docs.ycloud.com/reference/whatsapp\_media-upload#/)).Примечание](https://docs.ycloud.com/reference/whatsapp_media-upload#/\)\).Примечание): необходимо указать либо `id`, либо `link`. Если указаны оба, приоритет имеет `id`. |
> | `link` | string | Нет | \*\*Используйте этот параметр при отправке медиафайла напрямую с вашего сервера.\*\*Протокол и URL отправляемого медиафайла. Используйте только с URL HTTP/HTTPS.Примечание: WhatsApp Cloud API кэширует медиаресурсы на 10 минут. Чтобы гарантировать получение актуального содержимого, добавьте к URL случайные параметры запроса.Примечание: необходимо указать либо `id`, либо `link`. Если указаны оба, приоритет имеет `id`, а `link` будет проигнорирован. |
> | `caption` | string | Нет | Описывает указанный медиафайл `image`, `gif`, `video` или `document`. Не применяется в `header` сообщений `template` или `interactive`. |
> | `filename` | string | Нет | Описывает имя файла для указанного документа. Используется только с медиафайлами `document`. |

> [accordion] whatsappMessage.template.components\[].cards\[].components\[].parameters\[].document
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `id` | string | Нет | \*\*Используйте этот параметр, когда медиафайл загружен на серверы WhatsApp.\*\*Укажите ID медиаобъекта, полученный из WhatsApp media upload API (\[[https://docs.ycloud.com/reference/whatsapp\_media-upload#/](https://docs.ycloud.com/reference/whatsapp_media-upload#/)]\([https://docs.ycloud.com/reference/whatsapp\_media-upload#/)).Примечание](https://docs.ycloud.com/reference/whatsapp_media-upload#/\)\).Примечание): необходимо указать либо `id`, либо `link`. Если указаны оба, приоритет имеет `id`. |
> | `link` | string | Нет | \*\*Используйте этот параметр при отправке медиафайла напрямую с вашего сервера.\*\*Протокол и URL отправляемого медиафайла. Используйте только с URL HTTP/HTTPS.Примечание: WhatsApp Cloud API кэширует медиаресурсы на 10 минут. Чтобы гарантировать получение актуального содержимого, добавьте к URL случайные параметры запроса.Примечание: необходимо указать либо `id`, либо `link`. Если указаны оба, приоритет имеет `id`, а `link` будет проигнорирован. |
> | `caption` | string | Нет | Описывает указанный медиафайл `image`, `gif`, `video` или `document`. Не применяется в `header` сообщений `template` или `interactive`. |
> | `filename` | string | Нет | Описывает имя файла для указанного документа. Используется только с медиафайлами `document`. |

> [accordion] whatsappMessage.template.components\[].cards\[].components\[].parameters\[].limited\_time\_offer
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `expiration_time_ms` | integer (int64) | Нет | **Обязательный.** Время истечения срока действия кода предложения в виде UNIX-таймстемпа в миллисекундах. |

> [accordion] whatsappMessage.template.components\[].cards\[].components\[].parameters\[].action
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `thumbnail_product_retailer_id` | string | Нет | **Необязательный.** Используется для шаблонных сообщений каталога и MPM. Артикул (SKU) товара. В Commerce Manager обозначается как Content ID. Миниатюра этого товара будет использоваться в качестве изображения заголовка сообщения. Если объект `parameters` опущен, будет использоваться изображение первого товара в вашем каталоге. |
> | `sections` | object\[] | Нет | Используется для шаблонов MPM. Разделы товаров. Можно указать до 10 разделов. |
> | `flow_token` | string | Нет | Используется для кнопок `FLOW`. Токен Flow, созданный компанией для использования в качестве идентификатора. По умолчанию `unused`. |
> | `flow_action_data` | object | Нет | Используется для кнопок `FLOW`. JSON-объект с полезной нагрузкой данных для первого экрана. |
> | `order_details` | object | Нет | Обязательно для кнопок `order_details`. |

> [accordion] whatsappMessage.template.components\[].cards\[].components\[].parameters\[].action.sections\[]
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `title` | string | Нет | Текст заголовка секции. Максимум 24 символа. Markdown не поддерживается.Максимальная длина: `24`. |
> | `product_items` | object\[] | Нет | Массив артикулов (SKU) товаров. Минимум 1 товар в секции и максимум 30 товаров во всех секциях суммарно. |

> [accordion] whatsappMessage.template.components\[].cards\[].components\[].parameters\[].action.sections\[].product\_items\[]
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `product_retailer_id` | string | Нет | Артикул (SKU) товара, который должен отображаться в секции. Артикулы SKU обозначены как **Content ID** в [Commerce Manager](https://business.facebook.com/commerce). |

> [accordion] whatsappMessage.template.components\[].cards\[].components\[].parameters\[].action.order\_details
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `currency` | string | Да | Валюта для этого заказа. В настоящее время поддерживается только значение `INR`. |
> | `order` | object | Да | Предоставляет `status`, `items`, `subtotal`, `tax` заказа и т. д. |
> | `reference_id` | string | Да | Уникальный идентификатор заказа, предоставленный компанией. Он чувствителен к регистру, не может быть пустой строкой, может содержать только латинские буквы, цифры, знаки подчеркивания, дефисы или точки и не должен превышать 35 символов.Значение `reference_id` должно быть уникальным для каждого сообщения order\_details у данной компании. Если необходимо отправить несколько сообщений order\_details для одного и того же заказа, рекомендуется включить порядковый номер в reference\_id (например, "BM345A-12"), чтобы гарантировать уникальность reference\_id. |
> | `total_amount` | object | Да | Общая сумма заказа. |
> | `type` | string | Да | Тип товаров, оплачиваемых в этом заказе. В настоящее время поддерживаются варианты `digital-goods` и `physical-goods`. |
> | `payment_settings` | object\[] | Да | Настройки оплаты заказа. |

> [accordion] whatsappMessage.template.components\[].cards\[].components\[].parameters\[].action.order\_details.order
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `status` | string | Нет | Единственное поддерживаемое значение в сообщении `order_details` — это `pending`. В сообщении `order_status` поле `status` может иметь значение: `pending`, `processing`, `partially_shipped`, `shipped`, `completed` или `canceled`. |
> | `type` | string | Нет | Единственное поддерживаемое значение — `quick_pay`. Если это поле передано, мы скрываем кнопку "Review and Pay" и показываем только кнопку "Pay Now" в карточке с деталями заказа. |
> | `catalog_id` | string | Нет | Уникальный идентификатор каталога Facebook, используемого компанией. Если вы не укажете это поле, необходимо передать следующие поля внутри объекта items: `country_of_origin`, `importer_name` и `importer_address`. |
> | `items` | object\[] | Нет | Массив позиций в заказе. |
> | `subtotal` | object | Нет | Значение **должно быть равно** сумме `order.amount.value` \* `order.amount.quantity`. |
> | `tax` | object | Нет | Сведения о налогах для этого заказа. |
> | `shipping` | object | Нет | Стоимость доставки заказа. |
> | `discount` | object | Нет | Сумма скидки для этого заказа. |
> | `expiration` | object | Нет | Срок действия этого заказа. |
> | `description` | string | Нет | **Необязательно.** Текст для передачи информации о статусе. Может быть полезен при отправке отмены. Максимальный лимит символов — 120.Максимальная длина: `120`. |

> [accordion] whatsappMessage.template.components\[].cards\[].components\[].parameters\[].action.order\_details.order.items\[]
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `retailer_id` | string | Нет | Идентификатор контента позиции в заказе из вашего каталога. |
> | `name` | string | Да | Название позиции, отображаемое пользователю. Не может превышать 60 символов.Максимальная длина: `60`. |
> | `image` | object | Нет | Пользовательское изображение позиции для отображения пользователю. |
> | `amount` | object | Да | Цена за единицу товара. |
> | `sale_amount` | object | Нет | Цена со скидкой за единицу товара. Должна быть меньше исходной суммы. Если указано, это поле используется для расчета промежуточного итога. |
> | `quantity` | integer (int32) | Да | Количество единиц товара в заказе. |
> | `country_of_origin` | string | Нет | Обязательно, если не указано `catalog_id`. Страна происхождения товара. |
> | `importer_name` | string | Нет | Обязательно, если не указано `catalog_id`. Название компании-импортера. |
> | `importer_address` | string | Нет | Обязательно, если не указано `catalog_id`. Адрес компании-импортера. |

> [accordion] whatsappMessage.template.components\[].cards\[].components\[].parameters\[].action.order\_details.order.items\[].image
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `id` | string | Нет | \*\*Используйте это, когда медиафайл загружен на серверы WhatsApp.\*\*Укажите идентификатор медиаобъекта, полученный через API загрузки медиа WhatsApp (\[[https://docs.ycloud.com/reference/whatsapp\_media-upload#/](https://docs.ycloud.com/reference/whatsapp_media-upload#/)]\([https://docs.ycloud.com/reference/whatsapp\_media-upload#/)).Примечание](https://docs.ycloud.com/reference/whatsapp_media-upload#/\)\).Примечание): необходимо указать либо `id`, либо `link`. Если указаны оба, приоритет имеет `id`. |
> | `link` | string | Нет | \*\*Используйте это при отправке медиафайла напрямую с вашего сервера.\*\*Протокол и URL отправляемого медиафайла. Используйте только с URL HTTP/HTTPS.Примечание: WhatsApp Cloud API кэширует медиаресурсы на 10 минут. Чтобы обеспечить актуальность контента, добавьте к URL случайные параметры строки запроса.Примечание: необходимо указать либо `id`, либо `link`. Если указаны оба, приоритет имеет `id`, а `link` будет проигнорирован. |
> | `caption` | string | Нет | Описывает указанный медиафайл: `image`, `gif`, `video` или `document`. Не применимо в `header` сообщений `template` или `interactive`. |
> | `filename` | string | Нет | Описывает имя файла для конкретного документа. Используется только с медиафайлами `document`. |

> [accordion] whatsappMessage.template.components\[].cards\[].components\[].parameters\[].action.order\_details.order.items\[].amount
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `offset` | integer (int32) | Да | Должно быть `100` для `INR`. |
> | `value` | integer (int32) | Да | Положительное целое число, представляющее значение суммы, умноженное на offset. Например, ₹12.34 соответствует значению 1234. |
> | `description` | string | Нет | Используется только для `tax`, `shipping` или `discount`. Описание суммы. Максимальная длина — 60 символов.Максимальная длина: `60`. |
> | `discount_program_name` | string | Нет | Используется только для `discount`. Текст, используемый для определения поощрительных заказов. Если заказ поощрительный, продавец должен указать эту информацию. Максимальная длина — 60 символов.Максимальная длина: `60`. |

> [accordion] whatsappMessage.template.components\[].cards\[].components\[].parameters\[].action.order\_details.order.items\[].sale\_amount
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `offset` | integer (int32) | Да | Должно быть `100` для `INR`. |
> | `value` | integer (int32) | Да | Положительное целое число, представляющее значение суммы, умноженное на offset. Например, ₹12.34 соответствует значению 1234. |
> | `description` | string | Нет | Используется только для `tax`, `shipping` или `discount`. Описание суммы. Максимальная длина — 60 символов.Максимальная длина: `60`. |
> | `discount_program_name` | string | Нет | Используется только для `discount`. Текст, используемый для определения поощрительных заказов. Если заказ поощрительный, продавец должен указать эту информацию. Максимальная длина — 60 символов.Максимальная длина: `60`. |

> [accordion] whatsappMessage.template.components\[].cards\[].components\[].parameters\[].action.order\_details.order.subtotal
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `offset` | integer (int32) | Да | Должно быть `100` для `INR`. |
> | `value` | integer (int32) | Да | Положительное целое число, представляющее значение суммы, умноженное на offset. Например, ₹12.34 соответствует значению 1234. |
> | `description` | string | Нет | Используется только для `tax`, `shipping` или `discount`. Описание суммы. Максимальная длина — 60 символов.Максимальная длина: `60`. |
> | `discount_program_name` | string | Нет | Используется только для `discount`. Текст, используемый для определения поощрительных заказов. Если заказ поощрительный, продавец должен указать эту информацию. Максимальная длина — 60 символов.Максимальная длина: `60`. |

> [accordion] whatsappMessage.template.components\[].cards\[].components\[].parameters\[].action.order\_details.order.tax
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `offset` | integer (int32) | Да | Должно быть `100` для `INR`. |
> | `value` | integer (int32) | Да | Положительное целое число, представляющее сумму, умноженную на смещение (offset). Например, ₹12.34 имеет значение 1234. |
> | `description` | string | Нет | Используйте только для `tax`, `shipping` или `discount`. Описание суммы. Максимальная длина — 60 символов.Максимальная длина: `60`. |
> | `discount_program_name` | string | Нет | Используйте только для `discount`. Текст, используемый для определения поощрительных заказов. Если заказ поощрительный, продавец должен указать эту информацию. Максимальная длина — 60 символов.Максимальная длина: `60`. |

> [accordion] whatsappMessage.template.components\[].cards\[].components\[].parameters\[].action.order\_details.order.shipping
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `offset` | integer (int32) | Да | Должно быть `100` для `INR`. |
> | `value` | integer (int32) | Да | Положительное целое число, представляющее сумму, умноженную на смещение (offset). Например, ₹12.34 имеет значение 1234. |
> | `description` | string | Нет | Используйте только для `tax`, `shipping` или `discount`. Описание суммы. Максимальная длина — 60 символов.Максимальная длина: `60`. |
> | `discount_program_name` | string | Нет | Используйте только для `discount`. Текст, используемый для определения поощрительных заказов. Если заказ поощрительный, продавец должен указать эту информацию. Максимальная длина — 60 символов.Максимальная длина: `60`. |

> [accordion] whatsappMessage.template.components\[].cards\[].components\[].parameters\[].action.order\_details.order.discount
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `offset` | integer (int32) | Да | Должно быть `100` для `INR`. |
> | `value` | integer (int32) | Да | Положительное целое число, представляющее сумму, умноженную на смещение (offset). Например, ₹12.34 имеет значение 1234. |
> | `description` | string | Нет | Используйте только для `tax`, `shipping` или `discount`. Описание суммы. Максимальная длина — 60 символов.Максимальная длина: `60`. |
> | `discount_program_name` | string | Нет | Используйте только для `discount`. Текст, используемый для определения поощрительных заказов. Если заказ поощрительный, продавец должен указать эту информацию. Максимальная длина — 60 символов.Максимальная длина: `60`. |

> [accordion] whatsappMessage.template.components\[].cards\[].components\[].parameters\[].action.order\_details.order.expiration
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `timestamp` | string | Да | Строка с меткой времени UTC в секундах, указывающая время истечения срока действия заказа. Минимальный порог — 300 секунд. |
> | `description` | string | Нет | Текстовое пояснение истечения срока действия.Максимальная длина: `120`. |

> [accordion] whatsappMessage.template.components\[].cards\[].components\[].parameters\[].action.order\_details.total\_amount
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `offset` | integer (int32) | Да | Должно быть `100` для `INR`. |
> | `value` | integer (int32) | Да | Положительное целое число, представляющее сумму, умноженную на смещение (offset). Например, ₹12.34 имеет значение 1234. |
> | `description` | string | Нет | Используйте только для `tax`, `shipping` или `discount`. Описание суммы. Максимальная длина — 60 символов.Максимальная длина: `60`. |
> | `discount_program_name` | string | Нет | Используйте только для `discount`. Текст, используемый для обозначения поощрительных заказов. Если заказ поощрительный, продавцу необходимо указать эту информацию. Максимальная длина — 60 символов.Максимальная длина: `60`. |

> [accordion] whatsappMessage.template.components\[].cards\[].components\[].parameters\[].action.order\_details.payment\_settings\[]
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `type` | string | Да | Должно быть установлено в `payment_gateway`. |
> | `payment_gateway` | object | Да | Объект, описывающий данные платежного счета. |

> [accordion] whatsappMessage.template.components\[].cards\[].components\[].parameters\[].action.order\_details.payment\_settings\[].payment\_gateway
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `type` | string | Да | Тип платежа. Необходимо указать `billdesk`, `razorpay`, `payu` или `zaakpay`, если вы подключили платежный шлюз BillDesk, Razorpay, PayU или Zaakpay для приема платежей. |
> | `configuration_name` | string | Да | Имя предварительно настроенной платежной конфигурации, используемой для этого заказа; длина не должна превышать 60 символов. Это значение должно совпадать с конфигурацией платежа, настроенной в WhatsApp Business Manager.Максимальная длина: `60`. |
> | `billdesk` | object | Нет | Дополнительная информация для BillDesk. Пользовательские поля (extra) используются для хранения любой информации, относящейся к конкретному заказу. Максимальная длина каждого поля extra составляет 120 символов. |
> | `payu` | object | Нет | Дополнительная информация для PayU. Пользовательские поля (udf) используются для хранения любой информации, относящейся к конкретному заказу. Максимальная длина каждого поля UDF составляет 255 символов. |
> | `razorpay` | object | Нет | Дополнительная информация для Razorpay. |
> | `zaakpay` | object | Нет | Дополнительная информация для Zaakpay. Пользовательские поля (extra) используются для хранения любой информации, относящейся к конкретному заказу. Максимальная длина каждого поля extra составляет 180 символов. |

> [accordion] whatsappMessage.template.components\[].cards\[].components\[].parameters\[].action.order\_details.payment\_settings\[].payment\_gateway.billdesk
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `additional_info1` | string | Нет | Пользовательская информация об этом заказе для BillDesk.Максимальная длина: `120` символов. |
> | `additional_info2` | string | Нет | Пользовательская информация об этом заказе для BillDesk.Максимальная длина: `120` символов. |
> | `additional_info3` | string | Нет | Пользовательская информация об этом заказе для BillDesk.Максимальная длина: `120` символов. |
> | `additional_info4` | string | Нет | Пользовательская информация об этом заказе для BillDesk.Максимальная длина: `120` символов. |
> | `additional_info5` | string | Нет | Пользовательская информация об этом заказе для BillDesk.Максимальная длина: `120` символов. |
> | `additional_info6` | string | Нет | Пользовательская информация об этом заказе для BillDesk.Максимальная длина: `120` символов. |
> | `additional_info7` | string | Нет | Пользовательская информация об этом заказе для BillDesk.Максимальная длина: `120` символов. |

> [accordion] whatsappMessage.template.components\[].cards\[].components\[].parameters\[].action.order\_details.payment\_settings\[].payment\_gateway.payu
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `udf1` | string | Нет | Пользовательская информация об этом заказе для PayU.Максимальная длина: `255` символов. |
> | `udf2` | string | Нет | Пользовательская информация об этом заказе для PayU.Максимальная длина: `255` символов. |
> | `udf3` | string | Нет | Пользовательская информация об этом заказе для PayU.Максимальная длина: `255` символов. |
> | `udf4` | string | Нет | Пользовательская информация об этом заказе для PayU.Максимальная длина: `255` символов. |

> [accordion] whatsappMessage.template.components\[].cards\[].components\[].parameters\[].action.order\_details.payment\_settings\[].payment\_gateway.razorpay
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `receipt` | string | Нет | Номер квитанции, соответствующий этому заказу, заданный для вашей внутренней ссылки. Поддерживается максимальная длина 40 символов при минимальной длине более 0 символов. |
> | `notes` | object | Нет | Объект может содержать пары «ключ-значение» максимум с 15 ключами, при этом длина каждого значения ограничена 256 символами. |

> [accordion] whatsappMessage.template.components\[].cards\[].components\[].parameters\[].action.order\_details.payment\_settings\[].payment\_gateway.zaakpay
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `extra1` | string | Нет | Пользовательская информация об этом заказе для Zaakpay.Максимальная длина: `180` символов. |
> | `extra2` | string | Нет | Пользовательская информация об этом заказе для Zaakpay.Максимальная длина: `180` символов. |

> [accordion] whatsappMessage.template.components\[].cards\[].components\[].parameters\[].order\_status
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `reference_id` | string | Нет | Уникальный идентификатор заказа, предоставленный компанией. |
> | `order` | object | Нет | Предоставляет только `status` и `description` этого заказа для сообщений `order_status`. |

> [accordion] whatsappMessage.template.components\[].cards\[].components\[].parameters\[].order\_status.order
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `status` | string | Нет | Единственное поддерживаемое значение в сообщении `order_details` — `pending`. В сообщении `order_status` значение `status` может быть следующим: `pending`, `processing`, `partially_shipped`, `shipped`, `completed` или `canceled`. |
> | `type` | string | Нет | Единственное поддерживаемое значение — `quick_pay`. Когда это поле передано, мы скрываем кнопку «Review and Pay» и отображаем во всплывающем окне с деталями заказа только кнопку «Pay Now». |
> | `catalog_id` | string | Нет | Уникальный идентификатор каталога Facebook, используемого компанией. Если вы не указываете это поле, необходимо предоставить следующие поля внутри объекта items: `country_of_origin`, `importer_name` и `importer_address`. |
> | `items` | object\[] | Нет | Массив позиций в заказе. |
> | `subtotal` | object | Нет | Значение **должно быть равно** сумме `order.amount.value` \* `order.amount.quantity`. |
> | `tax` | object | Нет | Информация о налогах для этого заказа. |
> | `shipping` | object | Нет | Стоимость доставки заказа. |
> | `discount` | object | Нет | Сумма скидки для этого заказа. |
> | `expiration` | object | Нет | Срок действия этого заказа. |
> | `description` | string | Нет | **Необязательно.** Текст для передачи информации, связанной со статусом. Может быть полезен при отправке отмены. Максимальное ограничение — 120 символов.Максимальная длина: `120`. |

> [accordion] whatsappMessage.template.components\[].cards\[].components\[].parameters\[].order\_status.order.items\[]
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `retailer_id` | string | Нет | Идентификатор контента (Content ID) для позиции в заказе из вашего каталога. |
> | `name` | string | Да | Название позиции для отображения пользователю. Не может превышать 60 символов.Максимальная длина: `60`. |
> | `image` | object | Нет | Пользовательское изображение для позиции, отображаемое пользователю. |
> | `amount` | object | Да | Цена за единицу товара. |
> | `sale_amount` | object | Нет | Цена со скидкой за единицу товара. Должна быть меньше исходной суммы. Если указано, это поле используется для расчета промежуточного итога. |
> | `quantity` | integer (int32) | Да | Количество единиц товара в заказе. |
> | `country_of_origin` | string | Нет | Обязательно, если не указано `catalog_id`. Страна происхождения товара. |
> | `importer_name` | string | Нет | Обязательно, если не указано `catalog_id`. Название компании-импортера. |
> | `importer_address` | string | Нет | Обязательно, если не указано `catalog_id`. Адрес компании-импортера. |

> [accordion] whatsappMessage.template.components\[].cards\[].components\[].parameters\[].order\_status.order.items\[].image
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `id` | string | Нет | \*\*Используйте это поле, когда медиафайл загружен на серверы WhatsApp.\*\*Укажите идентификатор медиаобъекта, полученный через API загрузки медиафайлов WhatsApp (\[[https://docs.ycloud.com/reference/whatsapp\_media-upload#/](https://docs.ycloud.com/reference/whatsapp_media-upload#/)]\([https://docs.ycloud.com/reference/whatsapp\_media-upload#/)).Примечание](https://docs.ycloud.com/reference/whatsapp_media-upload#/\)\).Примечание): необходимо указать либо `id`, либо `link`. Если указаны оба, приоритет отдается `id`. |
> | `link` | string | Нет | \*\*Используйте этот параметр при отправке медиафайлов напрямую с вашего сервера.\*\*Протокол и URL отправляемого медиафайла. Используйте только с URL-адресами HTTP/HTTPS.Примечание: WhatsApp Cloud API кэширует медиаресурсы на 10 минут. Чтобы гарантировать получение актуального контента, добавьте к URL случайные параметры строки запроса.Примечание: необходимо указать либо `id`, либо `link`. Если указаны оба, приоритет имеет `id`, а `link` будет проигнорирован. |
> | `caption` | string | Нет | Описывает указанный медиафайл `image`, `gif`, `video` или `document`. Неприменимо в `header` сообщений `template` или `interactive`. |
> | `filename` | string | Нет | Описывает имя файла для указанного документа. Используйте только с медиафайлами `document`. |

> [accordion] whatsappMessage.template.components\[].cards\[].components\[].parameters\[].order\_status.order.items\[].amount
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `offset` | integer (int32) | Да | Должно быть `100` для `INR`. |
> | `value` | integer (int32) | Да | Положительное целое число, представляющее сумму, умноженную на смещение (offset). Например, ₹12.34 имеет значение 1234. |
> | `description` | string | Нет | Используйте только для `tax`, `shipping` или `discount`. Описание суммы. Максимальная длина — 60 символов.Максимальная длина: `60`. |
> | `discount_program_name` | string | Нет | Используйте только для `discount`. Текст, используемый для определения поощрительных заказов. Если заказ поощрительный, продавец должен указать эту информацию. Максимальная длина — 60 символов.Максимальная длина: `60`. |

> [accordion] whatsappMessage.template.components\[].cards\[].components\[].parameters\[].order\_status.order.items\[].sale\_amount
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `offset` | integer (int32) | Да | Должно быть `100` для `INR`. |
> | `value` | integer (int32) | Да | Положительное целое число, представляющее сумму, умноженную на смещение (offset). Например, ₹12.34 имеет значение 1234. |
> | `description` | string | Нет | Используйте только для `tax`, `shipping` или `discount`. Описание суммы. Максимальная длина — 60 символов.Максимальная длина: `60`. |
> | `discount_program_name` | string | Нет | Используйте только для `discount`. Текст, используемый для определения поощрительных заказов. Если заказ поощрительный, продавец должен указать эту информацию. Максимальная длина — 60 символов.Максимальная длина: `60`. |

> [accordion] whatsappMessage.template.components\[].cards\[].components\[].parameters\[].order\_status.order.subtotal
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `offset` | integer (int32) | Да | Должно быть `100` для `INR`. |
> | `value` | integer (int32) | Да | Положительное целое число, представляющее сумму, умноженную на смещение (offset). Например, ₹12.34 имеет значение 1234. |
> | `description` | string | Нет | Используйте только для `tax`, `shipping` или `discount`. Описание суммы. Максимальная длина — 60 символов.Максимальная длина: `60`. |
> | `discount_program_name` | string | Нет | Используйте только для `discount`. Текст, используемый для определения заказов с поощрением (incentivised). Если заказ с поощрением, продавец должен указать эту информацию. Максимальный лимит — 60 символов.Максимальная длина: `60`. |

> [accordion] whatsappMessage.template.components\[].cards\[].components\[].parameters\[].order\_status.order.tax
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `offset` | integer (int32) | Да | Должно быть `100` для `INR`. |
> | `value` | integer (int32) | Да | Положительное целое число, представляющее значение суммы, умноженное на смещение (offset). Например, ₹12.34 имеет значение 1234. |
> | `description` | string | Нет | Используйте только для `tax`, `shipping` или `discount`. Описание суммы. Максимальный лимит — 60 символов.Максимальная длина: `60`. |
> | `discount_program_name` | string | Нет | Используйте только для `discount`. Текст, используемый для определения заказов с поощрением (incentivised). Если заказ с поощрением, продавец должен указать эту информацию. Максимальный лимит — 60 символов.Максимальная длина: `60`. |

> [accordion] whatsappMessage.template.components\[].cards\[].components\[].parameters\[].order\_status.order.shipping
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `offset` | integer (int32) | Да | Должно быть `100` для `INR`. |
> | `value` | integer (int32) | Да | Положительное целое число, представляющее значение суммы, умноженное на смещение (offset). Например, ₹12.34 имеет значение 1234. |
> | `description` | string | Нет | Используйте только для `tax`, `shipping` или `discount`. Описание суммы. Максимальный лимит — 60 символов.Максимальная длина: `60`. |
> | `discount_program_name` | string | Нет | Используйте только для `discount`. Текст, используемый для определения заказов с поощрением (incentivised). Если заказ с поощрением, продавец должен указать эту информацию. Максимальный лимит — 60 символов.Максимальная длина: `60`. |

> [accordion] whatsappMessage.template.components\[].cards\[].components\[].parameters\[].order\_status.order.discount
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `offset` | integer (int32) | Да | Должно быть `100` для `INR`. |
> | `value` | integer (int32) | Да | Положительное целое число, представляющее значение суммы, умноженное на смещение (offset). Например, ₹12.34 имеет значение 1234. |
> | `description` | string | Нет | Используйте только для `tax`, `shipping` или `discount`. Описание суммы. Максимальный лимит — 60 символов.Максимальная длина: `60`. |
> | `discount_program_name` | string | Нет | Используйте только для `discount`. Текст, используемый для определения заказов с поощрением (incentivised). Если заказ с поощрением, продавец должен указать эту информацию. Максимальный лимит — 60 символов.Максимальная длина: `60`. |

> [accordion] whatsappMessage.template.components\[].cards\[].components\[].parameters\[].order\_status.order.expiration
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `timestamp` | string | Да | Строка с меткой времени UTC в секундах, указывающая время истечения срока действия заказа. Минимальный порог — 300 секунд. |
> | `description` | string | Нет | Текстовое пояснение причины истечения срока действия.Максимальная длина: `120`. |

> [accordion] whatsappMessage.template.components\[].cards\[].components\[].parameters\[].location
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `latitude` | number (double) | Да | Широта местоположения. |
> | `longitude` | number (double) | Да | Долгота местоположения. |
> | `name` | string | Нет | Название местоположения. |
> | `address` | string | Нет | Адрес местоположения. Отображается только в том случае, если указан `name`. |

> [accordion] whatsappMessage.text
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `body` | string | Да | Обязательно для текстовых сообщений. Текст сообщения, который может содержать URL-адреса, начинающиеся с http\:// или https\://, а также форматирование. Ознакомьтесь с доступными вариантами форматирования здесь. Если вы включаете URL-адреса в текст и хотите отображать блок предпросмотра в текстовых сообщениях (preview\_url: true), убедитесь, что URL начинается с http\:// или https\:// — предпочтительны URL-адреса https\://. Необходимо указать имя хоста, так как IP-адреса не распознаются. Максимальная длина: 4096 символов.Максимальная длина: `4096`. |
> | `preview_url` | boolean | Нет | По умолчанию WhatsApp распознает URL-адреса и делает их кликабельными, но вы также можете включить блок предварительного просмотра с дополнительной информацией о ссылке. Установите для этого поля значение true, если хотите добавить блок предпросмотра URL. В большинстве случаев получатель увидит кликабельный URL-адрес при отправке URL, если задано preview\_url: true и предоставлен объект body со ссылкой http или https. Предварительный просмотр URL отображается только после выполнения одного из следующих условий:<ul><li>Бизнес отправил пользователю шаблон сообщения.</li><li>Пользователь начинает диалог по ссылке «click to chat».</li><li>Пользователь добавляет номер телефона компании в свою адресную книгу и начинает диалог. По умолчанию: `false`.</li></ul> |

> [accordion] whatsappMessage.image
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `id` | string | Нет | \*\*Используйте этот параметр при загрузке медиафайла на серверы WhatsApp.\*\*Укажите идентификатор медиаобъекта, полученный через WhatsApp media upload API (\[[https://docs.ycloud.com/reference/whatsapp\_media-upload#/](https://docs.ycloud.com/reference/whatsapp_media-upload#/)]\([https://docs.ycloud.com/reference/whatsapp\_media-upload#/)).Примечание](https://docs.ycloud.com/reference/whatsapp_media-upload#/\)\).Примечание): необходимо указать либо `id`, либо `link`. Если указаны оба параметра, приоритет имеет `id`. |
> | `link` | string | Нет | \*\*Используйте этот параметр при отправке медиафайлов напрямую с вашего сервера.\*\*Протокол и URL отправляемого медиафайла. Используйте только URL-адреса HTTP/HTTPS.Примечание: WhatsApp Cloud API кеширует медиаресурсы на 10 минут. Чтобы гарантировать получение актуального содержимого, добавьте в URL случайные параметры строки запроса.Примечание: необходимо указать либо `id`, либо `link`. Если указаны оба параметра, `id` имеет приоритет, а `link` будет проигнорирован. |
> | `caption` | string | Нет | Описывает указанный медиафайл `image`, `gif`, `video` или `document`. Не применимо в `header` сообщений `template` или `interactive`. |
> | `filename` | string | Нет | Задает имя файла для конкретного документа. Используется только с медиафайлами `document`. |

> [accordion] whatsappMessage.video
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `id` | string | Нет | \*\*Используйте этот параметр, если медиафайл загружен на серверы WhatsApp.\*\*Укажите ID медиаобъекта, полученный через WhatsApp media upload API (\[[https://docs.ycloud.com/reference/whatsapp\_media-upload#/](https://docs.ycloud.com/reference/whatsapp_media-upload#/)]\([https://docs.ycloud.com/reference/whatsapp\_media-upload#/)).Примечание](https://docs.ycloud.com/reference/whatsapp_media-upload#/\)\).Примечание): необходимо указать либо `id`, либо `link`. Если указаны оба параметра, приоритет имеет `id`. |
> | `link` | string | Нет | \*\*Используйте этот параметр при отправке медиафайла напрямую с вашего сервера.\*\*Протокол и URL отправляемого медиафайла. Используйте только с URL-адресами HTTP/HTTPS.Примечание: WhatsApp Cloud API кэширует медиаресурсы на 10 минут. Чтобы гарантировать актуальность контента, добавьте к URL случайные параметры строки запроса.Примечание: необходимо указать либо `id`, либо `link`. Если указаны оба параметра, приоритет имеет `id`, а `link` игнорируется. |
> | `caption` | string | Нет | Описывает указанный медиафайл `image`, `gif`, `video` или `document`. Не применяется в `header` сообщений типа `template` или `interactive`. |
> | `filename` | string | Нет | Описывает имя файла для указанного документа. Используется только с медиафайлами `document`. |

> [accordion] whatsappMessage.audio
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `id` | string | Нет | \*\*Используйте этот параметр, если медиафайл загружен на серверы WhatsApp.\*\*Укажите ID медиаобъекта, полученный через WhatsApp media upload API (\[[https://docs.ycloud.com/reference/whatsapp\_media-upload#/](https://docs.ycloud.com/reference/whatsapp_media-upload#/)]\([https://docs.ycloud.com/reference/whatsapp\_media-upload#/)).Примечание](https://docs.ycloud.com/reference/whatsapp_media-upload#/\)\).Примечание): необходимо указать либо `id`, либо `link`. Если указаны оба параметра, приоритет имеет `id`. |
> | `link` | string | Нет | \*\*Используйте этот параметр при отправке медиафайла напрямую с вашего сервера.\*\*Протокол и URL отправляемого медиафайла. Используйте только с URL-адресами HTTP/HTTPS.Примечание: WhatsApp Cloud API кэширует медиаресурсы на 10 минут. Чтобы гарантировать актуальность контента, добавьте к URL случайные параметры строки запроса.Примечание: необходимо указать либо `id`, либо `link`. Если указаны оба параметра, приоритет имеет `id`, а `link` игнорируется. |
> | `caption` | string | Нет | Описывает указанный медиафайл `image`, `gif`, `video` или `document`. Не применяется в `header` сообщений типа `template` или `interactive`. |
> | `filename` | string | Нет | Описывает имя файла для указанного документа. Используется только с медиафайлами `document`. |

> [accordion] whatsappMessage.document
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `id` | string | Нет | \*\*Используйте этот параметр, если медиафайл загружен на серверы WhatsApp.\*\*Укажите ID медиаобъекта, полученный через WhatsApp media upload API (\[[https://docs.ycloud.com/reference/whatsapp\_media-upload#/](https://docs.ycloud.com/reference/whatsapp_media-upload#/)]\([https://docs.ycloud.com/reference/whatsapp\_media-upload#/)).Примечание](https://docs.ycloud.com/reference/whatsapp_media-upload#/\)\).Примечание): необходимо указать либо `id`, либо `link`. Если указаны оба параметра, приоритет имеет `id`. |
> | `link` | string | Нет | \*\*Используйте этот параметр при отправке медиафайла напрямую с вашего сервера.\*\*Протокол и URL отправляемого медиафайла. Используйте только с URL-адресами HTTP/HTTPS.Примечание: WhatsApp Cloud API кэширует медиаресурсы на 10 минут. Чтобы гарантировать актуальность контента, добавьте к URL случайные параметры строки запроса.Примечание: необходимо указать либо `id`, либо `link`. Если указаны оба параметра, приоритет имеет `id`, а `link` игнорируется. |
> | `caption` | string | Нет | Описывает указанный медиафайл: `image`, `gif`, `video` или `document`. Неприменимо для сообщений типа `template` или `interactive` в `header`. |
> | `filename` | string | Нет | Задает имя файла для конкретного документа. Используется только с медиафайлами `document`. |

> [accordion] whatsappMessage.sticker
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `id` | string | Нет | \*\*Используйте это, когда медиафайл загружен на серверы WhatsApp.\*\*Укажите идентификатор медиаобъекта, полученный из WhatsApp media upload API (\[[https://docs.ycloud.com/reference/whatsapp\_media-upload#/](https://docs.ycloud.com/reference/whatsapp_media-upload#/)]\([https://docs.ycloud.com/reference/whatsapp\_media-upload#/)).Примечание](https://docs.ycloud.com/reference/whatsapp_media-upload#/\)\).Примечание): необходимо указать либо `id`, либо `link`. Если указаны оба, приоритет имеет `id`. |
> | `link` | string | Нет | \*\*Используйте это при отправке медиафайлов напрямую с вашего сервера.\*\*Протокол и URL отправляемого медиафайла. Используйте только URL HTTP/HTTPS.Примечание: WhatsApp Cloud API кэширует медиаресурсы на 10 минут. Чтобы гарантировать доставку актуального контента, добавляйте в URL случайные строки запроса (query strings).Примечание: необходимо указать либо `id`, либо `link`. Если указаны оба, приоритет имеет `id`, а `link` будет проигнорирован. |
> | `caption` | string | Нет | Описывает указанный медиафайл: `image`, `gif`, `video` или `document`. Неприменимо для сообщений типа `template` или `interactive` в `header`. |
> | `filename` | string | Нет | Задает имя файла для конкретного документа. Используется только с медиафайлами `document`. |

> [accordion] whatsappMessage.location
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `latitude` | number (double) | Да | Широта местоположения. |
> | `longitude` | number (double) | Да | Долгота местоположения. |
> | `name` | string | Нет | Название местоположения. |
> | `address` | string | Нет | Адрес местоположения. Отображается только при наличии `name`. |

> [accordion] whatsappMessage.interactive
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `type` | string | Нет | **Обязательный.** Тип интерактивного сообщения, которое вы хотите отправить.<ul><li>`button`: используется для кнопок быстрого ответа (Reply Buttons).</li><li>`list`: используется для сообщений со списком (List Messages).</li><li>`cta_url`: используется для сообщений с кнопкой призыва к действию (CTA URL Button Messages).</li><li>`product`: используется для сообщений с одним товаром (Single Product Messages).</li><li>`product_list`: используется для сообщений с несколькими товарами (Multi-Product Messages).</li><li>`catalog_message`: используется для сообщений каталога (Catalog Messages).</li><li>`location_request_message`: используется для сообщений с запросом местоположения (Location Request Messages).</li><li>`order_details`: используется для сообщений с деталями заказа (Order Details Messages).</li><li>`order_status`: используется для сообщений со статусом заказа (Order Status Messages).</li><li>`voice_call`: используется для сообщений голосового вызова (Voice Call Messages).</li><li>`flow`: используется для сообщений Flows (Flow Messages).</li></ul> |
> | `action` | object | Нет | **Обязательный.** Действие, которое должен совершить пользователь после прочтения сообщения `interactive`. |
> | `body` | object | Нет | Необязательно для типа `product`. Обязательно для других типов сообщений. |
> | `header` | object | Нет | Обязательно для типа `product_list`. Необязательно для других типов. |
> | `footer` | object | Нет | Необязательно. Объект с нижним колонтитулом (footer) сообщения. |

> [accordion] whatsappMessage.interactive.action
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `buttons` | object\[] | Нет | Обязательно для Reply Buttons (кнопок быстрого ответа). Можно указать до 3 кнопок. |
> | `button` | string | Нет | Обязательно для List Messages (сообщений со списком). Текст кнопки. Не может быть пустой строкой и должен быть уникальным в пределах сообщения. Эмодзи поддерживаются, разметка Markdown — нет. Максимальная длина: 20 символов.Максимальная длина: `20`. |
> | `catalog_id` | string | Нет | Обязательно для сообщений с одним товаром (Single Product Messages) и несколькими товарами (Multi-Product Messages). Уникальный идентификатор каталога Facebook, связанного с вашим аккаунтом WhatsApp Business. Этот ID можно получить через [Meta Commerce Manager](https://business.facebook.com/commerce). |
> | `product_retailer_id` | string | Нет | Обязательно для сообщений с одним товаром (Single Product Messages) и несколькими товарами (Multi-Product Messages). Уникальный идентификатор товара в каталоге. |
> | `sections` | object\[] | Нет | Обязательно для сообщений со списком (List Messages) и сообщений с несколькими товарами (Multi-Product Messages). Массив объектов разделов. Минимум 1, максимум 10. |
> | `name` | string | Нет | Название действия. Обязательно для кнопок с призывом к действию (CTA).<ul><li>`cta_url`: используйте для кнопок CTA с переходом по URL.</li><li>`catalog_message`: используйте для сообщений каталога (Catalog Messages).</li><li>`send_location`: используйте для кнопок запроса местоположения (Location Request).</li><li>`flow`: используйте для кнопок Flow.</li><li>`review_and_pay`: используйте для кнопок сведений о заказе (Order Details).</li><li>`review_order`: используйте для кнопок статуса заказа (Order Status).</li><li>`voice_call`: используйте для кнопок голосового вызова (Voice Call).</li></ul> |
> | `parameters` | object | Нет | Параметры действия. Обязательно для кнопок с призывом к действию (CTA). |

> [accordion] whatsappMessage.interactive.action.buttons\[]
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `type` | string | Нет | Единственный поддерживаемый тип — `reply` (для кнопки Reply Button). |
> | `reply` | object | Нет | Поля объекта перечислены ниже. |

> [accordion] whatsappMessage.interactive.action.buttons\[].reply
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `title` | string | Нет | Заголовок кнопки. Не может быть пустой строкой и должен быть уникальным в пределах сообщения. Эмодзи поддерживаются, разметка Markdown — нет. Максимальная длина: 20 символов.Максимальная длина: `20`. |
> | `id` | string | Нет | Уникальный идентификатор вашей кнопки. Этот ID возвращается в Webhook при нажатии кнопки пользователем. Максимальная длина: 256 символов. При установке ID нельзя использовать начальные и конечные пробелы.Максимальная длина: `256`. |

> [accordion] whatsappMessage.interactive.action.sections\[]
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `title` | string | Нет | **Обязательно, если сообщение содержит более одного раздела.** Название раздела. Максимальная длина: 24 символа.Максимальная длина: `24`. |
> | `rows` | object\[] | Нет | Содержит список строк. Всего во всех разделах может быть не более 10 строк. У каждой строки должны быть заголовок (максимальная длина: 24 символа) и ID (максимальная длина: 200 символов). Можно добавить описание (максимальная длина: 72 символа), но это необязательно. |
> | `product_items` | object\[] | Нет | Обязательно для сообщений с несколькими товарами (Multi-Product Messages). Массив объектов товаров. Минимум 1 товар на секцию и максимум 30 товаров во всех секциях. |

> [accordion] whatsappMessage.interactive.action.sections\[].rows\[]
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `id` | string | Нет | Уникальный ID строки. Максимальная длина: 200 символов.Максимальная длина: `200`. |
> | `title` | string | Нет | Текст заголовка строки. Максимальная длина: 24 символа.Максимальная длина: `24`. |
> | `description` | string | Нет | Текст описания строки. Максимальная длина: 72 символа.Максимальная длина: `72`. |

> [accordion] whatsappMessage.interactive.action.sections\[].product\_items\[]
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `product_retailer_id` | string | Нет | Обязательно для сообщений с несколькими товарами (Multi-Product Messages). Уникальный идентификатор товара в каталоге. |

> [accordion] whatsappMessage.interactive.action.parameters
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `display_text` | string | Нет | Текст кнопки-ссылки CTA. Максимальная длина: 20 байт.Максимальная длина: `20`. |
> | `url` | string | Нет | URL кнопки-ссылки CTA. |
> | `thumbnail_product_retailer_id` | string | Нет | Артикул (SKU) товара. В [Commerce Manager](https://business.facebook.com/commerce) отображается как **Content ID** . Миниатюра этого товара будет использоваться в качестве изображения в заголовке сообщения. |
> | `flow_message_version` | string | Нет | Используется для кнопок `flow`. Значение должно быть "3". |
> | `flow_token` | string | Нет | Используется для кнопок `flow`. Токен Flow, создаваемый бизнесом для использования в качестве идентификатора. По умолчанию `unused`. |
> | `flow_id` | string | Нет | Условно обязательно для кнопок `flow`. Уникальный ID Flow, предоставленный WhatsApp. Нельзя использовать вместе с параметром `flow_name`. |
> | `flow_name` | string | Нет | Условно обязательно для кнопок `flow`. Название созданного вами Flow. Нельзя использовать вместе с параметром `flow_id`. При изменении названия Flow потребуется обновить этот параметр в соответствии с новым названием. |
> | `flow_cta` | string | Нет | Обязательно для кнопок `flow`. Текст на CTA-кнопке. Например: "Open flow!". Максимальная длина: 20 символов.Максимальная длина: `20`. |
> | `flow_action` | string | Нет | Используется для кнопок `flow`. Либо `navigate`, либо `data_exchange`. По умолчанию `navigate`. |
> | `flow_action_payload` | object | Нет | Обязательно, если `flow_action` имеет значение `navigate`. В противном случае параметр должен быть опущен. |
> | `reference_id` | string | Нет | Обязательно для кнопок `review_ и _pay`. Уникальный идентификатор заказа, предоставляемый бизнесом. Чувствителен к регистру, не может быть пустой строкой, может содержать только латинские буквы, цифры, символы подчеркивания, дефисы или точки и не должен превышать 35 символов.Параметр `reference_id` должен быть уникальным для каждого сообщения order\_details конкретного бизнеса. Если необходимо отправить несколько сообщений order\_details для одного и того же заказа, рекомендуется включить порядковый номер в reference\_id (например, "BM345A-12") для обеспечения уникальности reference\_id. |
> | `type` | string | Нет | Обязательно для кнопок `review_and_pay`. Тип товаров, оплачиваемых в этом заказе. В настоящее время поддерживаются варианты `digital-goods` и `physical-goods`. |
> | `beneficiaries` | object\[] | Нет | Обязательно для кнопок `review_and_pay`. Массив получателей для этого заказа. Получатель — это предполагаемый адресат для доставки физических товаров из заказа. Информация о получателе не отображается пользователям, но требуется по юридическим причинам и требованиям комплаенса. |
> | `currency` | string | Нет | Обязательно для кнопок `review_and_pay`. Валюта для этого заказа. В настоящее время поддерживается только значение `INR`. |
> | `total_amount` | object | Нет | Обязательно для кнопок `review_and_pay`. Общая сумма для этого заказа. |
> | `order` | object | Нет | Обязательно для кнопок `review_and_pay` или `review_order`.Для кнопок `review_and_pay` предоставляет сведения о заказе: `status`, `items`, `subtotal`, `tax` и т. д.Для кнопок `review_order` предоставляет только `status` и `description` заказа. |
> | `payment_settings` | object\[] | Нет | Обязательно для кнопок `review_and_pay`. Настройки оплаты для заказа. |

> [accordion] whatsappMessage.interactive.action.parameters.flow\_action\_payload
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `screen` | string | Нет | Идентификатор экрана, отображаемого первым. Он должен быть экраном **entry** . |
> | `data` | object | Нет | Необязательные входные данные для первого экрана Flow. Если указаны, должны быть непустым объектом. |

> [accordion] whatsappMessage.interactive.action.parameters.beneficiaries\[]
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `name` | string | Да | Имя физического лица или название компании, получающей физические товары. Не может превышать 200 символов.Максимальная длина: `200`. |
> | `address_line1` | string | Да | Адрес доставки (номер дома/строения, название улицы и т. д.). Не может превышать 100 символов.Максимальная длина: `100`. |
> | `address_line2` | string | Нет | Адрес доставки (ориентир, район и т. д.). Не может превышать 100 символов.Максимальная длина: `100`. |
> | `city` | string | Да | Название города. |
> | `state` | string | Да | Название штата/региона. |
> | `country` | string | Да | Название страны. В настоящее время поддерживается только значение `India`. |
> | `postal_code` | string | Да | 6-значный почтовый индекс адреса доставки.Минимальная длина: `6`. Максимальная длина: `6`. |

> [accordion] whatsappMessage.interactive.action.parameters.total\_amount
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `offset` | integer (int32) | Да | Должно быть `100` для `INR`. |
> | `value` | integer (int32) | Да | Положительное целое число, представляющее значение суммы, умноженное на смещение (offset). Например, ₹12.34 имеет значение 1234. |
> | `description` | string | Нет | Используйте только для `tax`, `shipping` или `discount`. Описание суммы. Максимальный лимит составляет 60 символов.Максимальная длина: `60`. |
> | `discount_program_name` | string | Нет | Используйте только для `discount`. Текст, используемый для определения стимулированных заказов. Если заказ стимулированный, продавец должен указать эту информацию. Максимальная длина — 60 символов.Максимальная длина: `60`. |

> [accordion] whatsappMessage.interactive.action.parameters.order
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `status` | string | Нет | Единственное поддерживаемое значение в сообщении `order_details` — `pending`. В сообщении `order_status` поле `status` может принимать значения: `pending`, `processing`, `partially_shipped`, `shipped`, `completed` или `canceled`. |
> | `type` | string | Нет | Единственное поддерживаемое значение — `quick_pay`. При передаче этого поля кнопка «Review and Pay» скрывается, и в блоке сведений о заказе отображается только кнопка «Pay Now». |
> | `catalog_id` | string | Нет | Уникальный идентификатор каталога Facebook, используемого компанией. Если вы не передаете это поле, необходимо передать следующие поля внутри объекта items: `country_of_origin`, `importer_name` и `importer_address`. |
> | `items` | object\[] | Нет | Массив позиций в заказе. |
> | `subtotal` | object | Нет | Значение **должно быть равно** сумме `order.amount.value` \* `order.amount.quantity`. |
> | `tax` | object | Нет | Информация о налогах для этого заказа. |
> | `shipping` | object | Нет | Стоимость доставки заказа. |
> | `discount` | object | Нет | Сумма скидки для этого заказа. |
> | `expiration` | object | Нет | Срок действия этого заказа. |
> | `description` | string | Нет | **Необязательно.** Текст для передачи информации, связанной со статусом. Может быть полезен при отправке отмены. Максимальная длина — 120 символов.Максимальная длина: `120`. |

> [accordion] whatsappMessage.interactive.action.parameters.order.items\[]
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `retailer_id` | string | Нет | Идентификатор контента (Content ID) для позиции в заказе из вашего каталога. |
> | `name` | string | Да | Название товара, отображаемое пользователю. Не может превышать 60 символов.Максимальная длина: `60`. |
> | `image` | object | Нет | Пользовательское изображение товара, отображаемое пользователю. |
> | `amount` | object | Да | Цена за единицу товара. |
> | `sale_amount` | object | Нет | Цена со скидкой за единицу товара. Должна быть меньше исходной стоимости. Если указано, это поле используется для расчета промежуточного итога. |
> | `quantity` | integer (int32) | Да | Количество позиций в заказе. |
> | `country_of_origin` | string | Нет | Обязательно, если не указано `catalog_id`. Страна происхождения товара. |
> | `importer_name` | string | Нет | Обязательно, если не указано `catalog_id`. Название компании-импортера. |
> | `importer_address` | string | Нет | Обязательно, если не указано `catalog_id`. Адрес компании-импортера. |

> [accordion] whatsappMessage.interactive.action.parameters.order.items\[].image
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `id` | string | Нет | \*\*Используйте это, когда медиафайл загружен на серверы WhatsApp.\*\*Укажите ID медиаобъекта, полученный из WhatsApp media upload API (\[[https://docs.ycloud.com/reference/whatsapp\_media-upload#/](https://docs.ycloud.com/reference/whatsapp_media-upload#/)]\([https://docs.ycloud.com/reference/whatsapp\_media-upload#/)).Примечание](https://docs.ycloud.com/reference/whatsapp_media-upload#/\)\).Примечание): необходимо указать либо `id`, либо `link`. Если указаны оба, приоритет имеет `id`. |
> | `link` | string | Нет | \*\*Используйте это при отправке медиафайла напрямую с вашего сервера.\*\*Протокол и URL отправляемого медиафайла. Используйте только с URL HTTP/HTTPS.Примечание: WhatsApp Cloud API кэширует медиаресурсы на 10 минут. Чтобы гарантировать получение актуального контента, добавьте случайные параметры запроса к URL.Примечание: необходимо указать либо `id`, либо `link`. Если указаны оба, приоритет имеет `id`, а `link` будет проигнорирован. |
> | `caption` | string | Нет | Описывает указанный медиафайл `image`, `gif`, `video` или `document`. Не применяется в `header` сообщений типа `template` или `interactive`. |
> | `filename` | string | Нет | Описывает имя файла для указанного документа. Используйте только для медиафайлов `document`. |

> [accordion] whatsappMessage.interactive.action.parameters.order.items\[].amount
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `offset` | integer (int32) | Да | Должно быть `100` для `INR`. |
> | `value` | integer (int32) | Да | Положительное целое число, представляющее значение суммы, умноженное на смещение (offset). Например, ₹12.34 имеет значение 1234. |
> | `description` | string | Нет | Используйте только для `tax`, `shipping` или `discount`. Описание суммы. Максимальная длина — 60 символов.Максимальная длина: `60`. |
> | `discount_program_name` | string | Нет | Используйте только для `discount`. Текст, используемый для определения заказов со стимулированием (скидкой/бонусом). Если к заказу применяется скидка, продавец должен указать эту информацию. Максимальная длина — 60 символов.Максимальная длина: `60`. |

> [accordion] whatsappMessage.interactive.action.parameters.order.items\[].sale\_amount
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `offset` | integer (int32) | Да | Должно быть `100` для `INR`. |
> | `value` | integer (int32) | Да | Положительное целое число, представляющее значение суммы, умноженное на смещение (offset). Например, ₹12.34 имеет значение 1234. |
> | `description` | string | Нет | Используйте только для `tax`, `shipping` или `discount`. Описание суммы. Максимальная длина — 60 символов.Максимальная длина: `60`. |
> | `discount_program_name` | string | Нет | Используйте только для `discount`. Текст, используемый для определения заказов со стимулированием (скидкой/бонусом). Если к заказу применяется скидка, продавец должен указать эту информацию. Максимальная длина — 60 символов.Максимальная длина: `60`. |

> [accordion] whatsappMessage.interactive.action.parameters.order.subtotal
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `offset` | integer (int32) | Да | Должно быть `100` для `INR`. |
> | `value` | integer (int32) | Да | Положительное целое число, представляющее значение суммы, умноженное на смещение (offset). Например, ₹12.34 имеет значение 1234. |
> | `description` | string | Нет | Используйте только для `tax`, `shipping` или `discount`. Описание суммы. Максимальная длина — 60 символов.Максимальная длина: `60`. |
> | `discount_program_name` | string | Нет | Используйте только для `discount`. Текст, используемый для определения заказов с поощрением (скидкой). Если заказ содержит поощрение, продавец должен указать эту информацию. Максимальная длина — 60 символов.Максимальная длина: `60`. |

> [accordion] whatsappMessage.interactive.action.parameters.order.tax
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `offset` | integer (int32) | Да | Должно быть `100` для `INR`. |
> | `value` | integer (int32) | Да | Положительное целое число, представляющее сумму, умноженную на offset. Например, для ₹12.34 значение равно 1234. |
> | `description` | string | Нет | Используйте только для `tax`, `shipping` или `discount`. Описание суммы. Максимальная длина — 60 символов.Максимальная длина: `60`. |
> | `discount_program_name` | string | Нет | Используйте только для `discount`. Текст, используемый для определения заказов с поощрением (скидкой). Если заказ содержит поощрение, продавец должен указать эту информацию. Максимальная длина — 60 символов.Максимальная длина: `60`. |

> [accordion] whatsappMessage.interactive.action.parameters.order.shipping
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `offset` | integer (int32) | Да | Должно быть `100` для `INR`. |
> | `value` | integer (int32) | Да | Положительное целое число, представляющее сумму, умноженную на offset. Например, для ₹12.34 значение равно 1234. |
> | `description` | string | Нет | Используйте только для `tax`, `shipping` или `discount`. Описание суммы. Максимальная длина — 60 символов.Максимальная длина: `60`. |
> | `discount_program_name` | string | Нет | Используйте только для `discount`. Текст, используемый для определения заказов с поощрением (скидкой). Если заказ содержит поощрение, продавец должен указать эту информацию. Максимальная длина — 60 символов.Максимальная длина: `60`. |

> [accordion] whatsappMessage.interactive.action.parameters.order.discount
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `offset` | integer (int32) | Да | Должно быть `100` для `INR`. |
> | `value` | integer (int32) | Да | Положительное целое число, представляющее сумму, умноженную на offset. Например, для ₹12.34 значение равно 1234. |
> | `description` | string | Нет | Используйте только для `tax`, `shipping` или `discount`. Описание суммы. Максимальная длина — 60 символов.Максимальная длина: `60`. |
> | `discount_program_name` | string | Нет | Используйте только для `discount`. Текст, используемый для определения заказов с поощрением (скидкой). Если заказ содержит поощрение, продавец должен указать эту информацию. Максимальная длина — 60 символов.Максимальная длина: `60`. |

> [accordion] whatsappMessage.interactive.action.parameters.order.expiration
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `timestamp` | string | Да | Строка с меткой времени UTC в секундах, указывающей время истечения срока действия заказа. Минимальный порог — 300 секунд. |
> | `description` | string | Нет | Текстовое объяснение истечения срока действия.Максимальная длина: `120`. |

> [accordion] whatsappMessage.interactive.action.parameters.payment\_settings\[]
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `type` | string | Да | Должно быть установлено значение `payment_gateway`. |
> | `payment_gateway` | object | Да | Объект, описывающий информацию о платежном аккаунте. |

> [accordion] whatsappMessage.interactive.action.parameters.payment\_settings\[].payment\_gateway
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `type` | string | Да | Тип платежа. Необходимо установить значение `billdesk`, `razorpay`, `payu` или `zaakpay`, если вы подключили платежный шлюз BillDesk, Razorpay, PayU или Zaakpay для приема платежей. |
> | `configuration_name` | string | Да | Название предварительно настроенной платежной конфигурации для этого заказа, длина которого не должна превышать 60 символов. Это значение должно совпадать с платежной конфигурацией, настроенной в WhatsApp Business Manager.Максимальная длина: `60`. |
> | `billdesk` | object | Нет | Дополнительная информация для BillDesk. Пользовательские поля (extra) используются для хранения любой информации, относящейся к конкретному заказу. Каждое дополнительное поле может содержать не более 120 символов. |
> | `payu` | object | Нет | Дополнительная информация для PayU. Пользовательские поля (udf) используются для хранения любой информации, относящейся к конкретному заказу. Каждое поле UDF может содержать не более 255 символов. |
> | `razorpay` | object | Нет | Дополнительная информация для Razorpay. |
> | `zaakpay` | object | Нет | Дополнительная информация для Zaakpay. Пользовательские поля (extra) используются для хранения любой информации, относящейся к конкретному заказу. Каждое дополнительное поле может содержать не более 180 символов. |

> [accordion] whatsappMessage.interactive.action.parameters.payment\_settings\[].payment\_gateway.billdesk
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `additional_info1` | string | Нет | Пользовательская информация об этом заказе для BillDesk.Максимальная длина: `120` символов. |
> | `additional_info2` | string | Нет | Пользовательская информация об этом заказе для BillDesk.Максимальная длина: `120` символов. |
> | `additional_info3` | string | Нет | Пользовательская информация об этом заказе для BillDesk.Максимальная длина: `120` символов. |
> | `additional_info4` | string | Нет | Пользовательская информация об этом заказе для BillDesk.Максимальная длина: `120` символов. |
> | `additional_info5` | string | Нет | Пользовательская информация об этом заказе для BillDesk.Максимальная длина: `120` символов. |
> | `additional_info6` | string | Нет | Пользовательская информация об этом заказе для BillDesk.Максимальная длина: `120` символов. |
> | `additional_info7` | string | Нет | Пользовательская информация об этом заказе для BillDesk.Максимальная длина: `120` символов. |

> [accordion] whatsappMessage.interactive.action.parameters.payment\_settings\[].payment\_gateway.payu
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `udf1` | string | Нет | Пользовательская информация об этом заказе для PayU.Максимальная длина: `255` символов. |
> | `udf2` | string | Нет | Пользовательская информация об этом заказе для PayU.Максимальная длина: `255` символов. |
> | `udf3` | string | Нет | Пользовательская информация об этом заказе для PayU.Максимальная длина: `255` символов. |
> | `udf4` | string | Нет | Пользовательская информация об этом заказе для PayU.Максимальная длина: `255` символов. |

> [accordion] whatsappMessage.interactive.action.parameters.payment\_settings\[].payment\_gateway.razorpay
>
> | Параметр | Тип | Обязательно | Описание |
> | - | - | - | - |
> | `receipt` | string | Нет | Номер квитанции, соответствующий этому заказу, заданный для вашей внутренней ссылки. Поддерживается максимальная длина 40 символов с минимальной длиной более 0 символов. |
> | `notes` | object | Нет | Объект может содержать пары «ключ-значение» максимум с 15 ключами, при этом длина каждого значения ограничена 256 символами. |

> [accordion] whatsappMessage.interactive.action.parameters.payment\_settings\[].payment\_gateway.zaakpay
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `extra1` | string | Нет | Пользовательская информация об этом заказе для Zaakpay.Максимальная длина: `180` символов. |
> | `extra2` | string | Нет | Пользовательская информация об этом заказе для Zaakpay.Максимальная длина: `180` символов. |

> [accordion] whatsappMessage.interactive.body
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `text` | string | Нет | Основной текст сообщения. Поддерживаются эмодзи и разметка markdown. Максимальная длина: 1024 символа.Максимальная длина: `1024`. |

> [accordion] whatsappMessage.interactive.header
>
> | Параметр | Тип | Обязательно | Описание |
> | - | - | - | - |
> | `type` | string | Нет | **Обязательное поле.** Тип заголовка, который вы хотите использовать.<ul><li>`text`: используется для списков (List Messages), кнопок быстрого ответа (Reply Buttons) и сообщений с несколькими товарами (Multi-Product Messages).</li><li>`video`: используется для кнопок быстрого ответа (Reply Buttons).</li><li>`image`: используется для кнопок быстрого ответа (Reply Buttons).</li><li>`document`: используется для кнопок быстрого ответа (Reply Buttons).</li></ul> |
> | `text` | string | Нет | Текст заголовка. Форматирование поддерживает эмодзи, но не поддерживает markdown.Максимальная длина: `60`. |
> | `image` | object | No | Используйте для сообщений типа `image`, `gif`, `video`, `audio`, `document` или `sticker`. См. также [Поддерживаемые типы медиа](https://developers.facebook.com/docs/whatsapp/cloud-api/reference/media#supported-media-types). |
> | `video` | object | Нет | Используется для сообщений типа `image`, `gif`, `video`, `audio`, `document` или `sticker`. См. также раздел [Поддерживаемые типы медиафайлов](https://developers.facebook.com/docs/whatsapp/cloud-api/reference/media#supported-media-types). |
> | `document` | object | No | Используется для сообщений `image`, `gif`, `video`, `audio`, `document` или `sticker`. См. также [Поддерживаемые типы медиа](https://developers.facebook.com/docs/whatsapp/cloud-api/reference/media#supported-media-types). |

> [accordion] whatsappMessage.interactive.header.image
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `id` | string | Нет | \*\*Используйте этот параметр, когда медиафайл загружен на серверы WhatsApp.\*\*Укажите идентификатор медиаобъекта, полученный через WhatsApp media upload API (\[[https://docs.ycloud.com/reference/whatsapp\_media-upload#/](https://docs.ycloud.com/reference/whatsapp_media-upload#/)]\([https://docs.ycloud.com/reference/whatsapp\_media-upload#/)).Примечание](https://docs.ycloud.com/reference/whatsapp_media-upload#/\)\).Примечание): необходимо указать либо `id`, либо `link`. Если указаны оба параметра, приоритет имеет `id`. |
> | `link` | string | Нет | \*\*Используйте этот параметр при отправке медиафайла напрямую с вашего сервера.\*\*Протокол и URL отправляемого медиафайла. Используйте только URL-адреса HTTP/HTTPS.Примечание: WhatsApp Cloud API кэширует медиаресурсы на 10 минут. Чтобы гарантировать получение актуального содержимого, добавьте к URL случайные параметры строки запроса.Примечание: необходимо указать либо `id`, либо `link`. Если указаны оба параметра, приоритет имеет `id`, а параметр `link` будет проигнорирован. |
> | `caption` | string | Нет | Описывает указанный медиафайл `image`, `gif`, `video` или `document`. Не применяется в `header` сообщений `template` или `interactive`. |
> | `filename` | string | Нет | Описывает имя файла для указанного документа. Используется только с медиафайлами `document`. |

> [accordion] whatsappMessage.interactive.header.video
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `id` | string | Нет | \*\*Используйте этот параметр, когда медиафайл загружен на серверы WhatsApp.\*\*Укажите идентификатор медиаобъекта, полученный через WhatsApp media upload API (\[[https://docs.ycloud.com/reference/whatsapp\_media-upload#/](https://docs.ycloud.com/reference/whatsapp_media-upload#/)]\([https://docs.ycloud.com/reference/whatsapp\_media-upload#/)).Примечание](https://docs.ycloud.com/reference/whatsapp_media-upload#/\)\).Примечание): необходимо указать либо `id`, либо `link`. Если указаны оба параметра, приоритет имеет `id`. |
> | `link` | string | Нет | \*\*Используйте этот параметр при отправке медиафайла напрямую с вашего сервера.\*\*Протокол и URL отправляемого медиафайла. Используйте только URL-адреса HTTP/HTTPS.Примечание: WhatsApp Cloud API кэширует медиаресурсы на 10 минут. Чтобы гарантировать получение актуального содержимого, добавьте к URL случайные параметры строки запроса.Примечание: необходимо указать либо `id`, либо `link`. Если указаны оба параметра, приоритет имеет `id`, а параметр `link` будет проигнорирован. |
> | `caption` | string | Нет | Описывает указанный медиафайл `image`, `gif`, `video` или `document`. Не применяется в `header` сообщений `template` или `interactive`. |
> | `filename` | string | Нет | Описывает имя файла для указанного документа. Используется только с медиафайлами `document`. |

> [accordion] whatsappMessage.interactive.header.document
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `id` | string | Нет | \*\*Используйте этот параметр, когда медиафайл загружен на серверы WhatsApp.\*\*Укажите идентификатор медиаобъекта, полученный через WhatsApp media upload API (\[[https://docs.ycloud.com/reference/whatsapp\_media-upload#/](https://docs.ycloud.com/reference/whatsapp_media-upload#/)]\([https://docs.ycloud.com/reference/whatsapp\_media-upload#/)).Примечание](https://docs.ycloud.com/reference/whatsapp_media-upload#/\)\).Примечание): необходимо указать либо `id`, либо `link`. Если указаны оба параметра, приоритет имеет `id`. |
> | `link` | string | Нет | \*\*Используйте этот параметр при отправке медиафайла напрямую с вашего сервера.\*\*Протокол и URL отправляемого медиафайла. Используйте только URL-адреса HTTP/HTTPS.Примечание: WhatsApp Cloud API кэширует медиаресурсы на 10 минут. Чтобы гарантировать получение актуального содержимого, добавьте к URL случайные параметры строки запроса.Примечание: необходимо указать либо `id`, либо `link`. Если указаны оба параметра, приоритет имеет `id`, а параметр `link` будет проигнорирован. |
> | `caption` | string | Нет | Описывает указанный медиафайл `image`, `gif`, `video` или `document`. Не применимо в `header` сообщений `template` или `interactive`. |
> | `filename` | string | Нет | Описывает имя файла для указанного документа. Используйте только с медиафайлами `document`. |

> [accordion] whatsappMessage.interactive.footer
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `text` | string | Нет | Содержимое нижнего колонтитула. Поддерживаются эмодзи и разметка markdown. Поддерживаются ссылки. Максимальная длина: 60 символов.Максимальная длина: `60`. |

> [accordion] whatsappMessage.contacts\[]
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `addresses` | object\[] | Нет | Элементы массива описаны ниже. |
> | `birthday` | string | Нет | Строка в формате `YYYY-MM-DD`. |
> | `emails` | object\[] | Нет | Элементы массива описаны ниже. |
> | `name` | object | Да | Полное имя контакта, оформленное в виде объекта name. |
> | `org` | object | Нет | Сведения об организации контакта, оформленные в виде объекта org. |
> | `phones` | object\[] | Нет | Номер(а) телефона контакта, оформленные в виде объекта phone. |
> | `urls` | object\[] | Нет | URL-адрес(а) контакта, оформленные в виде объекта urls. |
> | `vcard` | string | Нет | Необязательная vCard, передаваемая с полезной нагрузкой общего контакта. |
> | `origin` | string | Нет | Имеет значение `contact_request`, если пользователь поделился контактом в ответ на сообщение с запросом контактных данных. |

> [accordion] whatsappMessage.contacts\[].addresses\[]
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `street` | string | Нет | Номер дома и название улицы. |
> | `city` | string | Нет | Название города. |
> | `state` | string | Нет | Сокращенное название штата/региона. |
> | `zip` | string | Нет | Почтовый индекс. |
> | `country` | string | Нет | Полное название страны. |
> | `country_code` | string | Нет | Двухбуквенный код страны. |
> | `type` | string | Нет | Стандартные значения: `HOME` и `WORK`. |

> [accordion] whatsappMessage.contacts\[].emails\[]
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `email` | string | Нет | Адрес электронной почты. |
> | `type` | string | Нет | Стандартные значения: `HOME` и `WORK`. |

> [accordion] whatsappMessage.contacts\[].name
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `formatted_name` | string | Да | Полное имя в привычном формате отображения. |
> | `first_name` | string | Нет | Имя. |
> | `last_name` | string | Нет | Фамилия. |
> | `middle_name` | string | Нет | Отчество или второе имя. |
> | `suffix` | string | Нет | Суффикс имени. |
> | `prefix` | string | Нет | Префикс имени. |

> [accordion] whatsappMessage.contacts\[].org
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `company` | string | Нет | Название компании контакта. |
> | `department` | string | Нет | Название отдела контакта. |
> | `title` | string | Нет | Должность контакта. |

> [accordion] whatsappMessage.contacts\[].phones\[]
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `phone` | string | Нет | Автоматически заполняется значением `wa_id` в виде отформатированного номера телефона. |
> | `type` | string | Нет | Стандартные значения: `CELL`, `MAIN`, `IPHONE`, `HOME` и `WORK`. |
> | `wa_id` | string | Нет | Идентификатор WhatsApp. |

> [accordion] whatsappMessage.contacts\[].urls\[]
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `url` | string | Нет | URL. |
> | `type` | string | Нет | Стандартные значения: `HOME` и `WORK`. |

> [accordion] whatsappMessage.reaction
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `message_id` | string | Да | Задает `wamid` полученного сообщения, содержавшего реакцию. |
> | `emoji` | string | Нет | **Обязательно** при отправке сообщения типа `reaction`. Установите значение `""`, если хотите удалить эмодзи. **Необязательно** при получении сообщения от пользователя. Это поле включается, когда пользователь реагирует на сообщения с помощью эмодзи. В противном случае оно указывает, что пользователь удалил эмодзи. |

> [accordion] whatsappMessage.context
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `message_id` | string | Нет | Задает `wamid` сообщения, на которое вы отвечаете. `wamid` — исходный идентификатор сообщения на платформе WhatsApp. |

> [accordion] whatsappMessage.whatsappApiError
>
> | Параметр | Тип | Обязательный | Описание |
> | - | - | - | - |
> | `message` | string | Да | Понятное человеку описание ошибки. |
> | `code` | string | Да | Код ошибки. |
> | `type` | string | Нет | Тип ошибки. |
> | `error_subcode` | string | Нет | Дополнительный код ошибки. |
> | `error_user_msg` | string | Нет | Сообщение для отображения пользователю. Язык сообщения зависит от локали API-запроса. |
> | `error_user_title` | string | Нет | Заголовок диалогового окна, если оно отображается. Язык сообщения зависит от локали API-запроса. |
> | `fbtrace_id` | string | Нет | Внутренний идентификатор службы поддержки. При сообщении об ошибке, связанной с вызовом Graph API, укажите fbtrace\_id, чтобы помочь нам найти данные журналов для отладки. |
> | `error_data` | string or object | Нет | Дополнительные данные об ошибке. Строка или ассоциативный массив (map).<ul><li>Для template API это поле представляет собой строку с описанием причины ошибки.</li><li>Для message API это поле представляет собой ассоциативный массив со свойством `details`, описывающим причину ошибки.</li></ul> |

## Пример

Следующий JSON представляет собой тело запроса, доставленное вашему получателю. Идентификаторы, номера телефонов и другие значения аккаунта приведены в качестве примера.

Считайте исходящее сообщение из whatsappMessage. Тип сообщения определяет его объект с содержимым; в этом примере содержится text.

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "id": "evt_example_smb_created",
  "type": "whatsapp.smb.message.created",
  "apiVersion": "v2",
  "createTime": "2026-10-09T08:00:00.000Z",
  "whatsappMessage": {
    "id": "MESSAGE_ID",
    "wamid": "wamid.EXAMPLE",
    "wabaId": "WABA_ID",
    "from": "+12025550124",
    "to": "+12025550123",
    "type": "text",
    "text": {
      "body": "Your order is ready for pickup."
    },
    "status": "sent",
    "createTime": "2026-10-08T12:00:00.000Z",
    "sendTime": "2026-10-08T12:00:00.000Z"
  }
}
```

После проверки подписи и надежного принятия события верните ответ `2xx`. Длительные операции выполняйте асинхронно.

```http theme={"theme":{"light":"github-light","dark":"github-dark"}}
HTTP/1.1 200 OK
```

Пошаговые руководства по сценариям см. в разделе [примеров с пояснениями](https://docs.ycloud.com/ru/api-reference/guides/examples/webhook-examples/whatsapp-business-app-sent-message-sync-webhook-examples).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.