> ## 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, как выбрать категорию, а также подготовиться к проверке и отправке.

Шаблон сообщения — это повторно используемая структура сообщения, привязанная к WhatsApp Business Account (WABA). Перед отправкой шаблонных сообщений вы отправляете шаблон на проверку в Meta.

Используйте шаблон, когда нужно отправить сообщение клиенту вне окна обслуживания клиентов. Вы также можете использовать шаблоны, пока окно открыто. Правила окна см. в разделе [Сервисные сообщения](/ru/documentation/whatsapp-business-platform/messaging/service-messages#customer-service-window).

<Info>
  Одобрение шаблона не дает разрешения на связь с клиентом. Перед отправкой проверяйте согласие клиента и его настройки отказа от рассылок.
</Info>

## Выбор категории шаблона

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

| Категория | Цель | Пример сценария |
| - | - | - |
| [Marketing](/ru/documentation/whatsapp-business-platform/messaging/message-templates/marketing-templates) | Продвижение, рекомендации, повторное вовлечение или побуждение к покупке либо другому действию. | Отправка спецпредложения клиентам, подписавшимся на маркетинговые обновления. |
| [Utility](/ru/documentation/whatsapp-business-platform/messaging/message-templates/utility-templates) | Отправка нерекламного уведомления, связанного с запросом клиента, транзакцией, аккаунтом или другой подходящей важной целью. | Подтверждение записи или обновление информации по существующему заказу. |
| [Authentication](/ru/documentation/whatsapp-business-platform/messaging/message-templates/authentication-message-templates/index) | Аутентификация пользователя с помощью одноразового кода. | Подтверждение входа или запроса на восстановление аккаунта. |

Сообщение, объединяющее статус транзакции со спецпредложением, не является исключительно сервисным (utility). Meta классифицирует смешанный сервисный и рекламный контент как маркетинг (marketing).

Критерии и примеры категорий см. в [руководстве Meta по категоризации шаблонов](https://developers.facebook.com/docs/whatsapp/updates-to-pricing/new-template-guidelines/).

<Tabs>
  <Tab title="Marketing">
    <Frame caption="A promotional offer illustrates marketing content.">
      <div style={{ position: "relative", width: "100%", maxWidth: "590px", margin: "0 auto" }}>
        <img src="https://mintcdn.com/lchnan/Q9LYCM-XEE-Z8muf/product-assets/whatsapp-platform-2026-09-22/meta-marketing-template-components.png?fit=max&auto=format&n=Q9LYCM-XEE-Z8muf&q=85&s=26b207935b6d6d53953bd583297490da" alt="Пример маркетингового сообщения от Meta со скидочным предложением и отмеченными компонентами." style={{ width: "100%", height: "auto", margin: 0 }} width="2321" height="1416" data-path="product-assets/whatsapp-platform-2026-09-22/meta-marketing-template-components.png" />
      </div>
    </Frame>

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

  <Tab title="Utility">
    <Frame caption="A reservation-specific update illustrates utility content.">
      <div style={{ position: "relative", width: "100%", maxWidth: "590px", margin: "0 auto" }}>
        <img src="https://mintcdn.com/lchnan/Q9LYCM-XEE-Z8muf/product-assets/whatsapp-platform-2026-09-22/meta-utility-reservation-components.png?fit=max&auto=format&n=Q9LYCM-XEE-Z8muf&q=85&s=b58bfde95caac7202b309e340d1b5514" alt="Подтверждение бронирования от Meta с отмеченными компонентами." style={{ width: "100%", height: "auto", margin: 0 }} width="590" height="452" data-path="product-assets/whatsapp-platform-2026-09-22/meta-utility-reservation-components.png" />
      </div>
    </Frame>

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

  <Tab title="Authentication">
    <Frame caption="An OTP verifies a requested action; it is separate from marketing and utility content.">
      <div style={{ position: "relative", width: "100%", maxWidth: "590px", margin: "0 auto" }}>
        <img src="https://mintcdn.com/lchnan/Q9LYCM-XEE-Z8muf/product-assets/whatsapp-platform-2026-09-22/meta-authentication-components.png?fit=max&auto=format&n=Q9LYCM-XEE-Z8muf&q=85&s=d91f4d4ad03a1f5d54dded42d229a00c" alt="Пример аутентификации от Meta с указанием кода и текста о безопасности." style={{ width: "100%", height: "auto", margin: 0 }} width="2224" height="2211" data-path="product-assets/whatsapp-platform-2026-09-22/meta-authentication-components.png" />
      </div>
    </Frame>

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

## Разница между шаблоном и сообщением

Шаблон определяет проверенную структуру. Отправляемое вами сообщение заполняет обязательные значения для конкретного получателя.

Например, шаблон обновления статуса заказа может содержать следующее:

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
Your order {{1}} has shipped. Track its progress using the button below.
```

При отправке вы передаете номер заказа и любой другой обязательный контент. Значения переменных должны соответствовать одобренной цели шаблона. Не используйте переменные для вставки стороннего рекламного контента.

Пример приведен исключительно для иллюстрации и не является предварительно одобренным шаблоном.

## Компоненты и форматы

В зависимости от выбранной категории и формата шаблон может содержать:

* Заголовок (header).
* Основной текст (body).
* Нижний колонтитул (footer).
* Кнопки.
* Переменные и примеры значений.

Категории описывают назначение. Форматы описывают визуальное представление. Карусель или медиазаголовок — это выбор формата, а не четвертая категория шаблона.

Не все компоненты или форматы доступны для каждой категории или сценария. Ознакомьтесь с поддерживаемыми вариантами в [руководстве по созданию шаблонов в YCloud](/ru/documentation/channels/whatsapp-accounts-management/template-management/create-template/index) перед созданием сообщения.

Сравнение форматов и подробные руководства см. в разделе [Компоненты и форматы шаблонов](/ru/documentation/whatsapp-business-platform/messaging/message-templates/template-components-and-formats).

## Создание первого рабочего шаблона в YCloud

1. Откройте раздел **Шаблоны**. Если вы управляете несколькими WABA, сначала переключитесь на нужный WABA; шаблон, одобренный в другом WABA, недоступен автоматически для этого отправителя.
2. Введите постоянное имя, используя поддерживаемые редактором строчные буквы, цифры и символы подчеркивания. Выберите понятное имя, описывающее событие, например `booking_confirmation`.
3. Выберите **Marketing**, **Utility** или **Authentication** в зависимости от фактического сценария использования.
4. Выберите точный языковой вариант. Шаблон может иметь несколько языковых версий, но для каждой версии требуется корректный контент и отдельный результат проверки.
5. Настройте поддерживаемые заголовок, текст, нижний колонтитул и кнопки. Укажите примеры значений для переменных и образцы медиафайлов, где это необходимо.
6. Проверьте предпросмотр для клиента, отправьте и подтвердите. Дождитесь результатов проверки, прежде чем использовать шаблон в рабочей отправке.

<Frame caption="Provide sample values for variables and check the customer preview before submitting.">
  <img src="https://mintcdn.com/lchnan/TsMGu8UTNQaUw-Rc/product-assets/english-help-demo-2026-09-23/template-editor-variables.png?fit=max&auto=format&n=TsMGu8UTNQaUw-Rc&q=85&s=fb0de20598b9ed27fb119450092cc245" alt="Редактор англоязычного маркетингового шаблона с переменной в тексте, примером Alex и предпросмотром для клиента." width="3024" height="1656" data-path="product-assets/english-help-demo-2026-09-23/template-editor-variables.png" />
</Frame>

В [полном руководстве по консоли](/ru/documentation/channels/whatsapp-accounts-management/template-management/create-template/index) описана подробная последовательность действий на экране. Все ключевые решения и требования приведены здесь; инструменты Meta для разработчиков для работы с консолью не требуются.

### Язык и повторное использование: частые заблуждения

* **Один одобренный язык не означает одобрение всех языков.** Отправка `en_US` не эквивалентна отправке `en`. Выбирайте именно тот вариант, который был одобрен.
* **Язык шаблона не переводит значения переменных.** Ваша система должна передавать корректные даты, подписи и значения на нужном для клиента языке.
* **Одобрение привязано к ресурсу шаблона в конкретном WABA.** Шаблон с похожим именем в другом WABA является отдельным ресурсом.
* **Шаблон не является списком получателей.** Его создание не приводит к отправке сообщения или подписке пользователей.
* **Одобренный текст — это еще не готовое сообщение.** Отсутствующие переменные, некорректные медиафайлы или неверный параметр кнопки могут привести к ошибке отправки.

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

## От черновика до доставки

1. **Определите цель.** Определите действие клиента или бизнес-событие, которое должно запускать отправку сообщения.
2. **Выберите категорию и содержание.** Составляйте понятный текст и указывайте репрезентативные примеры для переменных.
3. **Создайте и отправьте шаблон.** Используйте интерфейс управления шаблонами YCloud или API.
4. **Проверьте результат модерации.** Не отправляйте шаблон, который все еще ожидает одобрения или недоступен.
5. **Отправляйте и отслеживайте.** Передавайте обязательные значения и отслеживайте доставку сообщений и реакцию клиентов.

Статус проверки и качество — это разные показатели. Одобрение не гарантирует постоянную доступность: последующие отзывы или механизмы контроля платформы могут повлиять на шаблон.

См. раздел [Проверка шаблонов и их жизненный цикл](/ru/documentation/whatsapp-business-platform/messaging/message-templates/template-review-and-lifecycle), чтобы узнать о результатах проверки и безопасных изменениях, а также раздел [Контроль качества и доставки](/ru/documentation/whatsapp-business-platform/pricing-limits-and-quality/quality-and-delivery-controls) для информации об ограничениях отправки.

## Перед отправкой

* Убедитесь, что клиент ожидает это сообщение.
* Проверьте, что выбранный шаблон принадлежит нужному WABA.
* Используйте корректную одобренную языковую версию.
* Передайте все обязательные значения и медиафайлы.
* Проверьте текущий статус шаблона.
* Уточните актуальные тарифы и возможные ограничения на отправку.
* Предусмотрите обработку ошибок доставки и отказов от рассылки.

## Начало работы с шаблонами

<CardGroup cols={2}>
  <Card title="Создание шаблона в YCloud" icon="file-lines" href="/ru/documentation/channels/whatsapp-accounts-management/template-management/create-template/index">
    Создайте и отправьте шаблон на проверку через консоль.
  </Card>

  <Card title="Управление шаблонами через API" icon="code" href="/ru/api-reference/guides/whatsapp-platform/manage-whatsapp-templates">
    Работайте с ресурсами шаблонов в вашей интеграции.
  </Card>

  <Card title="Отправка сообщения WhatsApp" icon="paper-plane" href="/ru/api-reference/guides/whatsapp-platform/send-whatsapp-message">
    Укажите шаблон и персонализированные значения для получателя.
  </Card>

  <Card title="Сервисные сообщения" icon="message" href="/ru/documentation/whatsapp-business-platform/messaging/service-messages">
    Узнайте, в каких случаях можно отправлять ответы в свободной форме.
  </Card>
</CardGroup>

## Часто задаваемые вопросы

<AccordionGroup>
  <Accordion title="Я изменил пример значения во время проверки. Получат ли клиенты это значение?">
    Примеры при проверке помогают Meta понять назначение плейсхолдеров. Они не используются в качестве реальных данных для клиентов при отправке. При отправке передавайте все обязательные параметры в соответствии с одобренной структурой и языком. Тестируйте на синтетических данных, чтобы пример из проверки случайно не был отправлен в качестве номера заказа, имени или кода подтверждения.
  </Accordion>

  <Accordion title="Могу ли я использовать один одобренный шаблон на английском языке для клиентов на любых языках?">
    Вы должны отправлять одобренную языковую версию, существующую для данного WABA и имени шаблона. Простой выбор другого кода языка не переводит текст и не одобряет новую версию. Направляйте получателям соответствующую одобренную языковую версию или используйте подходящий существующий резервный вариант.
  </Accordion>

  <Accordion title="Почему шаблон с одним и тем же именем работает с одного номера, но выдает ошибку с другого?">
    Проверьте WABA обоих номеров. Шаблон привязан к конкретному WABA, а не доступен глобально во всем аккаунте YCloud. Сравните WABA, имя, язык, статус и переданные компоненты для неудавшейся отправки. Если активы изменились в результате миграции или замены, обновите параметры в запросе вместо повторных попыток со старой комбинацией.
  </Accordion>
</AccordionGroup>


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