Опишите доработку или сценарий — обсудим вместе с другими клиентами.
Надёжная отправка почты через SMTP с DKIM-подписью для 1С-Битрикс
Технические данные
Совместимые редакции
- Программа для ЭВМ "1С-Битрикс: Управление сайтом". Лицензия Старт
- Программа для ЭВМ "1С-Битрикс: Управление сайтом". Лицензия Стандарт
- Программа для ЭВМ "1С-Битрикс: Управление сайтом". Лицензия Малый бизнес
- Программа для ЭВМ "1С-Битрикс: Управление сайтом". Лицензия Бизнес
- Программа для ЭВМ "1С-Битрикс24". Лицензия Интернет-магазин + CRM (12 мес.)
Описание
Надёжная отправка почты через SMTP с DKIM-подписью для 1С-Битрикс«Надёжная отправка почты через SMTP с DKIM-подписью для 1С-Битрикс» (nan.smtp) — модуль для отправки почтовых сообщений сайта через внешние SMTP-шлюзы.
При стандартной отправке через встроенную PHP-функцию mail() письма интернет-магазинов и сайтов могут попадать в спам, задерживаться почтовыми сервисами или теряться при сбоях связи. В результате клиенты не получают подтверждения заказов, счета и ссылки на авторизацию. Модуль направляет исходящую корреспонденцию через внешние SMTP-шлюзы с авторизацией, шифрованием и цифровой DKIM-подписью.
Что делает модуль- Отправка через внешние SMTP-серверы: интеграция с Яндекс 360, Mail.ru для бизнеса, Gmail, VK WorkMail или корпоративным почтовым сервером компании.
- Журнал отправки писем: реестр исходящих сообщений с фиксацией даты, получателей, темы, шлюза и статуса доставки.
- Диагностика ошибок: запись кодов и ответов почтового сервера при возникновении неполадок соединения или авторизации.
- Автоматическая повторная отправка: при временной недоступности шлюза фоновый агент повторяет попытки отправки с настраиваемым интервалом.
- Встроенная проверка подключения: отправка тестового письма из панели управления для быстрой проверки корректности реквизитов без оформления заказов.
- Цифровая DKIM-подпись: подписание исходящих писем приватным RSA-ключом домена для корректной идентификации отправителя почтовыми провайдерами.
- Поддержка многосайтовости: независимые параметры подключения для сайтов в рамках одной установки 1С-Битрикс.
- Разделение потоков писем: назначение отдельного SMTP-подключения для сервисных уведомлений интернет-магазина и массовых рассылок.
- Макросы свойств заказа: передача полей заказа (#NAN_...#, #NAN_IMOPRICE#, #NAN_IMODELIVERY#, #NAN_IMOTRACKING#) в почтовые шаблоны интернет-магазина.
Модуль перехватывает исходящие почтовые события платформы на системном уровне через штатный интерфейс custom_mail(). Вместо встроенной функции mail() устанавливается прямое защищенное SMTP-соединение с использованием библиотеки PHPMailer.
События, заголовки и системные ответы шлюза сохраняются в служебной таблице nan_smtp_logs. При сетевом сбое или тайм-ауте активируется фоновый агент, который повторяет отправку неотправленных сообщений.
Совместимость- CMS: редакции 1С-Битрикс («Старт», «Стандарт», «Малый бизнес», «Бизнес», «Энтерпрайз») версии 18.0.0 и выше.
- Обязательные модули ядра: модуль main (главный модуль) версии 18.0.0+.
- Версия PHP: PHP 7.4 — 8.3.
- База данных: MySQL / MariaDB / PostgreSQL.
- Электронная коммерция: модуль «Интернет-магазин» (sale) требуется только для генерации макросов свойств заказа.
Команда разработки обеспечивает непрерывное сопровождение продукта:
- Выпуск обновлений при выходе новых версий PHP и платформы 1С-Битрикс.
- Техническая поддержка по электронной почте для решения вопросов интеграции и конфигурации.
Как настроить отправку почты через SMTP в 1С-Битрикс?
После инсталляции решения перейдите в Настройки > Настройки продукта > Настройки модулей > Отправка почты через SMTP (или пункт меню «Отправка почты через SMTP» в левой панели) и заполните реквизиты вашего почтового ящика (Яндекс, Mail.ru, Google Workspace или корпоративный сервер). Модуль перехватит исходящую почту сайта.
Почему письма от сайта попадают в спам или не доходят до адресата?
Стандартный почтовый транспорт PHP не передает необходимых параметров аутентификации, из-за чего почтовые провайдеры могут расценивать такие сообщения как спам. Авторизация на SMTP-сервере с корректной DKIM-подписью подтверждает подлинность домена отправителя и повышает вероятность доставки во входящие.
Что произойдёт, если почтовый шлюз временно недоступен?
Модуль зафиксирует ошибку в журнале и задействует механизм повтора: настраиваемое количество попыток и интервал между ними позволяют отправить письмо после восстановления связи.
Можно ли отправлять письма о заказах через один SMTP-сервер, а маркетинговые рассылки — через другой?
Да, архитектура модуля поддерживает разделение потоков: можно изолировать сервисные уведомления интернет-магазина от массовых рекламных рассылок.
Поддерживается ли работа с несколькими сайтами (мультисайтовость)?
Да, решение обеспечивает независимую настройку параметров подключения для каждого сайта в системе.
Как включить DKIM-подпись?
В интерфейсе модуля достаточно включить опцию DKIM, указать селектор, домен и закрытый ключ. Сформированная DKIM-подпись будет добавляться к заголовкам каждого исходящего письма.
Можно ли автоматически подставлять в почтовый шаблон данные доставки или трек-номер?
Да, модуль генерирует макросы свойств заказа (например, #NAN_IMOTRACKING#, #NAN_IMODELIVERY#, телефон, адрес и пользовательские свойства заказа), которые можно вставлять в стандартные почтовые шаблоны Битрикса.
Как проверить работу модуля без оформления реального заказа?
В административном меню модуля доступен инструмент тестовой отправки: укажите адрес получателя, нажмите «Отправить» и проверьте лог доставки в реальном времени.
Быстрый запуск
Шаг 1. Установка модуля
1. Установите модуль из Маркетплейса: перейдите в раздел Marketplace → Установленные решения → nan.smtp → Установить.
2. Мастер установки создаст служебные таблицы базы данных и зарегистрирует обработчики почтовых событий.
Шаг 2. Включение модуля
Перейдите в раздел Настройки → Настройки продукта → Настройки модулей → Отправка почты через SMTP.
На вкладке «Основные настройки» настройте базовые параметры модуля:1. Включить модуль — главный системный переключатель:
- Чекбокс отмечен: модуль активен, вся исходящая почта сайта отправляется через SMTP-сервер модуля.
- Чекбокс снят: модуль выключен. Отправка писем осуществляется стандартным способом (функцией mail() веб-сервера).
2. Использовать настройки сайта по умолчанию, если не удалось определить ID сайта:
- Опция определяет поведение модуля в ситуациях, когда почтовое событие генерируется без явной привязки к конкретному сайту (например, системные уведомления платформы, фоновые скрипты по cron или вызовы из консоли CLI).
- Механика работы:
- Чекбокс снят: если система многосайтовая (например, s1 и s2), и модулю не удалось определить ID сайта, перехват SMTP не выполняется, письмо отправляется стандартной функцией веб-сервера mail().
- Чекбокс отмечен (рекомендуется): для писем с неизвестным ID сайта модуль автоматически применяет параметры подключения того сайта, который в настройках 1С-Битрикс отмечен как «Сайт по умолчанию» (обычно s1).
3. Параметры журнала и повторной отправки: оставьте значения по умолчанию.
Нажмите кнопку «Сохранить».
Шаг 3. Подключение к SMTP-серверуВ верхней части страницы настроек модуля расположены вкладки сайтов, зарегистрированных в системе (например, [s1] Интернет-магазин).
Перейдите на вкладку вашего основного сайта и заполните поля базового подключения:
- Сервер: адрес SMTP-сервера почтового провайдера (например, smtp.yandex.ru, smtp.mail.ru, smtp.gmail.com либо локальный 127.0.0.1 / localhost).
- Порт:
- 465 — для протокола SSL (рекомендуется для большинства внешних сервисов);
- 587 — для протокола TLS;
- 25 — стандартный порт для локального почтового сервера или корпоративного сервера без шифрования.
- Защита: выбор протокола шифрования:
- SSL (для порта 465);
- TLS (для порта 587);
- Нет / Не использовать (для порта 25).
- Требуется авторизация: установите, если используете внешние почтовые службы. Для локального почтового сервиса на 127.0.0.1 или корпоративного сервера с авторизацией по доверенному IP-адресу может быть отключен.
- Логин: адрес почтового ящика, с которого отправляются письма (например, order@site.ru). При отправке через локальный сервер без авторизации поле оставьте пустым.
- Пароль: пароль приложения, сгенерированный в системе почтового провайдера (обычный пароль от почтового ящика не подходит). Для локального сервера без авторизации не заполняется.
- Заменять адрес отправителя на логин: рекомендуется включить. Большинство почтовых шлюзов отклоняют письма, если адрес в поле From отличается от адреса учетной записи авторизации.
- Имя отправителя для замены: укажите название вашего интернет-магазина или компании (например, Интернет-магазин «Ромашка»). Это имя увидят получатели в строке «От кого».
После заполнения полей нажмите «Сохранить».
Шаг 4. Проверка отправки тестового письма1. Перейдите: Сервисы → Отправка почты через SMTP → Написать письмо (страница /bitrix/admin/nan.smtp_send.php).
2. В форме проверки укажите:
- Сайт: выберите сайт, для которого настраивалось подключение (например, [s1] Интернет-магазин).
- Кому: ваш личный адрес электронной почты, к которому есть доступ.
- Тема: Тестовое сообщение nan.smtp.
- Сообщение: произвольный текст.
3.Нажмите кнопку «Отправить».
Шаг 1. Установка решения
- Установите модуль из Маркетплейса: перейдите в раздел Marketplace → Установленные решения → nan.smtp → Установить.
- Мастер установки создаст служебные таблицы базы данных и зарегистрирует обработчики почтовых событий.
Перейдите в раздел Настройки → Настройки продукта → Настройки модулей → Отправка почты через SMTP.
На вкладке «Основные настройки» настройте базовые параметры модуля:1. Включить модуль — главный системный переключатель:
- Чекбокс отмечен: модуль активен, вся исходящая почта сайта отправляется через SMTP-сервер модуля.
- Чекбокс снят: модуль выключен. Отправка писем осуществляется стандартным способом (функцией mail() веб-сервера).
2. Использовать настройки сайта по умолчанию, если не удалось определить ID сайта:
- Опция определяет поведение модуля в ситуациях, когда почтовое событие генерируется без явной привязки к конкретному сайту (например, системные уведомления платформы, фоновые скрипты по cron или вызовы из консоли CLI).
- Механика работы:
- Чекбокс снят: если система многосайтовая (например, s1 и s2), и модулю не удалось определить ID сайта, перехват SMTP не выполняется, письмо отправляется стандартной функцией веб-сервера mail().
- Чекбокс отмечен (рекомендуется): для писем с неизвестным ID сайта модуль автоматически применяет параметры подключения того сайта, который в настройках 1С-Битрикс отмечен как «Сайт по умолчанию» (обычно s1).
3. Параметры журнала и повторной отправки: оставьте значения по умолчанию.
Нажмите кнопку «Сохранить».
Шаг 3. Подключение к SMTP-серверуВ верхней части страницы настроек модуля расположены вкладки сайтов, зарегистрированных в системе (например, [s1] Интернет-магазин).
Перейдите на вкладку вашего основного сайта и заполните поля базового подключения:
- Сервер: адрес SMTP-сервера почтового провайдера (например, smtp.yandex.ru, smtp.mail.ru, smtp.gmail.com либо локальный 127.0.0.1 / localhost).
- Порт:
- 465 — для протокола SSL (рекомендуется для большинства внешних сервисов);
- 587 — для протокола TLS;
- 25 — стандартный порт для локального почтового сервера или корпоративного сервера без шифрования.
- Защита: выбор протокола шифрования:
- SSL (для порта 465);
- TLS (для порта 587);
- Нет / Не использовать (для порта 25).
- Требуется авторизация: установите, если используете внешние почтовые службы. Для локального почтового сервиса на 127.0.0.1 или корпоративного сервера с авторизацией по доверенному IP-адресу может быть отключен.
- Логин: адрес почтового ящика, с которого отправляются письма (например, order@site.ru). При отправке через локальный сервер без авторизации поле оставьте пустым.
- Пароль: пароль приложения, сгенерированный в системе почтового провайдера (обычный пароль от почтового ящика не подходит). Для локального сервера без авторизации не заполняется.
- Заменять адрес отправителя на логин: рекомендуется включить. Большинство почтовых шлюзов отклоняют письма, если адрес в поле From отличается от адреса учетной записи авторизации.
- Имя отправителя для замены: укажите название вашего интернет-магазина или компании (например, Интернет-магазин «Ромашка»). Это имя увидят получатели в строке «От кого».
После заполнения полей нажмите «Сохранить».
Шаг 4. Проверка отправки тестового письма1. Перейдите: Сервисы → Отправка почты через SMTP → Написать письмо (страница /bitrix/admin/nan.smtp_send.php).
2. В форме проверки укажите:
- Сайт: выберите сайт, для которого настраивалось подключение (например, [s1] Интернет-магазин).
- Кому: ваш личный адрес электронной почты, к которому есть доступ.
- Тема: Тестовое сообщение nan.smtp.
- Сообщение: произвольный текст.
3. Нажмите кнопку «Отправить».
Установите этот модуль прямо сейчас!
Для этого укажите адрес сайта:
Подтвердите что сама лицензия у вас куплена
