Поштові події 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)
• Логін та пароль поштового акаунта
• Тип шифрування

Після налаштування обов'язково тест через діагностику.

Покрокова діагностика проблем із доставкою

1. Перевірте SPF/DKIM записи — використовуйте онлайн-інструменти, як-от MXToolbox або Kitterman. Додайте DMARC для захисту.
2. Перевірте роботу агентів — переконайтеся, що php /path/to/bitrix/modules/main/tools/cron_events.php виконується щохвилини.
3. Протестуйте SMTP — змініть порт на 587 або 465, увімкніть шифрування.
4. Моніторте логи — увімкніть логування SMTP у налаштуваннях.
5. Збільште ліміти — перейдіть на платний тариф або використовуйте транзакційні сервіси для понад 500 листів на день.

Типові помилки та їх виправлення

Помилка конфігурації SPF/DKIM — найчастіша: 8 із 10 проєктів з проблемами доставки мають невірні DNS-записи. Друга за частотою — перевищення лімітів SMTP-сервера (наприклад, Яндекс обмежує 500 листів на день для безкоштовних акаунтів). Використовуйте корпоративні тарифи або транзакційні сервіси (SPF). Третя — неправильні налаштування черги: агенти не виконуються, листи накопичуються. 95% проблем доставки усуваються налаштуванням SMTP та SPF/DKIM.

Що входить у налаштування поштових подій під ключ?

При замовленні послуги ми надаємо:

• Аудит поточної поштової конфігурації та подій
• Налаштування SMTP з SPF/DKIM-записами
• Створення та доналаштування всіх шаблонів (стандартних і кастомних)
• Тестування доставки на всіх популярних поштових клієнтах (досягаємо 98% доставки)
• Документація з налаштувань та відновлення
• Навчання адміністратора Бітрікс роботі з поштовими подіями
• Гарантія доставки листів (при дотриманні наших рекомендацій)

Досвід наших фахівців — понад 5 років, виконано понад 50 проєктів з налаштування пошти Бітрікс. Після налаштування клієнти відзначають зниження скарг на неотримання листів на 80%.

Терміни та вартість

Зв'яжіться з нами для безкоштовної консультації з налаштування пошти. Замовте аудит поштової системи — перевіримо всі події та шаблони, дамо рекомендації. Понад 50 клієнтів уже скористалися нашими послугами.

Чому верстка сайтів на 1С-Бітрікс вимагає професіоналізму?

Відкриваєте template.php у попереднього підрядника — а там SQL-запити, бізнес-логіка та inline-стилі в одному файлі. На кожному другому проєкті, який ми беремо на підтримку, код шаблонів виглядає як звалище: кеш не працює, додати нову фічу — переписуй все. Виправлення такої верстки може коштувати чимало, а втрачений виторг через зламаний кошик у пік сезону може сягати десятків тисяч гривень.

Ми — команда сертифікованих розробників 1С-Бітрікс із десятирічним досвідом. За нашими плечима понад 50 успішних проектів верстки та підтримки. Наш підхід строго розділяє: логіка — в result_modifier.php або component_epilog.php, представлення — в template.php. Жодного CIBlockElement::GetList в шаблоні. Це скорочує час правок на 30–40% та виключає типові помилки, які ламають кеш. Подібну проблему виправляли клієнту з інтернет-магазину — він місяць не міг оновити блок «Акції». Після налаштування тегованого кеша правки вставали за хвилину, а не за день.

Отримайте безкоштовний аудит вашого проекту — зв'яжіться з нами.

Як правильно організувати шаблони компонентів?

Кастомний шаблон — це не один файл, а структура з п’яти-шести файлів:

• template.php — тільки HTML та виведення $arResult
• result_modifier.php — підготовка даних, додаткові вибірки
• component_epilog.php — код після кешування (лічильники, динаміка)
• style.css та script.js — підключаються через Asset::getInstance()->addCss() та addJs() (не через <link> — інакше ламається об'єднання)
• .parameters.php — параметри візуального редактора

Приклад структури для каталогу:

local/templates/your_template/components/bitrix/catalog.section/.default/
├── template.php
├── result_modifier.php
├── component_epilog.php
├── style.css
├── script.js
└── .parameters.php

Типові шаблони, які верстаємо під ключ:

Кешування: чому воно ламається і як лагодимо?

Компонентне кешування в Бітрікс ламається однією помилкою: вивели ім'я користувача всередині кешованого каталогу — всі бачать одне ім'я. Рішення — component_epilog.php для динамічних вставок.

Tagged cache ($this->setResultCacheKeys, CIBlock::clearIblockTagCache) налаштовуємо обов'язково. Змінили товар — очищується кеш лише цього товару, а не всього розділу. На проєкті з 50 000 товарів це дає приріст швидкості на 40% — в 1.4 раза швидше порівняно з повним скиданням.

Реальний кейс. Наш клієнт скаржився — на сторінці каталогу у всіх один кошик. Виявилося, попередній розробник вивів $_SESSION['BASKET'] всередині template.php компонента catalog.section. Компонент кешувався на годину — кошик застиг. Перенесли виведення в component_epilog.php, налаштували тегований кеш на sale.basket.basket.line. Сторінка не втратила у швидкості, кошик став актуальним. Збитки від несправного кошика в пік сезону могли бути значними, а вартість виправлення — помірною.

CSS-підходи: BEM, Tailwind або гібрид?

Для великих проєктів (30+ шаблонів) використовуємо BEM — .product-card__price, .product-card--featured. Стилі ізольовані, конфліктів немає. У Бітрікс обгортки з класами bx-component не чіпаємо — обгортаємо свій BEM-блок всередині.

Для типових завдань (лендінги, адмінки) беремо Tailwind 3+ з PurgeCSS — підсумковий CSS 10–30 КБ замість сотень. Дизайн-токени в tailwind.config.js фіксують кольори, шрифти, відступи в одному місці.

На більшості проєктів застосовуємо гібрид: BEM для структурних компонентів (каталог, картка, чекаут), Tailwind для утилітарних речей (відступи, flex-розкладки). Межу обговорюємо з командою заздалегідь.

Як досягти Core Web Vitals при верстці сайтів на Бітрікс?

Critical CSS — виділяємо стилі першого екрану через пакет critical, інлайнимо в <head>. Решта завантажується асинхронно через media="print" onload="this.media='all'". LCP на мобільних скорочується на 1–1.5 секунди.

Зображення — головне гальмо. Використовуємо <picture> з WebP та JPEG-фолбеком. loading="lazy" для всього нижче першого екрану. width та height явно прописані — CLS = 0. Обробник в urlrewrite.php генерує WebP на льоту.

Мініфікація та стиснення. CSS та JS через Vite або вбудоване об'єднання Бітрікс. Brotli на nginx (brotli_comp_level 6) — на 15–20% ефективніше за gzip. Кешування статики: expires 1y + версіонування через query string.

Ми готові зробити аудит вашого проєкту та запропонувати конкретні кроки. Закажіть консультацію.

Що входить в послугу верстки сайтів на 1С-Бітрікс?

Після замовлення верстки шаблону або адаптації готового рішення передаємо:

• Вихідні коди шаблонів компонентів з розділенням на template.php, result_modifier.php, epilog
• CSS та JS, підключені через Asset — без інлайн-стилів
• Налаштоване кешування з тегами
• Документацію за структурою та параметрами
• Доступ до Git-репозиторію з історією змін
• Навчання вашого розробника: як правити шаблон без втрати оновлюваності

Гарантуємо відповідність Core Web Vitals та кросбраузерність. Закріплюємо інженера з досвідом 10+ років.