Настройка почтовых событий и шаблонов 1С-Битрикс

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

Почтовые события — критическая инфраструктура сайта, но при первоначальной настройке им уделяют минимум внимания.

Настройка почтовых событий и шаблонов 1С-Битрикс

Архитектура почтовых уведомлений в Битрикс

В Битрикс почтовая система состоит из трёх уровней:

Почтовые события (Настройки → Почта → Почтовые события) — описание события: тип (SALE_NEW_ORDER), список макросов, доступных в шаблонах. Это «интерфейс» события.

Шаблоны почтовых событий (Настройки → Почта → Шаблоны почты) — конкретная реализация: кому отправить, тема, тело письма. Один тип события может иметь несколько шаблонов для разных сайтов или условий.

Служба отправки почты — настраивается в Настройки → Настройки продукта → Почта. Поддерживаются: sendmail, mail(), SMTP (с аутентификацией, SSL/TLS). Для production обязательно SMTP или внешний сервис (Mailgun, SendGrid, Unisender, DashaMail).

Стандартные события и их настройка

Битрикс поставляется с набором предустановленных событий. Для интернет-магазина ключевые:

• SALE_NEW_ORDER — новый заказ (отправка менеджеру и клиенту)
• SALE_ORDER_PAID — заказ оплачен
• SALE_ORDER_CANCELED — заказ отменён
• SALE_STATUS_CHANGED — изменение статуса заказа
• MAIN_USER_REGISTER — регистрация пользователя
• MAIN_USER_PASS_CHANGED — изменение пароля

Для каждого события настраивается: адрес отправителя (FROM), получатель (TO), тема (SUBJECT), тело письма. В полях доступны макросы события.

Типичная ошибка: в поле FROM указан адрес на домене, не совпадающем с доменом отправляющего сервера. SPF/DKIM не проходят, письма попадают в спам.

Настройка SMTP

Раздел Настройки → Настройки продукта → Почта → Почтовый агент. Указываем:

• SMTP-хост (например, smtp.yandex.ru или корпоративный сервер)
• Порт: 587 (STARTTLS) или 465 (SSL)
• Логин и пароль почтового аккаунта
• Тип шифрования

После настройки — обязательно тест через Настройки → Диагностика → Тест почты. Если письмо не приходит, смотрим /bitrix/modules/main/lib/mail/ и логи SMTP-сервера.

Создание пользовательских почтовых событий

Для кастомных уведомлений (например, «менеджер назначен на сделку», «истекает срок договора») создаём собственные типы событий через административную панель или программно через CEventType::Add(). Затем создаём шаблоны и вызываем отправку из кода:

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

Очередь отправки и задержки

По умолчанию Битрикс отправляет письма через очередь — агент CAgent::AddAgent() с вызовом CMailMessage::SendMessages(). Если агенты не запущены (нет cron) или очередь накопилась — письма уходят с задержкой. Для критически важных уведомлений (заказ, регистрация) стоит включить немедленную отправку в настройках почты.

Сроки