Skip to main content
Создайте свой шаблон с основным текстом (body), опциональным заголовком (header) и нижним колонтитулом (footer), а также кнопками. Добавьте переменные для содержимого, которое меняется для разных получателей. К форматам аутентификации и специализированным форматам применяются дополнительные ограничения.

​
Анатомия стандартного шаблона

Эти лимиты не гарантируют, что каждый специализированный шаблон принимает любую комбинацию. Шаблоны аутентификации используют предустановленный текст; карточки-карусели, предложения с ограниченным сроком действия, коммерческие шаблоны и компоненты звонков имеют собственную структуру. Удобная стандартная структура:
Пример иллюстрирует только структуру; он не является предварительно одобренным Meta.
Анатомия шаблона Meta с подписанными заголовком, основным текстом, колонтитулом, ссылкой, номером телефона и кнопками быстрого ответа.

Meta labels the standard components. This promotional example illustrates structure, not a utility-category decision.

Источник: официальный пример Meta.

​
Выбор правильного действия для кнопки

Кнопка быстрого ответа с текстом Stop promotions не является автоматической реализацией отписки. Ваш рабочий процесс должен распознавать ответ и обновлять предпочтения клиента. См. раздел Отказ клиентов от рассылки.

​
Порядок кнопок влияет на удобство использования и совместимость

Располагайте наиболее важные действия первыми. Если кнопок больше трех, WhatsApp отображает первые две и элемент управления See all options для остальных.
Шаблон WhatsApp с двумя видимыми кнопками действий и пунктом See all options рядом с развернутым списком, содержащим действия URL, звонка и быстрых ответов.

Meta's example of a template with additional actions behind See all options. Client appearance may vary.

Источник: компоненты шаблонов Meta. Разделяйте быстрые ответы и другие типы кнопок на отдельные группы:
  • Допустимая группировка: URL → Телефон → Быстрый ответ → Быстрый ответ.
  • Недопустимая группировка: Быстрый ответ → URL → Быстрый ответ.
В настоящее время в документации Meta описано ограничение десктопной версии для шаблонов с четырьмя и более кнопками либо при смешивании быстрого ответа с другим типом кнопок: получателям предлагается просмотреть такие сообщения на телефоне. Протестируйте это поведение, если вашей аудитории важен доступ с компьютера.

​
Переменные: проектирование, проверка и отправка — это отдельные этапы

Для этого текста сообщения:
Используйте сопоставление (маппинг), которое ваша команда и интеграция смогут легко поддерживать: Примеры для проверки показывают, что означает переменная. Они не настраивают источник данных и не заполняют будущие сообщения автоматически. У заголовка, тела сообщения и каждой динамической кнопки отдельные позиции параметров. Переменная {{1}} в теле и кнопка-URL {{1}} не обязаны содержать одно и то же значение. Кнопка index указывает позицию кнопки в шаблоне, начиная с 0; это не номер переменной тела.

​
Пример: значения в теле и динамический URL

Предположим, проверенный шаблон содержит:
  • Тело: Your booking {{1}} is confirmed for {{2}}.
  • Кнопка с индексом 0: https://example.com/bookings/{{1}}
Объект template сообщения YCloud может сопоставлять их следующим образом:
Это фрагмент объекта template, а не полный запрос на отправку. Предполагается, что указанный шаблон и точный языковой вариант одобрены в WABA отправителя. Параметр кнопки передает суффикс, а не полный URL. Используйте стабильный целевой домен в проверяемом шаблоне. Корректно кодируйте значения URL и избегайте передачи в ссылках конфиденциальной информации или долгоживущих учетных данных. Не используйте переменные, чтобы скрыть реальную категорию сообщения.

​
Медиазаголовки: примеры файлов не являются реальными вложениями

Для заголовка с изображением, видео или документом:
  1. Выберите нужный формат заголовка при создании шаблона.
  2. Предоставьте репрезентативный образец для проверки.
  3. В момент отправки передайте фактический медиафайл, используя поддерживаемый YCloud media ID или поле ссылки.
  4. Убедитесь, что файл доступен для скачивания, его формат соответствует шаблону и не превышает лимиты на медиафайлы.
  5. Протестируйте доставленное сообщение, включая читаемость файла на телефоне.
Не отправляйте параметр изображения в шаблон с видеозаголовком. Приватный URL, доступный только после авторизации, не является надежной медиассылкой для сервиса обмена сообщениями. GIF-заголовки присутствуют в текущих спецификациях, однако Meta ограничивает эту возможность соответствующим маршрутом Marketing Messages API for WhatsApp . Не предполагайте, что она доступна в любом стандартном рабочем процессе с шаблонами только потому, что поле существует.

​
Выбор специализированного формата

​
Диагностика ошибок компонентов

Руководство по API шаблонов YCloud и контракт OpenAPI определяют поля YCloud. Поддержка компонентов со стороны Meta не гарантирует, что каждый редактор YCloud, Inbox, Campaign или маршрут API предоставляет такую же функциональность. Перейдите к разделам Создание шаблона и Проверка и жизненный цикл шаблона.