Схемы интеграции с SaM oTPravil
Описание возможностей и разные типы интеграций на основе существующих API-методов
Об интеграции с SMTP
SMTP-сервис — это не просто онлайн-продукт с личным кабинетом для работы с SMTP-отправками, но и дополнительные инструменты для работы с почтой.
База любого SMTP-сервиса — его библиотека — набор API-методов, позволяющих работать с рассылками. Чем больше методов, тем больше задач может решать бизнес, и тем эффективнее будет работать интеграция.
Схема интеграции — это описание принципа взаимодействия между сервисами с помощью API-методов. Мы подготовили данные схемы интеграции с нами со ссылками на API-методы, которые нужно использовать.
Рекомендуем изучить файл перед началом работы с нами — это поможет понять, какая схема подойдёт для решения ваших задач, а вашим техническим специалистам — не ждать начала работы и сразу изучить, какие методы у нас есть и как они работают.
Термины
Понятия, которые мы используем в описании схем интеграций и работе.
Типы интеграции с SMTP-сервисом
Выбор подходящего вам способа интеграции зависит от бизнес-задач по рассылкам (зачем нужен SMTP) и технических возможностей (как эффективнее всего подключить SMTP).
Два основных способа: типовая и интеграция в сервис.
Типовая интеграция — для отправки собственных писем по SMTP-протоколу. Например, продуктовых и транзакционных уведомлений.
Интеграция в сервис (с модулем рассылок) — для отправки писем своих клиентов SaaS-сервисам (где есть услуги по рассылкам).
Также есть вариант заказать White Label SMTP — SMTP-сервис под вашим собственным брендом.
Мы подготовили схемы интеграции со ссылками на API-методы, которые нужно использовать.
Файл с подробным описанием схем интеграций
Подробнее о типах интеграции
Разница между типовой интеграцией и интеграцией в сервис: в том, кто является Пользователем SMTP-сервиса и кто отправляет письма.
В типовой тот, кто пользуется SMTP-сервисом и отправитель писем, — это один и тот же «человек». А при интеграции SMTP в сервис — разные.
Так как во втором случае появляется Клиент — «человек», который отправляет письма через этот сервис. Методы при этом остаются теми же.
Типовая интеграция
Отправка рассылок по своей базе (Пользователь = отправитель). Подходит для большинства бизнес-задач по рассылкам.

Интеграция в сервис (модуль рассылок)
Отличается от типовой интеграции тем, что пользователь SMTP-сервиса и отправитель писем — это разные бизнесы.
В нашей терминологии (см. глоссарий) пользователь это тот, кто использует наш SMTP, а клиент — клиент нашего пользователя (тот, от чьего имени отправляются письма.
Клиент — клиент пользователя в тех случаях, когда Пользователь SaM oTPravil предоставляет возможность своим клиентам отправлять рассылки.
Особенности интеграции в сервис: Пользователю под каждого Клиента нужно настроить авторизацию и иметь несколько API-ключей от которых он будет отправлять письма Клиента
Далее для отправок писем используется стандартная типовая интеграция с разными API-ключами под каждого клиента. Методы работы с рассылками также остаются стандартными. Пользователь сам управляет рассылками клиента и мониторит их статусы.
White Label SMTP
SMTP-сервис под вашим брендом с нашими бизнес-процессами «под капотом».
Свой SMTP-сервис нужен хостинг-провайдерам, чтобы предоставлять услуги по рассылкам клиентам, которые размещают у них свои сайты (интернет-магазины и другие). Также WL-решение подходит SaaS, которые продают услуги SMTP-сервиса в своём продукте.
Используя готовое WL-решение, вам не нужно выстраивать свои бизнес-процессы. Важно следить за репутацией серверов, бороться со спамерами и стабильно отправлять большое количество рассылок — положитесь в этом на нашу экспертизу. Один из уже успешно реализованных кейсов — внедрение White Label SMTP в Selectel
Если нужно унести SMTP-сервис в свой периметр — предоставим МТА-решение.
Для брендов и компаний, которым важно управлять технологией и выстраивать свои бизнес-процессы, используя SMTP-решение на своей стороне.
Что учесть перед началом интеграции
Во время продумывания архитектуры будущей интеграции, лучше заранее учесть детали конкретно вашей интеграции. Вот несколько моментов, определившись с которыми на старте, вы в будущем сэкономите время на доработки.
Сколько нужно пулов IP?
Минимальный набор это три пула: для маркетинговых коммуникаций с включенными глобальными стоп-листами и для триггерных коммуникаций с локальными стоп-листами и для транзакций с отключенными стоп-листами.
Будет ли api key отдельный под каждого клиента или под пул IP-адресов?
Рекомендуем делать отдельный api key под каждого клиента только в том случае, если потребность очевидна. Иначе используйте подход «отдельный api key под каждый пул IP адресов».
Как заменить служебные домены на свои?
Рекомендуем делать это только в том случае, если потребность очевидна. Заменить домены на свои можно будет в будущем, от вас при этом не потребуется дополнительно инвестировать в интеграцию.
Какой лимит эндпоинта для принятия хуков?
После первой большой рассылки есть риск, что эндпоинт заказчика «приляжет» от количества и скорости, с которой мы доставляем хуки. Имеет смысл сразу обозначить лимит.
Будут ли кампании больше 500 000 получателей?
Если будут, то для таких кампаний целесообразней использовать не единичный метод отправки, а пакетный, который поддерживает до 400Мб текста в одном запросе.
Мы используем куки и обрабатываем данные о посетителях сайта согласно политике. Настройки можно изменить в браузере.