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.