Почтовые события в Битрикс: частые ошибки новичков

Форма на сайте показывает сообщение об успешной отправке, но письма в почте нет: в Битрикс это не обязательно означает, что сломался шаблон. Событие, шаблон письма и доставка — разные звенья цепочки, и проверять их нужно отдельно. Ниже — порядок настройки для «1С-Битрикс: Управление сайтом»; названия пунктов интерфейса могут отличаться в зависимости от редакции и обновления.

До настройки: что понадобится

Подготовьте доступ к административной части сайта, почтовый адрес отправителя и доступ к почтовому серверу или панели хостинга. Для проверки нужен тестовый адрес, к которому у вас есть доступ. Если сайт отправляет почту через SMTP, попросите у администратора сервера точные параметры подключения, включая порт и способ шифрования: не подбирайте их наугад.

Убедитесь, что можете менять настройки именно того сайта, с которого отправляется письмо. В многосайтовой установке параметры и шаблоны могут относиться к разным сайтам. Изменение не в том контексте — частая причина ситуации, когда «всё настроено», но нужное письмо не отправляется.

Настройка по шагам

1. Определите тип события. В административной части откройте раздел почтовых событий и найдите событие, связанное с нужным действием: например, отправкой формы или регистрацией. Сверьте его идентификатор и доступные поля с тем, что передаёт ваш компонент или форма. Проверка: событие найдено, а его поля подходят для текста письма.

2. Проверьте шаблон. В разделе шаблонов почтовых событий найдите шаблон для нужного события. Проверьте, что он активен, привязан к правильному типу события и сайту, а адрес получателя указан или формируется подходящим для вашей задачи способом. Проверка: шаблон выбран для нужного сайта и содержит заполненные тему и тело письма.

3. Сверьте поля в шаблоне. Подстановки в тексте должны соответствовать полям конкретного события. Если шаблон ждёт имя и текст обращения, а событие передаёт поля с другими именами, письмо может прийти с пустыми значениями. Не копируйте подстановки из чужого шаблона без сверки. Проверка: названия полей в шаблоне совпадают с полями события.

4. Настройте отправителя. Укажите адрес, который разрешён почтовому серверу сайта. Адрес посетителя формы не стоит автоматически подставлять в поле отправителя: сервер может отклонить такое письмо или оно чаще попадёт в спам. Если нужно отвечать посетителю, используйте его адрес как адрес для ответа, если это поддерживают настройки и шаблон. Проверка: тестовое письмо уходит с ожидаемого адреса и не подменяет адрес сайта адресом пользователя.

5. Проверьте способ отправки. Уточните, использует ли сайт системную отправку почты или SMTP, и какие параметры доступны на сервере. При SMTP сверьте имя сервера, порт, шифрование и учётную запись с данными почтового провайдера. Проверка: тестовая отправка проходит, а в журнале или диагностике сервера нет ошибки соединения или авторизации.

6. Запустите тест через реальное действие. Отправьте форму с тестовыми данными и проверьте не только входящие, но и папки «Спам» и «Промоакции». Сравните время отправки с журналом почты, если он доступен. Проверка: письмо появилось в ящике, в нём заполнены ожидаемые поля, а получатель и отправитель указаны верно.

Частые ошибки и как их локализовать

Не меняйте сразу несколько настроек. Иначе после успешной отправки будет непонятно, что именно помогло. Идите от события к доставке: сначала выясните, сработало ли действие, затем проверьте шаблон и только потом — почтовый транспорт.

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

• Шаблон выключен или привязан не к тому сайту. Это особенно легко пропустить на проектах с несколькими сайтами. Проверьте активность шаблона и его принадлежность к нужному сайту.

• В письме остались пустые подстановки. Само письмо доставлено, но имя, телефон или сообщение отсутствуют. Сопоставьте поля шаблона с данными, которые передаёт конкретное событие; не ориентируйтесь только на подписи в форме.

• Письмо не проходит проверку отправителя. Если сервер не разрешает отправлять от имени произвольного домена или адреса посетителя, доставка может быть отклонена. Используйте подтверждённый адрес отправителя и смотрите точную ошибку в журнале почтового сервера или у хостинга.

• Настройки сайта и почтового сервера расходятся. Например, в Битрикс включён один способ отправки, а доступные на хостинге параметры относятся к другому. Запросите у провайдера актуальные параметры SMTP и проверьте их вместе с администратором.

Не ориентируйтесь только на сообщение формы «успешно». Оно может означать, что форма приняла данные, но не подтверждать доставку письма до почтового ящика. Для диагностики важны результат отправки, серверные журналы и проверка адреса получателя.

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

Как проверить результат без догадок

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

При обращении в поддержку приложите время теста, адрес сайта, название события, результат каждого теста и текст ошибки из журнала. Не отправляйте пароли, секреты SMTP и персональные данные посетителей. Если нужно передать настройки, замените чувствительные значения заглушками.

Что делать дальше

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

Термин. Почтовое событие — тип уведомления, который описывает действие сайта и набор данных для письма. Шаблон задаёт содержание и адреса конкретного письма; событие и шаблон связаны, но это не одно и то же.