Схемы интеграции с SaM oTPravil

Об интеграции с SMTP

SMTP-сервис — это не только личный кабинет, но и библиотека API. Чем шире набор методов, тем больше задач закрывает интеграция: отправка, стоп-листы, статусы, домены, ключи.

Схема интеграции описывает, кто с кем разговаривает и какими методами. Ниже — три рабочие схемы SaM oTPravil: их имеет смысл прочитать до оценки трудозатрат, а не после первого 550.

Документация API › · Особенности интеграции с SMTP ›

Глоссарий

Одни и те же слова в трёх схемах значат разное. Сначала термины — потом стрелки.

Как выбрать тип интеграции

Выбор зависит от двух вопросов: зачем нужен SMTP и кто в терминах глоссария является Пользователем — а кто отправителем писем.

Разница типовой и «в сервис» — не в методах отправки, а в том, совпадают ли Пользователь и отправитель. Во втором случае появляется Клиент. White Label — когда Клиенту нужен свой SMTP-сервис в вашем интерфейсе, а не модуль внутри вашей отправки.

Типовая интеграция

Пользователь отправляет свои письма. Это базовая схема: на ней стоят и модуль рассылок, и White Label — просто с другими ключами и рассылками.

Авторизация

Ключ передаётся в заголовке Authorization без префикса Bearer:

Authorization: {{api_key}}

Ключей может быть несколько — это не ошибка, а способ развести трафик. На ключе задаются:

• IP, с которых уходят письма
• Проверка адреса по глобальному стоп-листу: включить или выключить
• Домены, с которых разрешена отправка
• Локальные стоп-листы копить по домену отправителя или по ключу (по умолчанию — по домену)

В типовой схеме есть пользовательские рассылки и нет клиентских: один бизнес, свои From, свои пулы.

Почему ключей несколько и как не смешать транзакции с маркетингом ›

Единичная отправка

Один получатель: OTP, статус заказа, письмо «ваш пароль». Мастер-система отдаёт выпуск, SMTP-сервис доставляет и возвращает статус.

Id письма из мастер-системы можно передать в поле x_track_id — тогда хуки и issue/status стыкуются с вашим учётом, а не только с нашим.

Пакетная отправка

Много получателей: сегмент, дайджест, акция. Пакет принимает SMTP-сервис — мастер-система не обязана «крутить» скорость сама.

Пакет не нагружает мастер-систему ради скорости: очередь и ретраи — на стороне SMTP-сервиса. На хуки поставьте rate limit, иначе первая большая рассылка может положить ваш приёмник.

Пакетная отправка: лимиты и нарезка › · Вебхуки ›

Стоп-листы

Через API можно вести только локальные стоп-листы — накопленные по домену отправителя. Глобальный список Сервиса вы не правите: его можно включить или выключить на ключе.

Как работают стоп-листы в SMTP ›

Интеграция в сервис

Пользователь — ваш продукт (CRM, LMS, helpdesk, SaaS). Клиент — его арендатор, от имени которого уходят письма. Отправка после подготовки — та же типовая схема, но ключ выбирается по типу трафика, а не «один на всех».

Рассылка здесь — это не «кампания в письмах», а настройка: стоп-листы и пул IP, с которых полетят письма Клиентов.

Процесс: подготовка пулов IP

1. Пользователь Создаёт минимум две рассылки методом blist/create — одну под маркетинг, одну под транзакции.
2. Пользователь Для каждой рассылки выпускает ключ методом authkey/create и сохраняет его у себя. Связь рассылка ↔ ключ — один к одному.

Как резать пулы, если двух мало:

• По гео: РФ / EU
• По риску: high / low
• По типу трафика: транзакции / маркетинг
• По Клиентам: свой пул на каждого

Процесс: верификация домена

Процесс: отправка

1. Клиент Запускает рассылку в интерфейсе Пользователя — не в ЛК SaM oTPravil.
2. Пользователь Определяет тип трафика и вызывает типовую интеграцию с ключом из подготовки пулов.

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

White Label SMTP

SMTP-сервис под вашим брендом, с нашими процессами «под капотом». Нужен хостерам (клиенты держат у вас сайты и хотят рассылки) и SaaS, которые продают SMTP как услугу, а не как встроенный модуль «мы сами шлём за клиента».

Продуктовая страница White Label › · Кейс Selectel ›

Чем отличается от модуля в сервисе

Клиент сам отправляет из своей системы типовой интеграцией, своим клиентским ключом. Пользователь выдаёт доступы и рисует ЛК, но не является отправителем каждого письма.

Мастер-ключ — у Пользователя, на White Label-методы. Клиентский ключ — у Клиента, на типовую отправку.

Готовый WL избавляет от выстраивания антиспама, репутации пулов и стабильной доставки больших объёмов. Если SMTP нужно унести в свой периметр — это уже МТА, не White Label в облаке.

МТА-решение ›

Что учесть на старте

Архитектуру дешевле решить до первой большой рассылки. Ниже — развилки со схем и из статьи про особенности SMTP: там разбор ошибок 550, ttl_date, шаблонов и очередей.

Особенности интеграции с SMTP › · Шаблоны и template_id › · Выделенный сендер › · Свой домен трекинга ›