Почтовые шаблоны в Битрикс отвечают за то, что видит клиент после оформления заказа, регистрации на сайте или смены статуса доставки. На практике часто вижу магазины, где письмо о заказе выглядит как техническая рассылка десятилетней давности: голый текст, обрезанные переменные, ссылка на домен, который уже год как сменился. Ниже разбираю, где эти шаблоны хранятся в админке, как поменять текст без риска сломать подстановки и на что смотреть при тестовой отправке.
Где хранятся почтовые шаблоны в административной панели
В Битриксе есть два связанных, но разных раздела. Первый, «Почтовые события», находится в Настройки - Настройки продукта - Почтовые события: там перечислены типы событий вроде SALE_NEW_ORDER, USER_INFO, SALE_STATUS_CHANGED. Это техническое описание, какие переменные событие передаёт при срабатывании, редактировать текст письма здесь нельзя.
Сам текст письма живёт в разделе «Шаблоны почтовых событий» (Настройки - Настройки продукта - Шаблоны почтовых событий, либо через модуль «Почта» в старых редакциях). Каждый шаблон привязан к конкретному событию и к конкретному сайту через поле «Сайты». Если у вас мультисайтовость (например, отдельный домен под опт и отдельный под розницу), для одного и того же события SALE_NEW_ORDER может быть два разных шаблона с разным текстом и даже разной темой письма.
Важный нюанс: один тип события может иметь несколько активных шаблонов одновременно, если они привязаны к разным сайтам. При правке ищите нужный шаблон именно по колонке «Сайт», иначе легко изменить письмо не для того магазина.
Как отредактировать текст письма клиенту
Порядок действий простой:
- Открываете список шаблонов, фильтруете по нужному событию или по названию.
- Заходите в конкретный шаблон, переключаетесь на вкладку с телом письма.
- Правите текст в визуальном редакторе (обычно это LiteEditor или CKEditor в зависимости от версии ядра) либо переключаетесь в режим HTML-кода для точечных правок вёрстки.
- Сохраняете и проверяете галочку «Активен» - без неё письмо просто не уйдёт, даже если всё остальное настроено верно.
Если меняете только текст (приветствие, формулировки, добавляете абзац про сроки доставки СДЭК), проще работать в визуальном редакторе. Если трогаете структуру таблицы с товарами или добавляете блок с промокодом, надёжнее переключиться в HTML-режим и редактировать код напрямую - визуальные редакторы Битрикса любят подчищать «лишние» атрибуты и ломать вёрстку писем при частом переключении между режимами.
Отдельно проверьте кодировку сайта. На старых проектах на Битриксе ещё встречается windows-1251, и если скопировать текст письма из современного редактора с юникодными символами (например, длинное тире или эмодзи), в письме вылезет кракозябра. Проще всего вставлять текст через «Вставить как обычный текст», а форматирование накладывать уже в редакторе.
Переменные и плейсхолдеры: что можно вставлять в письмо
Каждое событие передаёт свой набор переменных, которые подставляются в шаблон в виде #ПЕРЕМЕННАЯ#. Полный список смотрите на вкладке события в разделе «Почтовые события» - там указано, какие поля доступны именно для этого типа письма. Самые ходовые:
| Переменная | Где используется | Что подставляет |
|---|---|---|
| #ORDER_ID# | SALE_NEW_ORDER, SALE_STATUS_CHANGED | Номер заказа |
| #ORDER_LIST# | SALE_NEW_ORDER | Таблица с составом заказа |
| #EMAIL# | USER_INFO, USER_PASS_REQUEST | E‑mail клиента |
| #ORDER_TRACKING_NUMBER# | SALE_STATUS_CHANGED (при интеграции с СДЭК) | Трек-номер отправления |
| #DATE_INSERT# | SALE_NEW_ORDER | Дата и время оформления заказа |
| #LOGIN#, #PASSWORD# | USER_INFO | Логин и пароль нового пользователя |
Главная ошибка при работе с переменными - заменить их на статический текст «для наглядности» при копировании шаблона, а потом забыть вернуть плейсхолдер обратно. Проверяйте письмо через тестовый заказ каждый раз, когда трогаете блок с переменными, а не полагайтесь на визуальную проверку кода.
Бесплатный материал
🎁 Полезный скрипт в подарок
Подпишитесь на Telegram - пришлю готовый скрипт по этой теме.
Без спама. Отписка в 1 клик.
Настройка шаблонов под разные события: заказ, оплата, регистрация
Под капотом у типового интернет-магазина обычно работает 8-12 активных почтовых шаблонов: подтверждение заказа, смена статуса (оплачен, собран, передан в доставку, отменён), регистрация, восстановление пароля, иногда отдельное письмо под успешную оплату через эквайринг. Если у вас интеграция с Т‑Банком или другим эквайрингом, письмо о смене статуса на «Оплачен» обычно триггерится через SALE_STATUS_CHANGED сразу после того, как платёжный шлюз присылает колбэк об успешной транзакции - в шаблоне этого события стоит явно указывать, что оплата прошла, а не просто дублировать состав заказа.
Для писем с трек-номером (если заказы отгружаются через СДЭК или другую службу) удобно завести отдельный шаблон под статус «Передан в доставку» с переменной трек-номера и прямой ссылкой на страницу отслеживания - это сокращает количество обращений в поддержку с вопросом «где мой заказ».
Если часть аудитории говорит не на русском, для каждого языкового сайта заводите отдельный шаблон с привязкой к соответствующему SITE_ID, а не полагайтесь на автоперевод внутри одного письма - Битрикс не переводит тело шаблона на лету.
Тестирование отправки и проверка на реальных почтовых клиентах
После правки шаблона обязательно оформляйте тестовый заказ или тестовую регистрацию на боевом или staging-окружении - кнопки «отправить тестовое письмо» из коробки в админке нет, единственный надёжный способ проверить итоговый результат - реальное срабатывание события. Смотрите письмо минимум в двух местах: Яндекс.Почта и Gmail рендерят HTML-таблицы по-разному, и то, что аккуратно выглядит в одном клиенте, может расползтись в другом.
Проверьте заодно, что письма не улетают в спам. Если домен новый или вы недавно поменяли шаблон массово, добавив картинки и ссылки, имеет смысл свериться с настройками SPF и DKIM для почтового сервера, через который Битрикс шлёт письма - это отдельная область настройки хостинга, а не самого CMS, но именно от неё чаще всего зависит доставляемость.
Доработка писем сверх стандартных возможностей админки
Стандартного редактора хватает для правки текста и вёрстки, но если нужно подставлять в письмо данные, которых нет в стандартном наборе переменных события (например, персональную скидку, рассчитанную по внешней логике, или ссылку на отзыв в мессенджере), это делается через обработчик события OnBeforeEventAdd - он перехватывает набор полей перед отправкой и позволяет добавить свои значения.
<!-- фрагмент шаблона письма, где используется кастомная переменная -->
<p>Ваш заказ #ORDER_ID# принят в обработку.</p>
<p>Персональная скидка на следующий заказ: #CUSTOM_DISCOUNT#</p>
<p>Отследить доставку СДЭК: <a href="#TRACK_URL#">#ORDER_TRACKING_NUMBER#</a></p>Переменная #CUSTOM_DISCOUNT# и #TRACK_URL# в этом примере не существуют в стандартном событии, их нужно добавить программно в обработчике перед отправкой письма. Такие доработки, а также синхронизацию писем с внешними системами (дублирование уведомлений в Telegram-бота на aiogram, автоматическую пересылку копии заказа в CRM через n8n) обычно делают точечно под конкретный магазин, и если своими силами разбираться с обработчиками событий Битрикса нет времени, такую задачу проще отдать на доработку сайта под конкретную задачу - это быстрее, чем разбираться в чужом коде обработчиков методом проб и ошибок.
Частые ошибки при редактировании почтовых шаблонов
- Забыли отметить шаблон активным после сохранения - письмо перестаёт уходить, а ошибка нигде явно не показывается.
- Правили шаблон не для того сайта в мультисайтовой установке - клиенты на другом домене продолжают получать старый текст.
- Сломали HTML-тег при частом переключении между визуальным и кодовым режимом редактора - таблица с товарами разъезжается в некоторых почтовых клиентах.
- Заменили переменную на статический текст при копировании шаблона под новое событие и забыли вернуть плейсхолдер.
- Не проверили письмо на реальном заказе после правки, а полагались только на просмотр кода в админке.
Чтобы сайт работал без сбоев
Техподдержка
от 15 000 ₽/мес
Подробнее →Частые вопросы
Где в Битриксе находятся шаблоны писем?
В разделе Настройки - Настройки продукта - Шаблоны почтовых событий. Там же можно отфильтровать шаблоны по типу события и по сайту, если у вас несколько доменов на одной установке.
Можно ли редактировать почтовые шаблоны без программиста?
Да, правка текста, добавление абзацев и работа со стандартными переменными делается через визуальный редактор в админке без участия разработчика. Программист нужен, если требуется добавить переменные, которых нет в стандартном наборе события, или синхронизировать письма с внешними системами.
Как добавить новую переменную в шаблон письма?
Стандартный набор переменных для события менять нельзя через админку - его расширяют программно через обработчик OnBeforeEventAdd, который добавляет нужные поля в массив перед отправкой письма. После этого новая переменная становится доступна в теле шаблона как обычный плейсхолдер.
Почему письмо не приходит клиенту после смены шаблона?
Чаще всего причина в неактивном шаблоне (не стоит галочка «Активен»), в правке шаблона для другого сайта в мультисайтовой конфигурации либо в проблемах на уровне почтового сервера хостинга (SPF, DKIM, письмо уходит в спам). Проверяйте эти три момента по очереди перед тем, как искать ошибку в самом коде шаблона.