Компоненты шаблона | Документация для разработчиков
Компоненты шаблона
Обновлено: 21 ноября 2025 г
Шаблоны состоят из четырех основных компонентов, которые вы определяете при создании шаблона: заголовок, основная часть, нижний колонтитул и кнопки. Компоненты, которые вы выбираете для каждого из ваших шаблонов, должны основываться на потребностях вашего бизнеса. Единственным обязательным компонентом является основная часть.
Некоторые компоненты поддерживают переменные, значения которых можно указать при использовании Cloud API для отправки шаблона в сообщении шаблона. Если ваши шаблоны используют переменные, необходимо указать примеры значений переменных при создании шаблона.
Текстовый заголовок
Текстовые заголовки — это необязательные элементы, которые можно добавить в начало сообщений шаблона. Каждый шаблон может содержать только один текстовый заголовок. Обратите внимание, что специальные символы Markdown в этом компоненте не поддерживаются, поэтому мы рекомендуем избегать их использования.
Текстовые заголовки поддерживают 1 параметр .
Синтаксис создания
Параметры создания
| Заполнитель | Описание | Пример значения |
|---|---|---|
<HEADER_TEXT>Нить |
Необходимый.
Строка текста заголовка и тела документа. Поддерживает 1 параметр .
Если эта строка содержит параметр, необходимо указать
пример свойства и пример значения параметра.Максимум 60 символов. |
Наша новая распродажа начинается {{sale_start_date}}! |
<NAMED_PARAMETER_NAME>Нить |
Обязательно, если используется именованный параметр.
|
{{дата_начала_продажи}} |
<PARAMETER_EXAMPLE_VALUE>Нить |
Обязательно, если используется параметр.
Пример значения параметра |
1 декабря |
медиа-заголовок
В качестве заголовка медиафайла может использоваться изображение, видео, GIF-файл или документ, например, PDF. Все медиафайлы должны загружаться с использованием API возобновляемой загрузки . Синтаксис определения заголовка медиафайла одинаков для всех типов медиафайлов.
Примечание: GIF-файлы в настоящее время доступны только для API маркетинговых сообщений WhatsApp . GIF-файлы представляют собой файлы mp4 максимальным размером 3,5 МБ; файлы большего размера будут отображаться как видеосообщения.
Синтаксис создания
Параметры создания
| Заполнитель | Описание | Пример значения |
|---|---|---|
<FORMAT> |
Указывает тип медиафайла. Установите значение IMAGE , VIDEO , GIF или DOCUMENT . |
ИЗОБРАЖЕНИЕ |
<HEADER_HANDLE> |
Идентификатор загруженного медиафайла. Используйте API возобновляемой загрузки для генерации идентификатора файла. |
4::aW... |
Заголовок местоположения
Заголовки с указанием местоположения отображаются в виде стандартных карт в верхней части шаблона и полезны для отслеживания заказов, обновлений доставки, определения места посадки/высадки пассажиров такси, поиска физических магазинов и т. д. При нажатии открывается стандартное приложение карт пользователя и загружается указанное местоположение. Местоположение указывается при отправке шаблона.
Заголовки с указанием местоположения можно использовать только в шаблонах, отнесенных к категориям
«Утилиты» или «Маркетинг» . Указание местоположения в режиме реального времени не поддерживается.Синтаксис создания
Параметры создания
Никто.
Отправить синтаксис
Отправить параметры
| Заполнитель | Описание | Пример значения |
|---|---|---|
<LOCATION_ADDRESS> |
Адрес местоположения. |
101 Forest Ave, Пало-Альто, Калифорния 94301 |
<LOCATION_LATITUDE> |
Координаты местоположения (широта) в десятичных градусах. |
37.44211676562361 |
<LOCATION_LONGITUDE> |
Координаты местоположения (долгота) в десятичных градусах. |
122.16155960083124 |
<LOCATION_NAME> |
Название местоположения. |
Philz Coffee |
Тело
Компонент body представляет собой основной текст вашего шаблона сообщения и является текстовым компонентом шаблона. Шаблоны могут содержать только один компонент body.
Текст сообщения в компоненте body принимает несколько параметров .
Синтаксис создания
Параметры создания
| Заполнитель | Описание | Пример значения |
|---|---|---|
<BODY_TEXT>Нить |
Необходимый.
Текст тела сообщения. Поддерживает несколько параметров .
Максимальное количество символов — 1024. |
Спасибо, {{first_name}}! Номер вашего заказа: {{order_number}}. |
<NAMED_PARAMETER_NAME>Нить |
Обязательно, если используется именованный параметр.
|
{{номер заказа}} |
<PARAMETER_EXAMPLE_VALUE>Нить |
Обязательно, если используется параметр.
Пример значения параметра |
1 декабря |
Нижние колонтитулы — это необязательные текстовые компоненты, которые располагаются сразу после основного содержимого. Шаблоны могут содержать только один компонент нижнего колонтитула.
Характеристики
| Заполнитель | Описание | Пример значения |
|---|---|---|
<TEXT> |
Текст, который будет отображаться в нижнем колонтитуле шаблона при отправке.
Максимум 60 символов. |
Используйте кнопки ниже для управления вашими маркетинговыми подписками |
Кнопки — это необязательные интерактивные компоненты, которые при нажатии выполняют определенные действия.
Шаблоны могут содержать до 10 кнопок в общей сложности, хотя существуют ограничения на количество отдельных кнопок одного типа, а также ограничения на их комбинации, которые описаны ниже. Кроме того, шаблоны, состоящие из 4 или более кнопок, или кнопки быстрого ответа и одной или нескольких кнопок другого типа, нельзя просмотреть в настольных версиях WhatsApp. Пользователям WhatsApp, получившим сообщение с таким шаблоном, будет предложено просмотреть сообщение на телефоне.
Кнопки определяются в рамках одного объекта компонента buttons, упакованного в один
buttons . Например, в этом шаблоне используются кнопка голосового вызова и кнопка URL:Если шаблон содержит более трех кнопок, в отправленном сообщении отобразятся две кнопки, а оставшиеся будут заменены кнопкой « Посмотреть все варианты» . Нажатие на Посмотреть все варианты» отобразит оставшиеся кнопки.
Кнопки копирования кода копируют текстовую строку (определенную при отправке шаблона в сообщении-шаблоне) в буфер обмена устройства при нажатии пользователем приложения. Шаблоны могут содержать только одну кнопку копирования кода.
Характеристики
| Заполнитель | Описание | Пример значения |
|---|---|---|
<EXAMPLE> |
Строка, которая будет скопирована в буфер обмена устройства при нажатии пользователем приложения.
Максимум 15 символов. |
250FF |
Кнопки для сообщений, содержащих несколько товаров
Кнопки для отображения нескольких товаров — это специальные, не настраиваемые кнопки, при нажатии на которые в одном сообщении отображается до 30 товаров из вашего каталога электронной коммерции, сгруппированных в 10 разделов. См. Шаблоны сообщений для отображения нескольких товаров .
Кнопки одноразовых паролей
Кнопки для ввода одноразового пароля — это особый тип URL- компонента, используемый с шаблонами аутентификации. См. Шаблоны аутентификации .
Кнопки голосового вызова позволяют пользователю приложения совершить звонок в WhatsApp компании. Подробнее см. «Создание и отправка шаблона сообщения с кнопкой вызова WhatsApp».
Кнопки с номером телефона при нажатии пользователем приложения осуществляют звонок на указанный номер телефона компании. Шаблоны ограничены одной кнопкой с номером телефона.
Характеристики
| Заполнитель | Описание | Пример значения |
|---|---|---|
<PHONE_NUMBER> |
Буквенно-цифровая строка. Номер телефона компании, по которому будет совершен звонок при нажатии пользователем кнопки.
Обратите внимание, что в некоторых странах используются специальные телефонные номера, в начале которых после кода страны стоят нули (например, +55-0-955-585-95436). Если вы назначите кнопке один из таких номеров, ведущий ноль будет удален. Если ваш номер не будет работать без ведущего нуля, назначьте кнопке другой номер или добавьте номер в текст сообщения.
Максимум 20 символов. |
15550051310 |
<TEXT> |
Текст надписи на кнопке.
Максимум 25 символов. |
Вызов |
Кнопки быстрого ответа — это настраиваемые текстовые кнопки, которые при нажатии пользователем приложения немедленно отправляют вам указанную текстовую строку. Типичный пример использования — кнопка, позволяющая клиенту легко отказаться от получения любых маркетинговых сообщений.
В шаблонах допускается не более 10 кнопок быстрого ответа. При использовании кнопок быстрого ответа совместно с другими кнопками, кнопки должны быть разделены на две группы: кнопки быстрого ответа и кнопки, не являющиеся кнопками быстрого ответа. В случае неправильной группировки API вернет ошибку, указывающую на недопустимую комбинацию.
Примеры допустимых группировок:
Быстрый ответ, быстрый ответБыстрый ответ, Быстрый ответ, URL, ТелефонURL, Телефон, Быстрый ответ, Быстрый ответ
Примеры недопустимых группировок:
Быстрый ответ, URL, Быстрый ответURL, Быстрый ответ, URL
При использовании API для отправки шаблона, содержащего несколько кнопок быстрого ответа, вы можете использовать свойство index, чтобы указать порядок отображения кнопок в сообщении шаблона.
Характеристики
| Заполнитель | Описание | Пример значения |
|---|---|---|
<TEXT> |
Текст надписи на кнопке.
Максимум 25 символов. |
Отписаться |
Кнопки для отображения информации об одном товаре (SPM) — это специальные, не настраиваемые кнопки, которые можно сопоставить с товаром в вашем каталоге. При нажатии на них загружается подробная информация о товаре, которая берется из вашего каталога. Затем пользователи могут добавить товар в корзину и оформить заказ. См. Шаблоны для отображения информации об одном товаре и Шаблоны карусели карточек товаров .
Кнопки URL-адресов загружают указанный URL-адрес в веб-браузер по умолчанию устройства при нажатии пользователем приложения. Шаблоны ограничены двумя кнопками URL-адресов.
Характеристики
| Заполнитель | Описание | Пример значения |
|---|---|---|
<EXAMPLE> |
URL веб-сайта. Поддерживает 1 переменную.
Если используется переменная, добавьте в конец строки URL-адреса пример свойства переменной. URL-адрес загружается в мобильном веб-браузере по умолчанию на устройстве, когда пользователь нажимает кнопку. Максимум 2000 символов. |
https://www.luckyshrub.com/shop?promo=summer2023 |
<TEXT> |
Текст надписи на кнопке. Максимум 25 символов. |
Купить сейчас |
<URL> |
URL веб-сайта, который загружается в мобильном веб-браузере по умолчанию на устройстве при нажатии кнопки пользователем приложения.
Поддерживается 1 переменная, добавляемая в конец строки URL. Максимум 2000 символов. |
https://www.luckyshrub.com/shop?promo={{1}} |
Предложение ограничено по времени
Компоненты «Ограниченное по времени предложение» — это специальные компоненты, используемые для создания шаблонов ограниченных по времени предложений .
Комментарии отсутствуют
Комментарии отсутствуют