Почтовые шаблоны в Битрикс: создание, настройка и использование
Почтовые шаблоны в 1С-Битрикс — это удобный инструмент для автоматической отправки email-сообщений пользователям и администраторам сайта. С их помощью можно настроить уведомления о регистрации, заказах, обратной связи, восстановлении пароля и любых других событиях.
Грамотно настроенные шаблоны позволяют централизованно управлять содержимым писем без изменения программного кода. Это особенно важно для интернет-магазинов, корпоративных сайтов и CRM-систем на базе Битрикс.
Что такое почтовый шаблон в Битрикс
Почтовый шаблон — это заготовка письма, содержащая текст, HTML-разметку и специальные переменные. При отправке письма Битрикс автоматически подставляет значения переменных и формирует готовое сообщение.
Например:
#NAME#
#EMAIL#
#MESSAGE#
После подстановки данных письмо может выглядеть так:
Иван Иванов
ivan@example.com
Здравствуйте! Интересует стоимость разработки.
Где находятся почтовые шаблоны
В административной панели перейдите:
Настройки → Настройки продукта → Почтовые и SMS события → Почтовые шаблоны
Здесь можно создавать, редактировать и удалять шаблоны.
Создание почтового шаблона
Для создания нового шаблона необходимо:
- Нажать «Добавить шаблон».
- Выбрать тип почтового события.
- Указать сайт (SITE_ID).
- Заполнить тему письма.
- Добавить текст или HTML-содержимое.
- Сохранить шаблон.
Пример темы письма:
Новая заявка с сайта
Пример содержимого:
Имя: #NAME#
Телефон: #PHONE#
Email: #EMAIL#
Сообщение:
#MESSAGE#
Использование HTML-шаблонов
Битрикс поддерживает отправку HTML-писем. Для этого при создании шаблона выберите тип содержимого «HTML».
Пример HTML-шаблона:
<h2>Новая заявка</h2>
<p><strong>Имя:</strong> #NAME#</p>
<p><strong>Телефон:</strong> #PHONE#</p>
<p><strong>Email:</strong> #EMAIL#</p>
HTML-шаблоны позволяют создавать красивые адаптивные письма с логотипом компании, кнопками и фирменным стилем.
Переменные в почтовых шаблонах
В шаблонах используются специальные макросы, которые заменяются реальными данными при отправке письма.
Наиболее распространенные переменные:
| Переменная | Описание |
|---|---|
| #NAME# | Имя пользователя |
| #EMAIL# | Email пользователя |
| #ORDER_ID# | Номер заказа |
| #PRICE# | Сумма заказа |
| #MESSAGE# | Текст сообщения |
Набор доступных переменных зависит от типа почтового события.
Отправка письма через CEvent::Send
Классический способ отправки письма:
<?php
$arFields = [
'NAME' => 'Иван Иванов',
'EMAIL' => 'ivan@example.com',
'MESSAGE' => 'Тестовое сообщение'
];
CEvent::Send(
'NEW_ORDER',
SITE_ID,
$arFields
);
?>
Где:
- NEW_ORDER — код почтового события.
- SITE_ID — идентификатор сайта.
- $arFields — массив данных для подстановки в шаблон.
Отправка письма через D7
В современных проектах рекомендуется использовать API D7:
<?php
use Bitrix\Main\Mail\Event;
Event::send([
'EVENT_NAME' => 'NEW_ORDER',
'LID' => SITE_ID,
'C_FIELDS' => [
'NAME' => 'Иван Иванов',
'EMAIL' => 'ivan@example.com'
]
]);
?>
Этот метод полностью совместим с современными версиями 1С-Битрикс.
Мультиязычные шаблоны
Если сайт работает на нескольких языках, для каждого языка можно создать отдельный почтовый шаблон. Битрикс автоматически выберет нужный вариант в зависимости от сайта и языка пользователя.
Например:
- Русский шаблон для сайта s1.
- Английский шаблон для сайта s2.
Вложения в письмах
К письму можно прикреплять файлы.
Пример:
<?php
$fileId = CFile::SaveFile($_FILES['FILE'], 'upload');
CEvent::Send(
'NEW_ORDER',
SITE_ID,
$arFields,
'N',
'',
[$fileId]
);
?>
Файл будет отправлен как вложение к письму.
Отладка почтовых шаблонов
Если письмо не приходит, проверьте:
- Активен ли шаблон.
- Совпадает ли код события.
- Передаются ли все необходимые переменные.
- Настроен ли SMTP-сервер.
- Есть ли ошибки в журнале почтовых сообщений.
Очередь отправки писем можно посмотреть в разделе:
Настройки → Почтовые события → Список сообщений
Преимущества использования почтовых шаблонов
- Централизованное управление письмами.
- Быстрое изменение содержимого без правки кода.
- Поддержка HTML и мультиязычности.
- Возможность использования переменных.
- Удобная интеграция с формами, интернет-магазином и CRM.
Заключение
Почтовые шаблоны в Битрикс — это мощный инструмент для организации email-уведомлений на сайте. Они позволяют гибко настраивать внешний вид писем, использовать динамические данные и автоматизировать взаимодействие с пользователями. Независимо от того, создаете ли вы интернет-магазин, корпоративный портал или сервисный сайт, грамотная настройка почтовых шаблонов значительно упростит поддержку проекта и улучшит коммуникацию с клиентами.