Документация для разработчиков

Интеграция по SMTP

текущая версия 1.21

Что такое подключение по SMTP?

SMTP-подключение – это способ передачи нам писем на отправку через SMTP-протокол. Если ваша система, которой нужно отправлять письма, уже умеет это делать через SMTP, использование такого подключения существенно упростит интеграцию с Dashamail. Отправка писем через SMTP обладает рядом ограничений по сравнению с отправкой через транзакционное API.

Как получить логин и пароль для подключения?

Логин и пароль для подключения по SMTP доступны всем клиентам сервиса, которые настроили собственный домен отправки (DKIM&SPF) в разделе «Аккаунт» => «Мои домены».


На бесплатном тарифном плане API по умолчанию отключен. Для работы попросите нашу техподдержку открыть его для вашего аккаунта.

Реквизиты подключения для SMTP-модуля

  • SMTP Server: smtps.dashasender.ru
  • Port: 25, 2525
  • Security: Auto, TLS
  • SMTP over SSL Port: 465

Трекинг открытий и кликов

По-умолчанию во всех письмах включены трекинг открытий и кликов. Чтобы отключить трекинг открытий следует передавать заголовок DM-No-Track-Opens, содержащий любое значение. Чтобы отключить трекинг кликов следует передавать заголовок DM-No-Track-Clicks, содержащий любое значение. Также, если вы не можете добавлять заголовки в свои письма, в разделе «Интеграции» => «Транзакционные письма» => «SMTP доступ» возможно принудительное включение данных заголовков и, соответственно, отключение трекинга открытий и кликов.

Какие особенности отправки через SMTP?

  • Для DKIM/SPF подписей используется домен, который передается в заголовке DM-Domain, или первый по списку в разделе «Аккаунт» => «Мои домены».
  • Доступны отложенные письма, для этого в заголовках необходимо передавать заголовок DM-Delivery-Timestamp, в котором указать timestamp времени, когда письмо должно быть доставлено.
  • Для идентификации писем в вебхуках можно передавать заголовок DM-Message-ID, содержащий сгенерированный вами id сообщения
  • Для группировки писем по определенному признаку для отображения в статистике можно передавать заголовок DM-Campaign-ID, содержащий заданный вами идентификатор (численно-буквенный)
  • Любые другие заголовки кроме стандартных: Content-Type, MIME-Version, Message-ID, Date – добавляются без изменений.
  • Вебхуки для статусов писем используются те же, что и для HTTP API и настраиваются в разделе «Описание и настройка API».
  • В заголовке To возможно указывать несколько получателей через запятую.
  • Получатели в заголовках CC и BCC (копия и скрытая копия) поддерживаются аналогично To – через запятую.
  • При использовании заголовка DM-Ignore-Delivery-Policy «Единая политика коммуникаций» будет проигнорирована даже в случае включения для транзакционного трафика.

Важно!

Как и в случае транзакционного API обратный адрес, используемый в поле From («От кого»), должен быть подтвержден в разделе «Доставляемость» => «Подтвержденные отправители».

Проблемы? Вопросы?

Если вы столкнулись с проблемами или вам кажется что метод не работает? Пишите на support@dashamail.ru и вам быстро и квалифицированно ответят наши разработчики.