Шаблоны и конструктор писем
Шаблон — это готовое сообщение для одного канала: письмо, сообщение в Telegram, SMS, Web Push, вебхук и другие. Один шаблон используют цепочки, рассылки и ручная отправка из карточки профиля. Переменные подставляют в текст имя клиента, сумму заказа и другие данные.
Раздел находится в меню Коммуникации → Шаблоны. Смотреть шаблоны могут все роли, создавать и менять — «Менеджер» и выше.
Создание шаблона
- Откройте Шаблоны. Вверху справа есть кнопка для каждого канала, включённого в проекте, например Email или Telegram. Нажмите нужную.
- Заполните общие поля (таблица ниже).
- Заполните блок Содержимое. Набор полей зависит от канала. У письма это Тема, Прехедер (текст рядом с темой в списке писем), Конструктор письма или HTML, а также Текстовая версия. Если текстовую версию не заполнить, она соберётся из HTML.
- Нажмите Сохранить. После каждого сохранения номер версии растёт («Версия 3»).
| Поле | Что значит |
|---|---|
| Название | Видно только в интерфейсе: в списках шаблонов, цепочек и рассылок |
| Канал | Выбирается при создании, потом его не изменить |
| Тема подписки | Например, marketing или news. Клиент может отписаться только от этой темы |
| Транзакционное сообщение | Уходит без проверки подписки, частоты и тихих часов. Используйте только для подтверждения заказа, сброса пароля и похожих сообщений |
Чтобы удалить шаблон, нажмите на значок корзины в его строке в списке.
Переменные
Шаблоны пишутся на языке Twig. Переменная ставится в двойные фигурные скобки. Полный список с примерами откроется, если развернуть блок Переменные под содержимым.
| Переменная | Что подставится |
|---|---|
profile.email, profile.phone, profile.user_id |
Идентификаторы клиента |
traits.first_name и другие traits.* |
Трейты профиля |
event.name, event.properties.amount |
Событие, которое запустило сообщение |
context.data.*, context.nodes.* |
Данные цепочки: переданные при входе через API и ответ узла «Вебхук» |
project.name, unsubscribe_url |
Название проекта и ссылка отписки |
Здравствуйте, {{ traits.first_name|default('друг') }}!
{% if event.properties.amount > 5000 %}Доставка — бесплатно.{% endif %}
Шаблоны выполняются в безопасной песочнице. В ней есть условия if, циклы for, set, функции date, min, max и фильтры default, date, upper, lower, capitalize, number_format, round, join, replace, striptags и другие. Если переменной нет, подставится пустая строка, поэтому для важных мест задавайте default. Если использовать запрещённую конструкцию, при сохранении появится ошибка «В шаблоне запрещённая конструкция». Готовое сообщение не может быть больше 512 КБ.
Предпросмотр и тестовая отправка
- В панели Предпросмотр введите ID профиля, email или user_id и нажмите на значок глаза. Если поле оставить пустым, данные возьмутся из профиля с последней активностью.
- Для письма переключайте режимы Компьютер, Телефон и Тёмная тема.
- В панели Тестовая отправка выберите интеграцию. Укажите свой адрес или chat id, иначе сообщение уйдёт на адрес профиля. Нажмите Отправить тест: под кнопкой появится статус сообщения.
Тестовая отправка доступна ролям «Менеджер» и выше. Подписка, частота и тихие часы при ней не проверяются. В предпросмотре нет события-триггера, поэтому переменные event.* останутся пустыми. Если у вас нет права видеть персональные данные, email и телефон будут замаскированы.
Конструктор писем
В шаблоне email нажмите Открыть конструктор в поле «Конструктор письма». Если в шаблоне уже есть HTML, конструктор начнёт письмо заново, и старый код заменится при сохранении. Код для почтовых клиентов, включая Outlook и телефоны, OneTrace.pro собирает сам при сохранении.
Справа от холста три вкладки:
- Блоки — добавить блок. Он встанет после выбранного блока или в конец письма, перед подвалом.
- Блок — настройки блока, выбранного на холсте. Блоки можно поднимать, опускать, перетаскивать, дублировать и удалять.
- Письмо — фон, фон письма, цвета текста и ссылок, шрифт, ширина письма (480–800 px), поля и способ показа изображений.
| Блок | Назначение |
|---|---|
| Заголовок, Текст | Текст с форматированием и переменными, например {{ traits.first_name }} |
| Изображение | Картинка из медиатеки: альтернативный текст, ссылка, ширина 10–100 % |
| Кнопка | Текст, ссылка, цвета и скругление |
| Разделитель, Отступ | Линия и пустое место |
| Колонки | 2–3 колонки с заголовками, текстом, изображениями, кнопками и отступами. На телефоне колонки встают друг под другом |
| Товары | Подборка из рекомендаций: персональные, популярные, «С этим смотрят», «Похожие» и т. д. Можно показать от 1 до 12 товаров в 1–4 колонки, с ценой и кнопкой. Если подходящих товаров нет, блок не попадёт в письмо |
| HTML | Свой код как есть |
| Подвал | Текст и ссылка отписки |
Кнопка Перейти к HTML на вкладке «Письмо» превращает письмо в обычный код. Вернуться в конструктор после этого нельзя.
Ссылка или вложение
| Ссылка (CDN) | Вложение в письмо | |
|---|---|---|
| Вес письма | Лёгкое | Больше на размер картинок |
| Показ | Картинка загружается при открытии. Если почта блокирует изображения, видна только подпись | Картинка видна сразу |
Способ по умолчанию задаётся в поле Изображения по умолчанию на вкладке «Письмо». У отдельной картинки его можно сменить в поле Как показывать. Все вложения одного письма вместе — не больше 1 МБ. Если публичные ссылки на установке не настроены, доступны только вложения.
Медиатека
Медиатека открывается, когда вы добавляете блок «Изображение» или нажимаете Выбрать изображение.
- Загрузить принимает JPEG, PNG, GIF, WebP и AVIF до 10 МБ. Широкие картинки уменьшаются до 1200 px. WebP и AVIF перекодируются, потому что их показывают не все почтовые клиенты. GIF остаётся как есть, вместе с анимацией.
- Если загрузить тот же файл повторно, копии не будет.
- Изображение, которое используется в шаблоне, удалить нельзя, пока вы не уберёте его из шаблона.
- Место, занятое изображениями, входит в лимит тарифа.
