Полезное

Схемы интеграции с 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, как поставщика.

Клиент — клиент пользователя в тех случаях, когда Пользователь SaM oTPravil предоставляет возможность своим клиентам отправлять рассылки.
Особенности интеграции в сервис: Пользователю под каждого Клиента нужно настроить авторизацию и иметь несколько API-ключей от которых он будет отправлять письма Клиента

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

White Label SMTP

SMTP-сервис под вашим брендом с нашими бизнес-процессами «под капотом».

Свой SMTP-сервис нужен хостинг-провайдерам, чтобы предоставлять услуги по рассылкам клиентам, которые размещают у них свои сайты (интернет-магазины и другие). Также WL-решение подходит SaaS, которые продают услуги SMTP-сервиса в своём продукте.
Личный кабинет SMTP создан на основе нашей библиотеки API-методов, что упрощает встраивание ЛК в ваш продукт.
Используя готовое WL-решение, вам не нужно выстраивать свои бизнес-процессы. Важно следить за репутацией серверов, бороться со спамерами и стабильно отправлять большое количество рассылок — положитесь в этом на нашу экспертизу. Один из уже успешно реализованных кейсов — внедрение White Label SMTP в Selectel
Если нужно унести SMTP-сервис в свой периметр — предоставим МТА-решение.

Для брендов и компаний, которым важно управлять технологией и выстраивать свои бизнес-процессы, используя SMTP-решение на своей стороне.

Что учесть перед началом интеграции

Во время продумывания архитектуры будущей интеграции, лучше заранее учесть детали конкретно вашей интеграции. Вот несколько моментов, определившись с которыми на старте, вы в будущем сэкономите время на доработки.
С чем определиться
Комментарий
Сколько нужно пулов IP?
Минимальный набор это три пула: для маркетинговых коммуникаций с включенными глобальными стоп-листами и для триггерных коммуникаций с локальными стоп-листами и для транзакций с отключенными стоп-листами.
Будет ли api key отдельный под каждого клиента или под пул IP-адресов?
Рекомендуем делать отдельный api key под каждого клиента только в том случае, если потребность очевидна. Иначе используйте подход «отдельный api key под каждый пул IP адресов».
Как заменить служебные домены на свои?
Рекомендуем делать это только в том случае, если потребность очевидна. Заменить домены на свои можно будет в будущем, от вас при этом не потребуется дополнительно инвестировать в интеграцию.
Какой лимит эндпоинта для принятия хуков?
После первой большой рассылки есть риск, что эндпоинт заказчика «приляжет» от количества и скорости, с которой мы доставляем хуки. Имеет смысл сразу обозначить лимит.
Будут ли кампании больше 500 000 получателей?
Если будут, то для таких кампаний целесообразней использовать не единичный метод отправки, а пакетный, который поддерживает до 400Мб текста в одном запросе.
Напишите в поддержку, если нужна помощь.