Tovanix
Tovanix

Агрегированный SMTP API

Подключите к платформе собственные аккаунты отправки SMTP и отправляйте письма через один HTTP API. Платформа распределяет отправку между вашими аккаунтами по очереди, при сбое повторяет попытку через следующий аккаунт и предоставляет шаблоны, контакты, рассылки, список отписок и уведомления Webhook. Бесплатный тариф подключён по умолчанию; платные тарифы оплачиваются с баланса аккаунта.

Как это работает

Платформа не предоставляет ни сервис отправки, ни IP-адреса для отправки. Письма уходят через подключённые вами аккаунты; платформа выбирает аккаунт, повторяет попытки, ведёт записи и отправляет уведомления.

  1. Подключите аккаунты отправки: Добавьте аккаунт SMTP в консоли: хост, порт, шифрование, имя пользователя и пароль (или пароль приложения). Сначала можно проверить подключение и отправить тестовое письмо. Пароли хранятся в зашифрованном виде.
  2. Создайте API-ключ: Сгенерируйте ключ, начинающийся с smk_, и передавайте его в заголовке Authorization: Bearer. Можно создать несколько ключей и отзывать каждый по отдельности.
  3. Вызовите API отправки: Аккаунт выбирается по заданному вами приоритету и по тому, сколько он уже отправил сегодня. При ошибке аутентификации, ошибке подключения или временной ошибке используется следующий аккаунт, всего не более 3 попыток.
  4. Проверьте результат: В журнале отправки виден статус каждого письма, использованный аккаунт и ошибка, если она была. Как только принимающий сервер принимает письмо, оно отмечается как доставленное, и событие можно отправить на ваш Webhook.

Возможности

  • Ротация аккаунтов и повторные попытки: Аккаунты выбираются по приоритету и объёму отправки за сегодня, и для каждого аккаунта можно задать собственный дневной лимит. При сбоях аккаунта и временных ошибках попытка повторяется через другой аккаунт; ошибки, которые не исправит ни один аккаунт, например несуществующий адрес или отклонённое содержимое, не повторяются. Также можно закрепить отправку за одним аккаунтом.
  • Автоматическая приостановка и восстановление: Аккаунт, который 3 раза подряд завершился ошибкой, приостанавливается, и вы получаете уведомление. Затем платформа проверяет его подключение с интервалами, которые растут от 30 минут до 12 часов, и возвращает его в ротацию только после успешной проверки. Аккаунты, которые вы приостановили сами, никогда не включаются автоматически.
  • Шаблоны и переменные: Текст письма в HTML и в виде простого текста с подстановкой {{variable}}. При каждом сохранении создаётся версия, и можно посмотреть историю версий. Через API можно отправлять письма по коду шаблона.
  • Контакты и рассылки: Импортируйте контакты из CSV (до 10 MB на файл) и распределяйте их по группам. Рассылки отправляются группам или по списку, их можно запланировать, приостановить и отменить, а адреса отписавшихся и адреса с возвратами пропускаются автоматически.
  • Отслеживание открытий и кликов, отписка в один клик: Для HTML-писем рассылок можно включить отслеживание открытий и кликов, а {{unsubscribe_url}} в тексте заменяется ссылкой для отписки конкретного получателя. Каждое письмо рассылки содержит заголовок для отписки в один клик.
  • Список отписок и возвратов: На адреса, с которых были возвраты или жалобы, письма больше не отправляются, даже транзакционные. Адреса, которые перешли по ссылке отписки или были добавлены вручную, пропускаются только при рассылках и пакетной отправке, но не для транзакционных писем, таких как коды подтверждения и сброс пароля.
  • Уведомления о событиях Webhook: События «доставлено», «открыто», «клик», «возврат», «жалоба», «отписка» и другие отправляются на ваш URL с подписью HMAC-SHA256. Их также можно отправлять напрямую групповым ботам Slack, Discord, Feishu, DingTalk и WeCom.
  • Проверка доменов отправки: Проверяет записи SPF, DKIM и DMARC домена отправки и выдаёт оценку и DNS-записи, которые нужно добавить.

Интеграция

HTTP API с телом запроса в JSON и аутентификацией по API-ключу. В консоли можно также написать отдельное письмо или создать рассылку без кода.

  • POST /api/v1/smtp/send: Отправить одно письмо. Поддерживаются копия и скрытая копия (CC и BCC), вложения, встроенные изображения, текстовая альтернатива, собственные заголовки и отложенная отправка, а также Idempotency-Key для защиты от повторной отправки.
  • POST /api/v1/smtp/send/batch: Отправить за один вызов по отдельному письму каждому из нескольких получателей; лимит получателей зависит от тарифа.
  • POST /api/v1/smtp/send/template: Отправить письмо по коду шаблона, подставив значения его переменных.
  • GET /api/v1/smtp/status/{message_id}: Узнать статус доставки письма.
  • GET /api/v1/smtp/quota: Проверить оставшийся лимит на сегодня и на этот месяц.
  • POST /api/v1/smtp/inbound: Сообщить о возврате или жалобе; адрес добавляется в список отписок.

Ограничения

  • Не более 20 запросов в секунду на один API-ключ и 60 в секунду на аккаунт.
  • Не более 20 вложений на письмо, в сумме не более 15 MB после декодирования.
  • Отложенную отправку можно назначить не раньше чем через 30 секунд, в очереди может стоять до 500 писем на аккаунт.
  • Доступен только HTTP API; доступ по протоколу SMTP не предоставляется.

Правила тарифов и лимитов

  • Бесплатный тариф подключён по умолчанию без подписки и по истечении срока продлевается сам.
  • Дневной лимит обнуляется в полночь по часовому поясу вашего аккаунта; месячный лимит — 1-го числа каждого месяца.
  • Платные тарифы оплачиваются помесячно или за год с баланса аккаунта, и их можно продлить в консоли до окончания срока. Автоматически они не продлеваются.
  • Когда платный тариф заканчивается, вы возвращаетесь к лимитам и возможностям бесплатного тарифа. Подключённые аккаунты, шаблоны и контакты не удаляются.
  • Смена тарифа вступает в силу сразу. Неиспользованное время старого тарифа засчитывается по его исходной цене; зачёт сверх цены нового тарифа продлевает срок, а не возвращается деньгами. Объём, отправленный в этом месяце, переносится на новый тариф.
  • Письма уходят через подключённые вами аккаунты, поэтому попадание во входящие зависит от репутации этих аккаунтов и вашего домена отправки. Платформа не обещает определённого процента доставки.

Тарифы и цены

ТарифыПомесячноЗа годПисем в деньПисем в месяцАккаунты отправкиПолучателей за один пакетный запросШаблоны писемКонтактыРассылок в месяцПроверки домена отправкиАдреса Webhook
БесплатноБесплатноБесплатно50010,0002100201,000Не входит1Не входит
Базовое$1.00/мес.$10.00/год5,000100,00051,00010020,0005053
Профессиональный$5.00/мес.$50.00/год50,0001,000,0002010,0001,000200,0005002020
Корпоративный$20.00/мес.$200.00/год200,0005,000,00010050,0009,9992,000,0009,999100100

Цены указаны в USD — это стандартная цена до входа в аккаунт. Часть стоимости можно оплатить баллами; окончательной считается сумма на странице заказа. Лимиты считаются по отправленным письмам: при пакетной отправке и рассылках каждый получатель считается одним письмом.

Часто задаваемые вопросы

Для чего нужен агрегированный SMTP API?

Он позволяет подключить один или несколько собственных аккаунтов отправки SMTP и отправлять письма через один HTTP API. Платформа чередует аккаунты, при сбое повторяет попытку через другой аккаунт и предоставляет шаблоны, контакты, рассылки, список отписок и уведомления Webhook. Сама платформа сервис отправки не предоставляет.

Что для этого нужно?

Хотя бы один аккаунт отправки, в который можно войти по SMTP: подойдёт SMTP почтового провайдера, корпоративная почта или собственный почтовый сервер. Понадобятся хост, порт, имя пользователя и пароль (или пароль приложения). Для рассылок сначала настройте SPF, DKIM и DMARC для своего домена отправки.

Какие ограничения у бесплатного тарифа?

Объём отправки, число аккаунтов отправки, шаблонов и контактов указаны в таблице тарифов. Бесплатный тариф не включает рассылки и Webhook; все остальные эндпоинты отправки работают. Он не требует подписки и остаётся доступным.

Можете ли вы гарантировать попадание во входящие?

Нет. Письма уходят через подключённые вами аккаунты, и принимающая сторона решает, положить письмо во входящие или в спам, исходя из репутации аккаунта и домена отправки, а также из содержимого. Платформа может проверить записи SPF, DKIM и DMARC вашего домена и автоматически пропускает адреса, с которых были возвраты или жалобы.

Можно ли подключиться к платформе напрямую по SMTP?

Нет. Доступен только HTTP API, а также написание писем и создание рассылок в консоли. Платформа подключается к добавленным вами аккаунтам SMTP, чтобы отправлять письма; SMTP-релей она не предоставляет.

Что будет, если аккаунт постоянно выдаёт ошибки?

Аккаунт, который 3 раза подряд завершился ошибкой, приостанавливается, и вы получаете уведомление, а остальные аккаунты продолжают отправку. Затем платформа регулярно проверяет подключение этого аккаунта и возвращает его в ротацию только после успешной проверки. Если вы измените параметры подключения или включите аккаунт сами, он тоже сразу восстанавливается.

Как считаются лимиты и что будет, когда они закончатся?

Лимиты считаются по отправленным письмам: при пакетной отправке и рассылках каждый получатель считается одним письмом. Дневной лимит обнуляется в полночь, месячный — 1-го числа каждого месяца. Когда лимит исчерпан, API отправки отклоняет новые запросы; дождитесь обнуления или перейдите на старший тариф — это вступает в силу сразу.

Можно ли пользоваться сервисом через ИИ-клиент?

Да. Подключив аккаунт в ИИ-клиенте с поддержкой MCP, можно проверять тарифы и расход, читать журналы отправки, отправлять письма 1–10 получателям, а также управлять контактами, шаблонами, Webhook и доменами отправки. Для продления нужен одноразовый код.

Связанные страницы: Маршрутизация входящей почты и API отправки для домена · Корпоративная почта на вашем домене · SMS-верификация · SMTP API электронной почты · Использование API агрегации SMTP

Загрузка…