Шаблоны и конструктор писем
Шаблон — это готовое сообщение для одного канала: письмо, сообщение в Telegram, SMS, Web Push, мобильный push, сообщение в приложении, вебхук и другие. Один шаблон используют цепочки, рассылки и ручная отправка из карточки профиля. Переменные подставляют в текст имя клиента, сумму заказа и другие данные.
Раздел находится в меню Коммуникации → Шаблоны. Смотреть шаблоны могут все роли, создавать и менять — «Менеджер» и выше.
Создание шаблона
- Откройте Шаблоны, нажмите Новый шаблон вверху справа и выберите канал в списке: в нём все каналы, включённые в проекте, например Email или Telegram.
- Заполните общие поля (таблица ниже).
- Заполните блок Содержимое. Набор полей зависит от канала. У письма это Тема, Прехедер (текст рядом с темой в списке писем), Конструктор письма или HTML, а также Текстовая версия. Если текстовую версию не заполнить, она соберётся из HTML.
- Нажмите Сохранить. После каждого сохранения номер версии растёт («Версия 3»).
| Поле | Что значит |
|---|---|
| Название | Видно только в интерфейсе: в списках шаблонов, цепочек и рассылок |
| Канал | Выбирается при создании, потом его не изменить |
| Тема подписки | Тема из справочника, например marketing или news, или новый ключ — он появится в справочнике. Клиент может отписаться только от этой темы |
| Транзакционное сообщение | Уходит без проверки подписки, частоты и тихих часов, но не на закрытый у получателя канал: ящика или номера нет, бот заблокирован. Используйте только для подтверждения заказа, сброса пароля и похожих сообщений, см. Транзакционные сообщения и каскады |
Список шаблонов
В таблице видны канал, языковые версии шаблона (основной язык выделен цветом), оценка доставляемости, тема подписки и время изменения с номером версии.
Доставляемость — итог проверки доставляемости email-шаблона по всем языковым версиям: худшая оценка версий («Хорошо», «Есть замечания», «Плохо») и наибольший балл спам-фильтра (спам — от 6). Подробности по каждому языку и время проверки видны во всплывающей подсказке значка. Шаблон проверяется в фоне после каждого изменения письма, пока идёт проверка — значок «Проверяется». Изменение только названия или темы подписки повторную проверку не запускает. Если оценка «Есть замечания» или «Плохо», откройте шаблон и запустите проверку в нём, чтобы увидеть замечания.
Над таблицей — поиск по названию и фильтры по каналу, языку и оценке доставляемости, например все шаблоны с оценкой «Плохо» или все шаблоны с немецкой версией. Нажатие на заголовок колонки сортирует таблицу, повторное — меняет направление. Фильтры и сортировка запоминаются: после удаления шаблона и возврата из редактора список останется таким же.

Чтобы удалить шаблон, нажмите на значок корзины в его строке в списке.
Переменные
Шаблоны пишутся на языке 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, preferences_url |
Название проекта, ссылка отписки и ссылка на центр подписок |
project.legal_address |
Юридический адрес компании из настроек проекта; удобно вставить в футер письма. Если адрес не задан — пусто |
loyalty.points, loyalty.tier, loyalty.expiring, loyalty.expire_at, loyalty.referral_url |
Счёт в программе лояльности: баланс, уровень, сгорающие баллы и их дата, ссылка приглашения |
wallet_url |
Ссылка на карту лояльности в Wallet: покупатель добавляет карту в Apple Wallet или Google Wallet. Действует 90 дней; пусто, если карты Wallet не подключены |
promo_code('welcome') |
Промокод покупателя из пула welcome: при отправке выдаётся, в предпросмотре — образец |
order.number, order.amount, order.tracking_url |
Заказ письма магазина: номер, сумма, ссылка на отслеживание; сумма с валютой — {{ order.amount|money(order.currency) }} |
product('SKU-1') |
Товар каталога на языке письма: name, url, image, price, old_price, currency, available, stock — на момент отправки (цены и наличие товаров) |
Здравствуйте, {{ 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 КБ. Наследование шаблонов (extends, block) недоступно, а у циклов и вызовов товаров, рекомендаций и промокодов есть предел: шаблон, который делает слишком много действий, не сохранится.
Если в шаблоне есть переменная, которой платформа не знает, — заглушка из чужого макета вроде {{ COMPANY_ADDRESS }} или опечатка вроде {{ first_name }} вместо {{ traits.first_name }}, — над содержимым появится предупреждение со списком таких переменных. На их месте в сообщении будет пусто. Предупреждение обновляется при открытии шаблона, сохранении, предпросмотре и тестовой отправке.
Предпросмотр и тестовая отправка
- В панели Предпросмотр введите ID профиля, email или user_id и нажмите на значок глаза. Если поле оставить пустым, данные возьмутся из профиля с последней активностью.
- Для письма переключайте режимы Компьютер, Телефон, Тёмная тема и Без картинок. В последнем картинки заменены подписями
alt: так письмо увидят получатели, у которых картинки не загружаются. - В панели Тестовая отправка выберите интеграцию. Укажите свой адрес или chat id, иначе сообщение уйдёт на адрес профиля. Нажмите Отправить тест: под кнопкой появится статус сообщения.
Тестовая отправка доступна ролям «Менеджер» и выше. Подписка, частота и тихие часы при ней не проверяются. В предпросмотре нет события-триггера, поэтому переменные event.* останутся пустыми. Если у вас нет права видеть персональные данные, email и телефон будут замаскированы.

Под письмом в предпросмотре — блок Во «Входящих». Он показывает, как отправитель, тема и прехедер выглядят в списке писем Gmail на компьютере, Outlook и Почты на iPhone. Длинная тема и прехедер обрезаются примерно так же, как в этих клиентах. Имя отправителя берётся из интеграции, выбранной в блоке проверки доставляемости.

Проверка доставляемости
Перед отправкой email-шаблон можно проверить: попадёт ли письмо во «Входящие» или в спам. В блоке Проверка доставляемости выберите интеграцию, через которую письмо будет уходить, и нажмите Проверить. Письмо соберётся так же, как при отправке: с отслеживанием открытий и переходов и ссылкой отписки. Проверяется открытая языковая версия, данные подставятся из профиля, указанного в предпросмотре.
Проверка смотрит на три вещи:
- Отправитель. Для почтового сервиса OneTrace.pro домен адреса отправителя должен быть добавлен и подтверждён в разделе Домены отправки, желательно с записью DMARC. Для своего SMTP-сервера проверяются записи SPF и DMARC домена; подпись DKIM настраивается у вашего почтового провайдера, и проверить её отсюда нельзя.
- Содержимое. Тема (пустая, заглавными буквами, с
!!или$$, слишком длинная), прехедер, размер письма (Gmail обрезает HTML больше 102 КБ), письмо из одних картинок, картинки безalt, сокращатели ссылок, ссылки по IP-адресу и ссылки, текст которых — адрес другого сайта, видимая ссылка отписки в маркетинговых письмах, элементы, которые почтовые клиенты вырезают (скрипты, формы, фреймы). - Оценка спам-фильтра. Письмо целиком проверяет спам-фильтр Rspamd. Балл ниже порога «подозрительно» — хорошо, выше порога «спам» — письмо скорее всего попадёт в спам. В списке Что повлияло на оценку — правила фильтра и их вес.
Итог — одна из оценок: Хорошо (явных причин попасть в спам нет), Есть замечания (письмо дойдёт, но замечания лучше исправить) или Плохо (высокий риск спама или ошибка отправителя). Каждое замечание объясняет, что не так и как исправить.
Ниже — Совместимость с почтовыми клиентами: приёмы вёрстки, которые не работают в Outlook для Windows, Gmail, Яндекс Почте или Почте Mail.ru, например скругления углов, тени, медиазапросы, свои шрифты, SVG и видео. Письмо в этих клиентах придёт, но будет выглядеть иначе, поэтому на оценку это не влияет.

Рассылки проверяют письма своих вариантов так же — см. Проверка писем перед запуском.
Языковые версии
Один шаблон может содержать версии на нескольких языках. Каждый получатель получает версию на языке своего профиля (трейт language), а если такой версии нет — основную. Языки, из которых можно выбрать, задаются в настройках проекта.
-
Над блоком Содержимое нажмите Добавить язык и выберите язык. Затем выберите, как создать версию:
- Копия открытой версии — оформление, картинки и ссылки уже на месте, остаётся перевести тексты;
- Перевод с ИИ — черновой перевод основной версии, см. ниже;
- Импорт письма с ИИ — готовое письмо на этом языке, см. Импорт в языковую версию.

-
Переключайтесь между версиями кнопками языков. Основная версия отмечена словом «основной».
-
Чтобы получатели без своей версии получали другой язык, откройте его версию и нажмите Сделать основным. Удалить версию убирает открытую версию.
-
Нажмите Сохранить. Каждая версия проверяется отдельно; версия с ошибками отмечена значком предупреждения.
Черновой перевод
Чтобы не переводить версию вручную с нуля, откройте её и нажмите Черновик перевода. OneTrace.pro переведёт основную версию на язык открытой вкладки: тему, прехедер, тексты блоков конструктора, текстовую версию, тексты SMS, push и мессенджеров. Переменные вроде {{ traits.first_name }}, ссылки, картинки и оформление не меняются.
Черновик только подставляется в форму. Прочитайте его, поправьте формулировки и нажмите Сохранить. Если какое-то поле не удалось перевести без потери переменных, оно останется на исходном языке, и OneTrace.pro покажет, сколько таких полей. Если версия уже отличается от основной, перед заменой появится вопрос.
Число черновиков в месяц ограничено тарифом — см. Тарифы. Кнопки нет, если перевод не подключён в вашей установке.
Версия выбирается так: сначала точное совпадение языка, затем язык без региона (покупатель с pt-BR получит версию pt), затем другой вариант того же языка. Предпросмотр и тестовая отправка показывают открытую версию, а переменная {{ language }} содержит язык отправляемой версии.
Конструктор писем
В шаблоне email нажмите Открыть конструктор в поле «Конструктор письма». Если в шаблоне уже есть HTML, конструктор начнёт письмо заново, и старый код заменится при сохранении. Код для почтовых клиентов, включая Outlook и телефоны, OneTrace.pro собирает сам при сохранении.
Справа от холста три вкладки:
- Блоки — добавить блок. Он встанет после выбранного блока или в конец письма, перед подвалом.
- Блок — настройки блока, выбранного на холсте. Блоки можно поднимать, опускать, перетаскивать, дублировать и удалять.
- Письмо — фон, фон письма, цвета текста и ссылок, шрифт, ширина письма (480–800 px), поля и способ показа изображений.
| Блок | Назначение |
|---|---|
| Заголовок, Текст | Текст с форматированием и переменными, например {{ traits.first_name }} |
| Изображение | Картинка из медиатеки: альтернативный текст, ссылка, ширина 10–100 % |
| Кнопка | Текст, ссылка, цвета и скругление |
| Разделитель, Отступ | Линия и пустое место |
| Колонки | 2–3 колонки с заголовками, текстом, изображениями, кнопками и отступами. На телефоне колонки встают друг под другом |
| Товары | Подборка из рекомендаций: персональные, популярные, «С этим смотрят», «Похожие» и т. д. Персональные, популярные и трендовые можно ограничить категорией каталога. Источник Выбранные товары показывает до 12 товаров каталога в заданном порядке: найдите их по названию, в письмо попадут только те, что в наличии. Можно показать от 1 до 12 товаров в 1–4 колонки, с ценой и кнопкой. У товаров с отзывами под названием — рейтинг. Если подходящих товаров нет, блок не попадёт в письмо |
| Заказ | Заказ из письма магазина: товары, суммы, отслеживание посылки и адреса. В письмах без заказа блока нет |
| Опрос | Главный вопрос опроса: кнопки NPS 0–10 или пять звёзд. Клиент ставит оценку прямо в письме, страница опроса сохраняет её и предлагает остальные вопросы |
| HTML | Свой код как есть |
| Подвал | Текст, ссылка отписки и ссылка «Настроить подписки» |

Кнопка Перейти к HTML на вкладке «Письмо» превращает письмо в обычный код. Вернуться в конструктор после этого нельзя.
Ссылка или вложение
| Ссылка (CDN) | Вложение в письмо | |
|---|---|---|
| Вес письма | Лёгкое | Больше на размер картинок |
| Показ | Картинка загружается при открытии. Если почта блокирует изображения, видна только подпись | Картинка видна сразу |
Способ по умолчанию задаётся в поле Изображения по умолчанию на вкладке «Письмо». У отдельной картинки его можно сменить в поле Как показывать. Все вложения одного письма вместе — не больше 1 МБ. Если публичные ссылки на установке не настроены, доступны только вложения.
ИИ в редакторе писем
ИИ помогает с текстами email-шаблона: предлагает темы, правит текст блоков и собирает письмо целиком по описанию. Результат ИИ — черновик: он попадает в форму или конструктор, а сохраняете шаблон вы. ИИ знает название проекта, отрасль магазина, валюту, язык открытой версии и тон и правила бренда. Данные покупателей ему не передаются.
ИИ доступен на платном тарифе и оплачивается с баланса проекта по расходу. Если ИИ сейчас недоступен — пробный период, пустой баланс или исчерпан лимит трат, — кнопки видны, а рядом написана причина.
Варианты темы
Кнопка Варианты темы стоит над полями «Тема» и «Прехедер». Выберите Упор — разные подходы, любопытство и ясность, срочность, личное обращение или выгода для читателя — и при желании напишите Пожелания, например «без эмодзи». Нажмите Предложить: ИИ предложит пять пар «тема + прехедер» по тексту открытой версии письма.
В списке тема показана так, как её увидит получатель с именем-образцом. Пометка С именем получателя значит, что в теме есть переменная имени. Кнопка Подставить кладёт пару в форму.

Правка текста блока
Выберите на холсте конструктора заголовок, текст или кнопку. В панели блока, в разделе ИИ: правка текста, есть кнопки Сократить, Дружелюбнее, Официальнее, Исправить ошибки и Переписать… — со своим указанием. Предложение ИИ появится под кнопками: Заменить подставит его в блок, Отмена оставит текст как был.
Переменные шаблона и ссылки ИИ не меняет. Если в ответе пропала переменная или изменилась ссылка, текст не заменится, и вы увидите объяснение.

Письмо по описанию
Кнопка Письмо с ИИ стоит над конструктором и рядом с кнопкой «Открыть конструктор». Опишите, о чём письмо и чего вы ждёте от читателя, и дайте ссылки — например, «распродажа пальто до воскресенья, скидки до 30 %, ссылка https://…». Включите Товары из каталога, если в письме нужны товары: ИИ посмотрит категории каталога и найдёт товары в наличии. Нажмите Собрать письмо — обычно это занимает до минуты.
Чтобы новое письмо выглядело как остальные ваши письма, выберите Пример письма — email-шаблон проекта, собранный в конструкторе. ИИ повторит его оформление и структуру: цвета и шрифт, логотип и другие картинки, кнопки, блоки HTML вроде рамки с промокодом и подвал вместе с переменными. Тексты он напишет по описанию: акции, промокоды и ссылки из примера в новое письмо не переносятся, если вы не укажете их в описании.
Письмо соберётся из блоков конструктора: заголовок, текст, кнопка, товары и подвал со ссылкой отписки. Если в конструкторе уже есть письмо, OneTrace.pro спросит, заменить ли его. Тема и прехедер подставятся, только если эти поля пустые. Если что-то стоит поправить, над конструктором появятся предупреждения — например, указать ссылки кнопок, которых не было в описании.

Варианты письма для A/B-теста ИИ делает прямо в рассылке.
Импорт готового письма
Если письмо уже свёрстано в другом сервисе, его не нужно собирать заново. На странице Шаблоны нажмите Импорт письма (ИИ):
- Выберите Файл и загрузите письмо, сохранённое из почтовой программы (
.eml), или страницу.html. Либо выберите HTML-код и вставьте код письма. - Нажмите Импортировать. ИИ разбирает письмо обычно до минуты.
- Откроется редактор с новым шаблоном email: письмо разложено на блоки конструктора, картинки скопированы в медиатеку, имя получателя заменено переменной
{{ traits.first_name }}, а ссылка отписки — блоком «Подвал». Тексты и ссылки остаются как в письме. - Проверьте шаблон и нажмите Сохранить. До сохранения шаблона нет.


Если часть письма не удалось перенести, над формой появится список: какие картинки не скопировались или какие блоки пропущены. Если письмо не раскладывается на блоки, оно переносится одним блоком «HTML». Пиксели отслеживания и ссылка «Открыть в браузере» не переносятся.
OneTrace.pro определяет язык письма: по атрибуту lang и заголовку Content-Language, а если они расходятся с текстом — по самому тексту письма. Язык письма становится основным языком нового шаблона.
Импорт в языковую версию
Если письмо на другом языке уже есть, его не нужно переводить: в открытом шаблоне email нажмите Добавить язык, выберите язык и Импорт письма с ИИ. Письмо загружается так же, как при создании шаблона, и попадает в версию выбранного языка — со своими блоками, картинками и темой. Проверьте версию и нажмите Сохранить.
Если язык письма не совпал с выбранным, над версией появится подсказка, например «Похоже, письмо на языке «французский»», и кнопка Сделать версией «французский». Если такая версия уже есть, OneTrace.pro спросит, заменить ли её.
Импорт доступен на тарифах «Рост» и «Корпоративный»; число импортов в месяц — и новых шаблонов, и версий — ограничено тарифом, см. Тарифы. На тарифе «Старт» кнопка показывает, с какого тарифа функция доступна.
Медиатека
Медиатека открывается, когда вы добавляете блок «Изображение» или нажимаете Выбрать изображение.
- Загрузить принимает JPEG, PNG, GIF, WebP и AVIF до 10 МБ. Широкие картинки уменьшаются до 1200 px. WebP и AVIF перекодируются, потому что их показывают не все почтовые клиенты. GIF остаётся как есть, вместе с анимацией.
- Если загрузить тот же файл повторно, копии не будет.
- Изображение, которое используется в шаблоне, удалить нельзя, пока вы не уберёте его из шаблона.
- Место, занятое изображениями, входит в лимит тарифа.
