Как настроить почтовые события в Битрикс: пошаговый разбор

За 20–30 минут вы создадите собственный тип почтового события, привяжете к нему шаблон и проверите отправку. Инструкция — для 1С-Битрикс: Управление сайтом, классического административного интерфейса и модуля «Главный»; конкретные названия пунктов меню могут отличаться между версиями. Настройка шаблона не запускает отправку: событие должен вызвать код сайта.

Что нужно подготовить

До начала работы убедитесь, что у вас есть:

• доступ в административную панель с правами на почтовые события и шаблоны;
• доступ к файлам сайта или возможность передать разработчику небольшой фрагмент кода;
• почтовый ящик для проверки и настроенная отправка почты с сервера;
• идентификатор сайта: например, s1. Его можно посмотреть в настройках сайтов административной панели.

Примеры ниже используют API CEvent::Send модуля «Главный», применяемое в 1С-Битрикс: Управление сайтом 24.x. Если у вас другая версия, сверьте сигнатуру метода с документацией именно для неё.

Шаг 1. Создайте тип события

Откройте раздел почтовых событий в административной панели. В классическом интерфейсе он находится в разделе «Настройки»; ищите пункт «Почтовые и СМС события» или «Типы почтовых событий». Создайте событие с символьным кодом MY_FORM_NOTICE, укажите название, например «Уведомление о новой заявке», и добавьте поля, которые понадобятся в письме:

• NAME — имя отправителя;
• EMAIL — адрес для ответа;
• MESSAGE — текст заявки.

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

Шаг 2. Создайте шаблон письма

Перейдите к почтовым шаблонам и добавьте шаблон для созданного типа события. Выберите сайт, если проект многосайтовый, укажите адрес получателя и тему. В теле письма используйте поля события в формате #ИМЯ_ПОЛЯ#:

Новая заявка с сайта

Имя: #NAME#
Почта для ответа: #EMAIL#

Сообщение:
#MESSAGE#

Адрес получателя — это ящик, куда должно прийти уведомление; #EMAIL# в примере — адрес посетителя, который заполнил форму. Эти роли не следует путать. Проверка: шаблон сохранён, активен и привязан к нужному типу события и сайту.

Шаг 3. Вызовите событие из кода

После успешной обработки формы передайте данные в CEvent::Send. Фрагмент рассчитан на выполнение внутри проекта, где уже доступна среда 1С-Битрикс:

<?php

CEvent::Send('MY_FORM_NOTICE', SITE_ID, [
    'NAME' => $name,
    'EMAIL' => $email,
    'MESSAGE' => $message,
]);

Переменные $name, $email и $message должны содержать уже полученные и проверенные данные формы. Размещайте вызов после успешной проверки и сохранения заявки, а не при каждом открытии страницы. Иначе письмо может уйти с пустыми полями или до того, как заявка попадёт в систему. Проверка: при отправке формы код доходит до вызова события без PHP-ошибки.

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

Шаг 4. Проверьте отправку

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

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

Если письмо не пришло

• В шаблоне не подставились значения. Проверьте точное совпадение имён: EMAIL и #EMAIL#. Учитывайте, что поле должно быть передано именно в массиве события.
• Событие вызвано, но шаблон не найден. Сверьте символьный код типа события, привязку шаблона к сайту и его активность.
• PHP сообщает «Class 'CEvent' not found». Код выполняется вне загруженной среды Битрикс или модуль «Главный» недоступен. Перенесите вызов в обработчик, который работает в контексте сайта.
• В письме видны знаки вместо русских букв. Проверьте кодировку шаблона и настройки отправки почты у хостинга; одинаковая кодировка нужна на всём пути отправки.
• Код отработал, но доставки нет. Проверьте настройки почтового сервера и журналы хостинга. Если используется очередь или отложенная отправка, проверьте, запускаются ли агенты и задания, отвечающие за обработку очереди.

Что проверить перед запуском

Почтовое событие¹ — сигнал, который сайт передаёт системе рассылки; по нему Битрикс подбирает подходящий шаблон и формирует письмо. Само создание типа события сигнал не вызывает.

Что делать дальше

После теста проверьте путь заявки целиком: форма принимает данные, сайт сохраняет заявку и только затем отправляет уведомление. На рабочем сайте отдельно убедитесь, что письма не уходят повторно при обновлении страницы, а в шаблон не попадают лишние персональные данные. Для диагностики доставки смотрите журналы почтового сервера и документацию хостинга; настройка SPF, DKIM и DMARC — отдельная задача.

¹ Термин «событие» здесь означает внутреннее событие почтовой системы Битрикс, а не любое действие пользователя на сайте.