> ## 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.

# Шаблоны с промокодами

> Позвольте клиентам копировать промокод из маркетингового сообщения.

Шаблон с промокодом — это маркетинговое сообщение с кнопкой, которая копирует промокод в буфер обмена клиента.

<Frame caption="A promotional code is copied for redemption.">
  <div style={{ position: "relative", width: "100%", maxWidth: "480px", margin: "0 auto" }}>
    <img src="https://mintcdn.com/lchnan/Q9LYCM-XEE-Z8muf/product-assets/whatsapp-platform-2026-09-22/meta-coupon-code-components.png?fit=max&auto=format&n=Q9LYCM-XEE-Z8muf&q=85&s=88616456fe6538fb7eaab12f5f5050c1" alt="Сообщение с промокодом Meta с обозначением промокода, скидки, кнопки копирования кода и кнопки быстрого ответа." style={{ width: "100%", height: "auto", margin: 0 }} width="546" height="739" data-path="product-assets/whatsapp-platform-2026-09-22/meta-coupon-code-components.png" />
  </div>
</Frame>

Источник: [официальный пример Meta](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/marketing-templates/coupon-templates/).

## Сделайте предложение понятным

Укажите выгоду, место применения кода и важные условия. Например:

> Сэкономьте 15% на избранных дорожных сумках с промокодом TRAVEL15. Действует до 30 сентября на заказы от \$50. Подходящие товары и полные условия смотрите на странице акции.

Это наглядный пример текста, а не утверждение, что любая акция или товар подходят под эти условия.

Решите, является ли код общим, одноразовым или персонализированным. Ваша промо-система — а не WhatsApp — контролирует минимальную сумму заказа, подходящие товары, лимит активаций и срок действия.

## Настройте шаблон

1. Выберите нужный WABA и шаблон категории **Marketing** .
2. Напишите текст сообщения и укажите реалистичные примеры для переменных.
3. Добавьте поддерживаемую кнопку копирования кода.
4. Добавьте ссылку назначения или инструкции, объясняющие, где применить предложение.
5. Отправьте шаблон и дождитесь одобрения.

Шаблон определяет кнопку и пример для проверки. Запрос на отправку передает фактический промокод. Если текст сообщения также содержит код, укажите одинаковое значение в обоих местах.

Для отправки через API кнопка использует подтип `copy_code` с параметром типа `coupon_code`. Это отличается от специального поведения отправки OTP-кнопок в шаблонах аутентификации.

Пример **только компонента кнопки при отправке**:

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "type": "button",
  "sub_type": "copy_code",
  "index": 0,
  "parameters": [
    { "type": "coupon_code", "coupon_code": "TRAVEL15" }
  ]
}
```

Используйте фактическую позицию кнопки с отсчетом от нуля; `0` означает первую кнопку. Этот фрагмент не включает обязательную оболочку сообщения или параметры основного текста.

<a id="limitations" />

## Ограничения и поведение клиентов

Текущая документация Meta по шаблонам с промокодами указывает одну кнопку копирования кода, системную надпись кнопки и максимум 20 символов для примера кода. Поле YCloud OpenAPI не объявляет собственный максимум длины кода; если ваш редактор применяет меньший лимит, используйте этот поддерживаемый лимит и подтвердите любые несоответствия перед отправкой.

Meta также отмечает, что этот формат не поддерживается в веб-клиенте WhatsApp. Протестируйте отображение на телефоне; не утверждайте дизайн исключительно на основе переписки на компьютере.

Используйте короткий, однозначный код. Избегайте использования учетных данных аккаунта, кодов аутентификации или персональных данных в качестве промокодов.

## Тестируйте применение кода, а не только копирование

Убедитесь, что скопированное значение совпадает с текстом, страница акции принимает его, корзины с подходящими и неподходящими товарами ведут себя корректно, а просроченные или уже использованные коды отклоняются соответствующим образом.

Отслеживайте доставку сообщений и фактическое применение промокодов отдельно. Взаимодействие с кнопкой копирования не является доказательством покупки.

Продолжите изучение с помощью разделов [Маркетинговые шаблоны](/ru/documentation/whatsapp-business-platform/messaging/message-templates/marketing-templates), [Управление шаблонами](/ru/api-reference/guides/whatsapp-platform/manage-whatsapp-templates) и [Отправка сообщений WhatsApp](/ru/api-reference/guides/whatsapp-platform/send-whatsapp-message).

Источник: [Шаблоны промокодов Meta](https://developers.facebook.com/docs/whatsapp/business-management-api/message-templates/coupon-templates/).


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