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 — массовая отправка с проверкой отписок.