Налаштування поштових подій і шаблонів 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) або черга накопичилася — листи йдуть із затримкою. Для критично важливих сповіщень (замовлення, реєстрація) варто увімкнути негайне відправлення у налаштуваннях пошти.

Терміни