Письма о новом заказе, смене статуса и регистрации формируются из почтовых шаблонов, привязанных к типам почтовых событий. Чтобы поменять текст, тему или верстку такого письма, редактировать нужно именно шаблон, а не код компонента.
main).Где лежат шаблоны писем
В 1С-Битрикс письмо — это связка двух сущностей: тип почтового события (описывает набор доступных полей-переменных) и шаблон почтового сообщения (тема, тело письма, отправитель, получатель). Одному типу события может соответствовать несколько шаблонов — например, отдельные письма для разных сайтов или языков.
Открыть список шаблонов можно так:
- Перейдите в Настройки → Настройки продукта → Почтовые события → Шаблоны почтовых сообщений.
- В фильтре по колонке
Тип почтового событиявыберите нужное событие: например,SALE_NEW_ORDER(новый заказ),SALE_STATUS_CHANGED_*(смена статуса) илиNEW_USER/USER_INFO(регистрация). - Кликните по нужному шаблону, чтобы открыть его на редактирование.
Если вы не уверены, какое именно письмо приходит клиенту, ориентируйтесь по типу события — его название отображается в отдельной колонке списка.
Основные типы событий: заказ и регистрация
Чаще всего правят следующие типы почтовых событий:
| Тип события | Когда отправляется |
|---|---|
SALE_NEW_ORDER | Оформлен новый заказ (письмо покупателю и/или менеджеру) |
SALE_STATUS_CHANGED_N | Заказ переведён в статус N (например, «Оплачен», «Доставлен») |
SALE_ORDER_PAID | Заказ отмечен как оплаченный |
NEW_USER | Регистрация нового пользователя (уведомление администратору) |
USER_INFO | Письмо пользователю с данными его учётной записи |
NEW_USER_CONFIRM | Письмо со ссылкой подтверждения регистрации |
Точный список зависит от версии и подключённых модулей. Для интернет-магазина письма о заказах формирует модуль Интернет-магазин (sale), для регистрации — модуль Пользователи (main).
Как отредактировать шаблон
В карточке шаблона доступны поля, которые формируют письмо. Ключевые из них:
- Отправитель — адрес в поле
From. Можно вписать конкретный e-mail или переменную#DEFAULT_EMAIL_FROM#. - Получатель —
To. Для письма клиенту здесь ставят#EMAIL#или#ORDER_USER#, для уведомления магазину — служебный адрес. - Тема письма —
Subject, поддерживает подстановку полей. - Тип сообщения —
textилиhtml. От него зависит, как обрабатывается тело. - Текст сообщения — тело письма с текстом и переменными события.
Порядок правки:
- Откройте шаблон и внесите изменения в тему и тело письма.
- В нужных местах вставьте поля события в виде
#ИМЯ_ПОЛЯ#— список доступных полей показан в описании типа события. - Если письмо в формате HTML, установите Тип сообщения = html, иначе теги отобразятся как текст.
- Проверьте поля Активность и Сайт: шаблон должен быть активен и привязан к нужному сайту.
- Нажмите Сохранить.
Правьте именно шаблон в админке — не ищите текст письма в коде компонента оформления заказа. Компонент лишь инициирует отправку события, а содержимое берётся из шаблона.
Поля-переменные и где взять их список
Каждое поле подставляется синтаксисом #ИМЯ_ПОЛЯ#. Полный перечень для конкретного письма смотрите в карточке типа почтового события: раздел Настройки → Почтовые события → Типы почтовых событий, поле Доступные поля.
Типичные поля для писем о заказе:
#ORDER_ID#— номер заказа;#ORDER_DATE#— дата оформления;#ORDER_LIST#— состав заказа (готовый текстовый/HTML-блок);#PRICE#— сумма заказа;#EMAIL#,#ORDER_USER#— контакты покупателя.
Для писем о регистрации доступны #LOGIN#, #PASSWORD#, #EMAIL#, #NAME#, #USER_ID#, #CONFIRM_CODE# и другие. Использовать в шаблоне можно только те поля, что объявлены у типа события: неизвестная переменная в письмо просто не подставится и останется как текст #XXX#.
Проверка результата
После правки шаблон стоит протестировать, не дожидаясь реального заказа:
- Оформите тестовый заказ или регистрацию на сайте под тестовой учётной записью.
- Проверьте, что письмо ушло: Настройки → Почтовые события → Очередь исходящих сообщений. Здесь видны письма, ожидающие отправки агентом рассылки.
- Если очередь не разбирается, убедитесь, что запущен агент отправки почты и настроена отправка (локальный
mail()или внешний SMTP). - Ошибки формирования и отправки писем фиксируются в журнале событий сайта — там удобно ловить проблемы с адресами и агентами.
Для регулярной массовой отправки убедитесь, что агент почтовой рассылки выполняется на хите или на cron — иначе письма будут копиться в очереди.
Частые ошибки
Что чаще всего ломает письма после правки шаблона:
- HTML отображается как текст. Забыли переключить Тип сообщения на
html— тело письма ушло как plain text вместе с тегами. - Переменная не подставилась. Опечатка в имени поля или поле не объявлено у типа события. Сверьтесь со списком доступных полей.
- Правили не тот шаблон. У одного типа события несколько шаблонов (по сайтам/языкам). Изменения внесли в неактивный или в шаблон другого сайта.
- Письма не уходят. Шаблон снят с активности, не запущен агент рассылки или не настроена отправка почты (SMTP /
mail()). - Правки в шаблоне «слетают». Обычно так бывает, когда содержимое переопределяется в коде через
CEvent::Send()с явным массивом полей — тогда проверяйте вызов события, а не только шаблон. - Кодировка/кракозябры. Тело шаблона должно быть в кодировке сайта; не копируйте текст со скрытым форматированием из офисных редакторов.
Итог
Чтобы изменить письмо о заказе или регистрации в 1С-Битрикс, не трогайте компоненты — редактируйте почтовый шаблон в разделе Настройки → Почтовые события → Шаблоны почтовых сообщений. Найдите шаблон по нужному типу события, поправьте тему и тело, вставьте поля вида #ИМЯ_ПОЛЯ# из списка доступных полей, выставьте корректный тип сообщения и привязку к сайту.
После сохранения обязательно проверьте результат тестовым заказом и загляните в очередь исходящих сообщений и журнал событий. Такой подход даёт предсказуемый результат и не ломается при обновлениях платформы.