Документация

SMTP-релей

Отправляйте письма из Stalwart, приложений и почтовых клиентов через Synapsea Mail. Используйте API-ключ проекта и подтверждённый домен отправителя.

Подключение

ПараметрЗначение
Серверmail.synapsea.agency
Порт587 — STARTTLS (обязательно)
Альтернативный порт465 — TLS (сразу при подключении)
Имя пользователяapi
ПарольAPI-ключ вашего проекта (sm_live_…)
АвторизацияPLAIN / LOGIN, TLS 1.2+

Проверка сертификата должна быть включена. Старый адрес smtp.mail.synapsea.agency был указан ошибочно — замените его на mail.synapsea.agency.

Stalwart

Создайте исходящий маршрут Relay / smarthost: сервер mail.synapsea.agency, протокол SMTP, порт 465, implicit TLS включён, authUsername = api, authSecret = API-ключ проекта. Выберите этот маршрут для внешней исходящей почты; локальную доставку оставьте локальной. На порту 587 вместо implicit TLS включите обязательный STARTTLS.

Настройка маршрутов в документации Stalwart

Nodemailer

import nodemailer from 'nodemailer';

const transport = nodemailer.createTransport({
  host: 'mail.synapsea.agency',
  port: 587,
  secure: false,
  requireTLS: true,
  auth: { user: 'api', pass: process.env.SYNAPSEA_API_KEY },
});

await transport.sendMail({
  from: 'sender@your-verified-domain.com',
  to: 'recipient@example.com',
  subject: 'Hello',
  text: 'Sent through Synapsea Mail',
});

Домены и доставка

Домены адресов From и MAIL FROM должны быть подтверждены в том же проекте. Настройте SPF, DKIM и DMARC по инструкциям кабинета. Релей отправляет почту с инфраструктуры Synapsea, но доставка во входящие зависит также от репутации домена и содержания письма.

Ответ 250 после DATA означает, что письмо принято в очередь. Результат доставки смотрите в кабинете. При временном ответе 4xx настройте повторные попытки на стороне клиента.

Лимиты и возможности

  • До 20 МиБ на SMTP-сообщение; текст до 2 МиБ, HTML до 5 МиБ. До 50 получателей конверта, включая Cc и Bcc.
  • Действуют лимиты и ограничения тарифа. SMTP использует общий API-лимит: до 60 запросов в минуту для проекта и IP; вход также использует один запрос. Одновременно — до 5 подключений с IP.
  • Вложения доступны на Pro и Scale: до 10 МиБ / 20 файлов на Pro и до 25 МиБ / 40 файлов на Scale, при этом действует общий предел SMTP 20 МиБ. На Free и Starter вложения недоступны.
  • Поддерживаются текст, HTML, Cc, Bcc, Reply-To, In-Reply-To и References. Письмо пересобирается и подписывается Synapsea: Message-ID и Date формируются заново, исходные DKIM-подписи удаляются. Отслеживание открытий и кликов для SMTP выключено.
  • Подписанные и зашифрованные MIME-сообщения S/MIME / PGP-MIME, SMTPUTF8 и отправка с пустым MAIL FROM пока не поддерживаются. Для других заголовков и дополнительных возможностей используйте HTTP API.

X-SM-Tag — тег до 64 символов; X-SM-Metadata — JSON-объект до 4096 символов; X-SM-Bulk: true — массовая отправка с проверкой отписок.

API-ключи проекта · Настройка домена · HTTP API