Настройка почтовых событий и шаблонов 1С-Битрикс: SMTP, очередь, кастомы

Почему письма не доходят, если SMTP настроен?

Мы часто сталкиваемся с ситуацией, когда даже при корректном SMTP письма теряются. Основные причины: отсутствие SPF/DKIM-записей, невыполнение агентов очереди, превышение лимитов почтового сервера. Например, если в настройках SMTP указан порт 25 без шифрования, многие современные провайдеры блокируют соединение. Рекомендуем порт 587 с STARTTLS или 465 с SSL — это стандарт безопасности. В одном из наших проектов на каталоге 50 000 товаров письма уходили с задержкой до часа; после перевода агентов на cron и настройки SMTP время доставки сократилось до 10 секунд. Такая экономия времени возвращает до 8 часов административной работы в неделю.

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

Почтовая система Битрикс состоит из трёх уровней: почтовые события, шаблоны и служба отправки.

Почтовые события

Тип события (например, SALE_NEW_ORDER) определяет набор макросов и параметров. Настраивается в административной панели: Настройки → Почта → Почтовые события.

Шаблоны почтовых событий

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

Служба отправки почты

Выбор способа доставки: sendmail, mail(), SMTP или внешние сервисы (Mailgun, SendGrid). Для проектов с высокой нагрузкой используем SMTP с аутентификацией. SMTP в 10 раз надёжнее sendmail при объёме более 1000 писем в день. Настройка: Настройки → Настройки продукта → Почта.

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

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

• 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 — протокол передачи почты)
• Ошибки в /bitrix/modules/main/lib/mail/
• Настройки агентов: должны выполняться по cron, а не на хите

Если агенты не запущены, письма зависают в очереди отправки. Для критичных уведомлений (заказ, регистрация) включаем немедленную отправку.

Настройка SMTP

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

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

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

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

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

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

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

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

Какие типовые ошибки возникают при настройке почты?

Ошибка конфигурации SPF/DKIM — самая частая: 8 из 10 проектов с проблемами доставки имеют неверные DNS-записи. Вторая по частоте — превышение лимитов SMTP-сервера (например, Яндекс ограничивает 500 писем в день для бесплатных аккаунтов). Используем корпоративные тарифы или транзакционные сервисы. Третья — неправильные настройки очереди: агенты не выполняются, письма копятся.

Что входит в настройку почтовых событий под ключ?

При заказе услуги мы предоставляем:

• Аудит текущей почтовой конфигурации и событий
• Настройка SMTP с SPF/DKIM-записями
• Создание и донастройка всех шаблонов (стандартных и кастомных)
• Тестирование доставки на всех популярных почтовых клиентах
• Документация по настройкам и восстановлению
• Обучение администратора работе с почтовыми событиями
• Гарантия доставки писем (при соблюдении наших рекомендаций)

Опыт наших специалистов — более 5 лет, выполнено свыше 50 проектов по настройке почты Битрикс. После настройки клиенты отмечают снижение жалоб на неполучение писем на 80%.

Сроки

Свяжитесь с нами для бесплатной консультации по настройке почты. Закажите аудит почтовой системы — проверим все события и шаблоны, дадим рекомендации.