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

SMTP-релей

Если в вашем приложении уже настроен SMTP (Django, Laravel, Nodemailer и т.д.), не меняйте код — просто замените SMTP-настройки на наши.

Параметры подключения

Host: smtp.mail.synapsea.agency
Port (STARTTLS): 587
Port (TLS): 465
Username: api
Password: sm_live_... (ваш API-ключ)

Nodemailer

mailer.js
javascript
import nodemailer from "nodemailer";

const transporter = nodemailer.createTransport({
  host: "smtp.mail.synapsea.agency",
  port: 587,
  secure: false,           // true для порта 465
  auth: {
    user: "api",
    pass: process.env.SYNAPSEA_API_KEY,
  },
});

await transporter.sendMail({
  from: '"Shop" <noreply@example.ru>',
  to: "user@example.com",
  subject: "Order confirmed",
  html: "<h1>Спасибо!</h1>",
});

Django (settings.py)

settings.py
python
EMAIL_BACKEND = "django.core.mail.backends.smtp.EmailBackend"
EMAIL_HOST = "smtp.mail.synapsea.agency"
EMAIL_PORT = 587
EMAIL_USE_TLS = True
EMAIL_HOST_USER = "api"
EMAIL_HOST_PASSWORD = os.environ["SYNAPSEA_API_KEY"]
DEFAULT_FROM_EMAIL = "noreply@example.ru"

Laravel (.env)

.env
env
MAIL_MAILER=smtp
MAIL_HOST=smtp.mail.synapsea.agency
MAIL_PORT=587
MAIL_USERNAME=api
MAIL_PASSWORD=sm_live_...
MAIL_ENCRYPTION=tls
MAIL_FROM_ADDRESS=noreply@example.ru
MAIL_FROM_NAME="${APP_NAME}"

PHPMailer

send.php
php
$mail = new PHPMailer(true);
$mail->isSMTP();
$mail->Host = 'smtp.mail.synapsea.agency';
$mail->SMTPAuth = true;
$mail->Username = 'api';
$mail->Password = $_ENV['SYNAPSEA_API_KEY'];
$mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;
$mail->Port = 587;

$mail->setFrom('noreply@example.ru', 'Shop');
$mail->addAddress('user@example.com');
$mail->Subject = 'Hello';
$mail->Body = '<h1>Привет!</h1>';
$mail->isHTML(true);
$mail->send();

Кастомные теги и headers

SMTP протокол позволяет передать наши служебные поля через заголовки:

  • X-SM-Tag: welcome,onboarding — теги письма (для фильтрации в dashboard)
  • X-SM-Metadata: {"userId":"123"} — произвольный JSON

Ограничения

  • Максимальный размер письма: 20 MB
  • Максимум получателей в одном письме (To + Cc + Bcc): 50
  • Rate limit: 300 писем/сек с одного ключа

Если нужен выше rate limit — напишите в Telegram.