Шаблоны и персонализация
Шаблон — это готовое сообщение, которое вы персонализируете под каждого получателя. Подставляйте переменные вроде {{ contact.first_name }}, задавайте запасное значение, когда поле пустое, показывайте и повторяйте блоки условиями и циклами — и в теме, и в прехедере, и в отправителе, и в теле письма.
Что понадобится
- Рабочее пространство хотя бы с одним контактом
- Поля контакта или свойства событий для персонализации
Что хранит шаблон
Шаблон хранит всё сообщение целиком, а не только тело — поэтому персонализация работает везде.
- subject и preheader — тема и строка-превью в почте.
- from_name, from_email и reply_to — от кого приходит письмо.
- html (или mjml) и текстовая версия для простых почтовых клиентов.
- История версий — каждое сохранение это новая версия, которую можно открыть и к которой можно откатиться.
Подставляйте переменные
Обращайтесь к любому полю контакта или свойству события через двойные фигурные скобки и путь через точку. Неизвестные поля выводятся пустыми, если не задать значение по умолчанию.
- | default: "…" — запасное значение, когда поле пустое.
- | upcase / | downcase — изменить регистр.
- | raw — вывести доверенный HTML без экранирования.
Здравствуйте, {{ contact.first_name | default: "коллега" }}!
Ваш тариф: {{ contact.plan | upcase }}
Город: {{ contact.address.city }}Условия и циклы
Показывайте блок только при выполнении условия или повторяйте блок по списку (например, по позициям заказа, переданным в переменных).
{% if contact.plan == "pro" %}
Спасибо, что вы на тарифе Pro.
{% else %}
Перейти на старший тариф можно в любой момент.
{% endif %}
{% for item in order.items %}
- {{ item.name }} × {{ item.qty }}
{% endfor %}Предпросмотр и отправка
- 1
Откройте «Шаблоны» → нужный шаблон
Отредактируйте тему, отправителя и тело. Сохранение автоматически создаёт новую версию.
- 2
Проверьте на реальных данных
Отрисуйте шаблон на тестовом контакте и убедитесь, как именно разрешаются переменные, значения по умолчанию и условия — до отправки.
- 3
Переиспользуйте
Выберите шаблон в рассылке или сценарии либо передайте его template_id с переменными в POST /v1/messages.
Частые вопросы
Что будет, если переменная пустая?
Она выведется пустой. Добавьте | default: "…", чтобы подставить запасное значение и никогда не отправить «Здравствуйте, !».
Можно ли персонализировать тему письма?
Да — переменные, значения по умолчанию и условия работают в теме и прехедере, а не только в теле.
Можно ли откатить неудачную правку?
Да. Каждое сохранение версионируется — откройте историю версий и восстановите любую раннюю.
Начните отправлять за минуты
Заведите бесплатный аккаунт, подключите домен и охватите аудиторию во всех каналах — карта не нужна.
Бесплатный тариф навсегда · Без карты · Запуск за минуты