Поштові події 1С-Бітрікс: налаштування SMTP та шаблонів
Професійне налаштування поштових подій 1С-Бітрікс включає SMTP, шаблони листів та чергу відправки. Ми налаштовуємо пошту Бітрікс під ключ.
Чому листи не доходять? Причини та рішення
Ми часто стикаємося з ситуацією, коли навіть при коректному SMTP листи губляться. Основні причини: відсутність SPF/DKIM-записів, невиконання агентів черги, перевищення лімітів поштового сервера. Наприклад, якщо в налаштуваннях SMTP вказано порт 25 без шифрування, багато сучасних провайдерів блокують з'єднання. Рекомендуємо порт 587 з STARTTLS або 465 з SSL — це стандарт безпеки. SMTP у 10 разів надійніший за sendmail при обсязі понад 1000 листів на день. Агенти на cron у 6 разів швидші за хітові. У одному з наших проєктів на каталозі 50 000 товарів листи йшли із затримкою до години; після переведення агентів на cron та налаштування SMTP час доставки скоротився до 10 секунд. Така економія часу повертає до 8 годин адміністративної роботи на тиждень, що заощаджує до 200 $ на місяць. Помилка конфігурації SPF/DKIM — найчастіша: 8 із 10 проєктів з проблемами доставки мають невірні DNS-записи. Рівень доставки в таких випадках падає до 30%.
Архітектура поштових сповіщень
Поштова система Бітрікс складається з трьох рівнів: поштові події, шаблони та служба відправки.
Поштові події
Тип події (наприклад, SALE_NEW_ORDER) визначає набір макросів і параметрів. Налаштовується в адміністративній панелі: Налаштування → Пошта → Поштові події.
Шаблони пошти
Конкретний лист для події: адресат, тема, тіло. Один тип події може мати кілька шаблонів для різних сайтів або умов. Налаштування: Налаштування → Пошта → Шаблони пошти.
Служба відправки
Вибір способу доставки: sendmail, mail(), SMTP або зовнішні сервіси (Mailgun, SendGrid). Для проєктів з високим навантаженням використовуємо SMTP з аутентифікацією.
Черга відправки
За замовчуванням листи відправляються через чергу за допомогою агента CAgent::AddAgent(). Якщо агенти не налаштовані на cron, черга може накопичуватися, і листи приходять із затримкою до кількох годин. Для важливих подій вмикаємо негайну відправку в налаштуваннях пошти. Ми рекомендуємо налаштувати агенти на cron — це гарантує відправку протягом хвилини.
Стандартні та кастомні поштові події
Стандартні події
Бітрікс постачається з передвстановленими подіями. Для інтернет-магазину ключові:
-
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 не проходять, листи у спамі.
Створення користувацьких подій
Для кастомних сповіщень (наприклад, менеджер призначений на угоду) створюємо тип події через адміністративну панель або програмно через CEventType::Add() (документація CEvent Бітрікс). Потім створюємо шаблон і викликаємо відправку з коду:
CEvent::Send('MY_CUSTOM_EVENT', SITE_ID, [ 'NAME' => $name, 'EMAIL' => $email, 'MESSAGE' => $text, ]); Налаштування SMTP та діагностика
Налаштування SMTP
Перейдіть до Налаштування → Налаштування продукту → Пошта → Поштовий агент. Вкажіть:
- SMTP-хост (наприклад,
smtp.yandex.ruабо корпоративний сервер) - Порт: 587 (STARTTLS) або 465 (SSL)
- Логін та пароль поштового акаунта
- Тип шифрування
Після налаштування обов'язково тест через діагностику.
Покрокова діагностика проблем із доставкою
- Перевірте SPF/DKIM записи — використовуйте онлайн-інструменти, як-от MXToolbox або Kitterman. Додайте DMARC для захисту.
-
Перевірте роботу агентів — переконайтеся, що
php /path/to/bitrix/modules/main/tools/cron_events.phpвиконується щохвилини. - Протестуйте SMTP — змініть порт на 587 або 465, увімкніть шифрування.
- Моніторте логи — увімкніть логування SMTP у налаштуваннях.
- Збільште ліміти — перейдіть на платний тариф або використовуйте транзакційні сервіси для понад 500 листів на день.
Типові помилки та їх виправлення
Помилка конфігурації SPF/DKIM — найчастіша: 8 із 10 проєктів з проблемами доставки мають невірні DNS-записи. Друга за частотою — перевищення лімітів SMTP-сервера (наприклад, Яндекс обмежує 500 листів на день для безкоштовних акаунтів). Використовуйте корпоративні тарифи або транзакційні сервіси (SPF). Третя — неправильні налаштування черги: агенти не виконуються, листи накопичуються. 95% проблем доставки усуваються налаштуванням SMTP та SPF/DKIM.
| Типова проблема | Рішення |
|---|---|
| Листи не доходять при SPF/DKIM | Перевірити DNS-записи, додати механізм DMARC |
| Затримки в черзі | Налаштувати агенти на cron, увімкнути негайну відправку для критичних подій |
| Ліміти поштового сервера (500 листів/день) | Перейти на транзакційний сервіс або корпоративний тариф |
Що входить у налаштування поштових подій під ключ?
При замовленні послуги ми надаємо:
- Аудит поточної поштової конфігурації та подій
- Налаштування SMTP з SPF/DKIM-записами
- Створення та доналаштування всіх шаблонів (стандартних і кастомних)
- Тестування доставки на всіх популярних поштових клієнтах (досягаємо 98% доставки)
- Документація з налаштувань та відновлення
- Навчання адміністратора Бітрікс роботі з поштовими подіями
- Гарантія доставки листів (при дотриманні наших рекомендацій)
Досвід наших фахівців — понад 5 років, виконано понад 50 проєктів з налаштування пошти Бітрікс. Після налаштування клієнти відзначають зниження скарг на неотримання листів на 80%.
Терміни та вартість
| Задача | Терміни | Вартість (орієнтовно) |
|---|---|---|
| Налаштування SMTP + перевірка існуючих подій | 2–4 години | Від 150 $ |
| Аудит та налаштування всіх подій магазину | 4–8 годин | Від 300 $ |
| Створення кастомних подій з шаблонами | 1–3 дні | Від 500 $ |
Зв'яжіться з нами для безкоштовної консультації з налаштування пошти. Замовте аудит поштової системи — перевіримо всі події та шаблони, дамо рекомендації. Понад 50 клієнтів уже скористалися нашими послугами.