Протокол интеграции SMTP для отправки транзакционных E-mail сообщений
ВНИМАНИЕ!
Для использования данного вида интеграции вам необходимо зарегистрироваться на серверной платформе Stream Telecom, либо с помощью менеджера компании.
Пароль для интеграции задается в настройках пользователя во вкладке Настройки API.
Функции
РЕКВИЗИТЫ SMTP-ПОДКЛЮЧЕНИЯ
SMTP Server: smtp.streamemail.ru
Port: 25, 2525
Security: Auto, TLS
SMTP over SSL Port: 2526
Username: login
Password: pass
Параметр | Описание |
---|---|
login | Логин от учетной записи Stream Telecom |
pass | Пароль API от учетной записи Stream Telecom |
ОТПРАВКА СООБЩЕНИЙ
При отправке через SMTP должны передаваться стандартные параметры email-сообщения, предусмотренные SMTP протоколом.
Пример передачи параметров:
from: 'sender@testmail.com',
to: 'test@testmail.com',
сс: 'cctest@testmail.com',
bcc: 'bcctest@testmail.com',
subject: 'Заказ готов к выдаче',
text: 'Заказ поступил в пункт выдачи',
html: '<p>Заказ поступил в пункт выдачи<p>',
Параметр | Обязательный | Описание |
---|---|---|
from | Да | Адрес отправителя |
to | Да | Имя и адрес получателя |
cc | Нет | Адреса для отправки копии письма |
bcc | Нет | Адреса для отправки скрытой копии письма |
subject | Нет | Тема письма |
text | Да | Текст письма |
html | Да | Текст письма в html-разметке |
attachments | Нет | Вложения. Формат передачи зависит от используемого инструментария отправки. |
ДОПОЛНИТЕЛЬНЫЕ ПАРАМЕТРЫ ОТПРАВКИ
Дополнительно вы можете передавать в заголовке письма следующие параметры.
Параметр | Описание |
---|---|
ST-Domain | Домен отправки, который будет использоваться для DKIM/SPF подписей. По умолчанию будет использован заданный в личном кабинете в разделе "Настройки" > "Настройки DKIM/SPF" |
ST-Delivery-Timestamp | Timestamp времени, когда письмо должно быть доставлено |
ST-Message-ID | Id сообщения, для идентификации писем в вебхуках |
ST-Campaign-ID | Идентификатор (численно-буквенный) для группировки писем по определенному признаку для отображения в статистике |
ST-No-Track-Opens | Передайте любое значение для отключения трекинга открытий |
ST-No-Track-Clicks | Передайте любое значение для отключения трекинга кликов |
ST-Callback-URL | Адрес вебхуков для статусов писем |
Любые другие заголовки кроме стандартных: Content-Type, MIME-Version, Message-ID, Date – добавляются без изменений.