Как импортировать почтовый шаблон битрикс

В Битрикс шаблоны писем играют ключевую роль при автоматической рассылке уведомлений, коммерческих предложений и транзакционных сообщений. Чтобы использовать готовый макет или перенести шаблон из другого проекта, необходимо знать порядок импорта и настройки параметров в административной части.

Импорт выполняется через раздел Настройки → Почтовые события. Здесь можно добавить новый шаблон и загрузить файл с HTML-кодом письма. Важно проверить, чтобы код содержал корректные теги #ПОЛЯ#, соответствующие переменным Битрикс, иначе подстановка данных при отправке не сработает.

Перед импортом стоит убедиться, что файл сохранён в кодировке UTF-8 без BOM. Это исключит ошибки отображения кириллических символов. Если используется встроенный редактор Битрикс, лучше предварительно протестировать шаблон в локальном HTML-редакторе и только затем переносить в систему.

После загрузки нужно выбрать событие, к которому будет привязан шаблон, а также указать email-отправителя и тему письма. При необходимости можно сразу создать несколько вариантов письма для разных языков или сегментов получателей.

Подготовка шаблона письма к загрузке

Перед импортом в Битрикс шаблон необходимо привести к требованиям системы. Несоблюдение структуры или использование неподдерживаемых элементов приведёт к искажению письма.

• Файл шаблона должен быть сохранён в формате .html с кодировкой UTF-8 без BOM.
• Вёрстка должна быть табличной, так как многие почтовые клиенты некорректно обрабатывают flex и grid.
• Стили допускаются только инлайновые. Встроенные или внешние CSS-файлы не будут корректно работать.
• Изображения должны храниться на доступном сервере. В коде прописываются абсолютные ссылки с HTTPS.
• Ширина письма не должна превышать 600–700 px, чтобы корректно отображаться в мобильных клиентах.
• Обязательно указывать текстовую версию письма для корректного отображения в простых почтовых клиентах.
• Все спецсимволы должны быть заменены HTML-сущностями ( , ©, —).

Для проверки используйте предварительный просмотр в разных почтовых клиентах (Outlook, Gmail, Яндекс.Почта). Ошибки в отображении лучше устранить до импорта.

Создание нового почтового события в админке

Перейдите в раздел «Настройки» → «Почтовые события». Нажмите «Добавить событие».

Укажите идентификатор (например, ORDER_CONFIRM), он будет использоваться при вызове события в коде. Введите название и описание для удобства администраторов.

Определите поля события: EMAIL_TO, USER_ID, ORDER_ID и другие, которые будут передаваться в шаблон. Эти переменные должны совпадать с данными, которые будут подставляться из модуля или компонента.

Сохраните событие и перейдите к созданию почтового шаблона, где будут использоваться заданные переменные.

Импорт шаблона через раздел «Почтовые события»

Перейдите в административной панели в раздел «Настройки» → «Почтовые события». В списке выберите событие, к которому необходимо привязать шаблон.

Нажмите «Добавить шаблон» и укажите код события. В поле «Тип письма» выберите язык, который будет использоваться для рассылки.

В разделе «Шаблон письма» вставьте готовый HTML-код. Рекомендуется использовать абсолютные пути к изображениям и корректно закрытые теги, чтобы исключить ошибки при отправке.

В параметрах шаблона укажите заголовок, тему письма и адрес отправителя. При необходимости добавьте системные макросы, например #USER_NAME# или #EMAIL#, для автоматической подстановки данных.

Сохраните изменения и протестируйте отправку через кнопку «Отправить тестовое письмо». При корректной настройке письмо отобразится с нужным оформлением и заменёнными переменными.

Настройка переменных и макросов внутри письма

В почтовых шаблонах Битрикс используются макросы, которые подставляют значения из профиля пользователя, заказа или системных параметров. Они записываются в фигурных скобках, например: #USER_NAME#, #ORDER_ID#, #SITE_NAME#. При отправке письма эти конструкции автоматически заменяются реальными данными.

Чтобы проверить доступные макросы, откройте настройки конкретного шаблона и изучите список переменных, привязанных к событию. Например, для события «Новый заказ» доступны данные о покупателе, сумме заказа, статусе, ссылке для оплаты.

Для корректного отображения рекомендуется всегда тестировать письмо через встроенную функцию отправки теста. Это позволит проверить подстановку переменных до запуска рассылки для клиентов.

Если требуется собственный макрос, его можно добавить через модуль «События» или написать обработчик, который дополняет массив переменных. Таким образом шаблон может содержать динамическую информацию, например персональные скидки или уникальные ссылки.

Привязка шаблона к конкретному событию

После импорта почтового шаблона в Битрикс необходимо определить событие, при котором он будет использоваться. Для этого откройте раздел «Настройки» → «Инструменты» → «Почтовые события».

Выберите событие из списка, например, «NEW_USER» для регистрации нового пользователя или «SALE_NEW_ORDER» для оформления заказа. В его карточке нажмите «Добавить шаблон» и укажите ранее загруженный вариант.

При сохранении обязательно проверьте код сайта, язык и тип письма (HTML или текстовый). Несоответствие параметров может привести к тому, что письмо не будет отправляться.

Если требуется использовать один шаблон для нескольких сайтов, создайте копию с разными настройками. Для проверки корректности работы отправьте тестовое письмо прямо из карточки события.

Проверка работы шаблона через тестовую отправку

После импорта почтового шаблона в Битрикс рекомендуется выполнить тестовую отправку, чтобы убедиться в корректном отображении всех элементов. Для этого перейдите в раздел «Маркетинг» → «Почтовые шаблоны», выберите нужный шаблон и нажмите кнопку «Тестовая отправка».

В поле получателя укажите свой рабочий email или тестовый ящик. Используйте реальный адрес, поддерживающий HTML, чтобы проверить верстку и стили. Убедитесь, что в шаблоне подставляются актуальные переменные, такие как #USER_NAME#, #ORDER_ID# и другие динамические поля.

После отправки проверьте письмо в разных почтовых клиентах: Gmail, Outlook, Яндекс.Почта. Обратите внимание на корректность отображения изображений, кнопок, ссылок и форматирования текста. Проверьте адаптивность на мобильных устройствах и десктопе.

Если обнаружены ошибки, вернитесь в редактор шаблона и исправьте HTML-код, CSS или переменные. Повторите тестовую отправку до полного соответствия визуала и функционала требованиям. Используйте несколько тестовых адресов, чтобы убедиться, что шаблон корректно обрабатывается разными почтовыми серверами.

Регулярная проверка после каждой правки позволяет снизить риск ошибок при массовой рассылке и обеспечивает точное отображение контента для конечного пользователя.

Вопрос-ответ:

Какие форматы файлов поддерживаются при импорте почтового шаблона в Битрикс?

Битрикс позволяет импортировать почтовые шаблоны в формате .xml. При этом структура файла должна соответствовать внутреннему формату системы: содержать описание шаблона, HTML-код письма и параметры рассылки. Несоответствие формата может привести к ошибкам при загрузке.

Где находится функция импорта шаблона в административной панели Битрикс?

Функция импорта находится в разделе «Маркетинг» → «Почтовые рассылки» → «Шаблоны писем». После открытия раздела нужно выбрать кнопку «Импорт» и указать путь к файлу шаблона на сервере или локальном компьютере. После этого система предложит проверить содержимое перед окончательной загрузкой.

Можно ли импортировать шаблон с готовой графикой и стилями?

Да, можно. Все визуальные элементы, включая картинки, стили CSS и встроенные изображения, можно включить в XML-файл шаблона. Важно, чтобы пути к изображениям были корректными: либо загружены в файловую систему сайта, либо указаны через доступные URL. В противном случае элементы могут не отображаться в письме.

Что делать, если при импорте шаблона возникает ошибка «Неверный формат файла»?

Ошибка обычно означает, что структура XML-файла нарушена или отсутствуют необходимые элементы. Рекомендуется проверить файл на синтаксические ошибки, убедиться, что все теги закрыты, а обязательные поля шаблона присутствуют. Также можно попробовать открыть файл в текстовом редакторе и сравнить с примером корректного шаблона.

Можно ли импортировать шаблон с настройками рассылки для нескольких языков?

Да, Битрикс поддерживает многоязычные шаблоны. В XML-файле можно указать отдельные блоки контента для каждого языка. После импорта система автоматически определяет языковые версии и позволяет использовать их при рассылках в зависимости от выбранного языка пользователя.

Как подготовить почтовый шаблон для импорта в Битрикс?

Для начала убедитесь, что шаблон сохранён в формате HTML с корректными путями к изображениям и стилям. Все файлы шаблона нужно упаковать в одну папку, чтобы при импорте Битрикс смог корректно распознать структуру. Затем создайте архив в формате ZIP, который будет содержать HTML-файл, изображения и любые дополнительные ресурсы, используемые в письме. Такой подход позволяет системе правильно загрузить шаблон и сохранить внешний вид письма без ошибок.

Можно ли импортировать шаблон из другой CMS в Битрикс без доработок?

Импортировать шаблон напрямую иногда возможно, но чаще требуется небольшая адаптация. Важно проверить совместимость HTML-кода и CSS с движком Битрикс, так как некоторые стили и скрипты могут не поддерживаться. Также рекомендуется проверить ссылки и изображения, чтобы они корректно отображались после импорта. После загрузки архива через административную панель можно открыть шаблон в редакторе Битрикс и при необходимости внести финальные правки.