Перейти к содержанию

SMTP API

Внимание

Для использования данного вида интеграции необходимо обратиться к менеджеру компании либо в техническую поддержку.

Описание

Платформа Devino Telecom позволяет клиентам отправлять транзакционные или одиночные email с помощью стандартного протокола SMTP. Данный вид интеграции позволит легко подключить CRM, CMS или другую систему к платформе Devino Telecom для отправки email. При отправке через протокол SMTP платформа Devino Telecom будет автоматически фильтровать отписавшиеся и hard bounce адреса.

Подключение

Чтобы начать отправлять транзакционные email-сообщения по протоколу SMTP, вам необходимо:

  • Зарегистрироваться в личном кабинете Devino Telecom.
  • Получить SMTP логин и пароль у менеджера компании либо у технической поддержки.
  • Сообщить IP-адрес, с которого вы будете подключаться к платформе Devino Telecom, менеджеру компании либо технической поддержке.
  • Задать для вашего приложения адрес integrationapi.net в качестве SMTP-сервера, порт 587 (TLS), либо 465 (SSL).
  • Указать полученные SMTP логин и пароль.

Требования и ограничения к отправке

При отправке email необходимо соблюдать следующие правила:

  • Использовать подтвержденный адрес отправителя - вы можете запросить адрес отправителя в личном кабинете на странице создания email-рассылки.
  • Указывать корректный адрес получателя.
  • Не отправлять письма, размер которых превышает 500 КБ.
  • Не загружать в письмо файлы. Если необходимо отправить файл, вы можете указать ссылку на этот файл.
  • Не указывать в поле TO несколько адресов получателя, так как отправка будет сделана только на первый адрес.
  • Использовать кодировку UTF-8.
  • Указывать ссылки на отписку [Unsubscribe] и веб-версию [WebVersion].

Важно

В тексте письма необходимо использовать ссылку на отписку. Для этого нужно передавать тег [Unsubscribe]:

Пример: Если вы хотите отписаться от рассылки нажмите *<a href="[Unsubscribe]">здесь</a>*.

Получение статистики

Статистика по письмам, отправленным через SMTP-протокол, собирается аналогично статистике по рассылкам, отправленным из личного кабинета.

Таким образом вы сможете видеть полноценную статистику по:

  • прочитанным письмам
  • количеству переходов по ссылке в тексте письма
  • количеству ошибок при доставке и т.д.

Статистику по транзакционным email-сообщениям вы можете получить в личном кабинете в разделе Статистика.

image

Обработка ошибок

Если при валидации email возникла ошибка, платформа Devino Telecom возвращает стандартный код ошибки SMTP 554 Transaction failed и текстовое описание.

Возможные описания ошибок

Текст ошибки Причина
Must authenticate before sending mail Не указан, или указан некорректный логин/пароль
Internal server error Ошибка сервера
Not allowed attachment type <расширение файла> Загружен запрещенный файл
Message exceeds fixed size limit Превышен допустимый размер письма
Invalid recipient address: <адрес получателя> Некорректный адрес получателя
Disallowed source address: <адрес отправителя> Неподтвержденный адрес отправителя

Настройка почтового клиента Outlook

Необходимо создать учетную запись типа IMAP/SMTP, для этого:

  1. Откройте Outlook
  2. Выберите раздел Файл
  3. Добавьте учетную запись
  4. Выберите опцию Ручная настройка или дополнительные типы серверов
  5. Выберите Протокол POP или IMAP

Заполните поля, используя данные учетной записи любого почтового сервиса:

  • Имя - любое имя
  • Адрес электронной почты
  • Тип учетной записи - IMAP
  • Сервер входящей почты - например, imap.gmail.com
  • Сервер исходящей почты (SMTP) - integrationapi.net

Выполните последовательность действий:

  1. Пользователь/пароль - данные для входа в учетную запись
  2. Другие настройки
  3. Сервер исходящей почты
  4. SMTP-серверу требуется проверка подлинности
  5. Вход с помощью
  6. Ввести SMTP-логин и SMTP-пароль
  7. Дополнительно
  8. SMTP-сервер - указать порт 587
  9. Сохранить

Отправка письма из .NET

using System;
using System.Diagnostics;
using System.Net;
using System.Net.Mail;
namespace Devino.Email.SmtpClient
{
    class Program
    {
        static void Main(array[string] args)
        {
            using (var smtpClient = new SmtpClient())
            {
                var sourceEmail = "noreplay@devinotele.com";
                var subject = "Test from smtp";
                var messageText = "Привет! <a href=\"http://www.devinotele.com\">Кликни меня</a>";
                var email = "test@devinotele.com";

                smtpClient.Host = "integrationapi.net";
                smtpClient.Port = 587;
                smtpClient.EnableSsl = true;
                smtpClient.Credentials = new NetworkCredential("1website", "test");

                var message = new MailMessage(sourceEmail, email) { Sender = new MailAddress(sourceEmail), Subject = subject, Body = messageText };
                try
                {
                    smtpClient.Send(message);
                }
                catch (Exception ex)
                {
                    Trace.TraceError(ex.Message);
                }
            }
        }
    }
}