Отправка по SMTP

Если не хочется писать интеграцию с REST API — отправляйте письма обычным SMTP. Подходит для WordPress, Tilda, 1С, Битрикс, CRM и любых библиотек с настройками «SMTP host / port / user / password».

Письмо, принятое по SMTP, проходит те же проверки, что и REST-отправка (верифицированный домен, suppression, лимиты тарифа) и точно так же видно в логах, статистике и вебхуках — только с пометкой источника smtp.

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

Параметр	Значение
Сервер	smtp.mailinfra.ru
Порт	587 — STARTTLS, основной · 465 — SSL/TLS · 2525 — как 587, если хостинг блокирует 587
Шифрование	обязательно (STARTTLS или SSL)
Логин	apikey — буквально эта строка
Пароль	ваш SMTP-ключ (mi_live_…)

Перед первой отправкой:

1. Верифицируйте домен и привяжите его к проекту — адрес в поле From должен быть на этом домене, иначе письмо отклоняется кодом 550.
2. Создайте SMTP-ключ: дашборд → Настройки → SMTP → Создать SMTP-доступ. Такой ключ умеет только отправлять по SMTP — если он утечёт из конфига CMS, доступа к вашим письмам и настройкам не будет. Обычные API-ключи тоже принимаются как пароль.

Ключ mi_test_… работает в sandbox-режиме: письмо появится в дашборде со статусом simulated, но реально не отправится — удобно для проверки интеграции.

Примеры

WordPress

Установите плагин WP Mail SMTP → Mailer «Other SMTP»:

Поле	Значение
SMTP Host	smtp.mailinfra.ru
Encryption	TLS
SMTP Port	587
Auto TLS	On
Authentication	On
SMTP Username	apikey
SMTP Password	ваш SMTP-ключ

«From Email» — адрес на вашем верифицированном домене.

Nodemailer

const nodemailer = require("nodemailer");

const transporter = nodemailer.createTransport({
  host: "smtp.mailinfra.ru",
  port: 587,
  secure: false, // STARTTLS включится автоматически
  auth: { user: "apikey", pass: "mi_live_xxxxxxxx" },
});

await transporter.sendMail({
  from: "Магазин <hello@ваш-домен.ru>",
  to: "client@example.com",
  subject: "Заказ подтверждён",
  html: "<b>Спасибо за заказ!</b>",
});

Python

import smtplib
from email.message import EmailMessage

msg = EmailMessage()
msg["From"] = "hello@ваш-домен.ru"
msg["To"] = "client@example.com"
msg["Subject"] = "Заказ подтверждён"
msg.set_content("Спасибо за заказ!")

with smtplib.SMTP("smtp.mailinfra.ru", 587) as smtp:
    smtp.starttls()
    smtp.login("apikey", "mi_live_xxxxxxxx")
    smtp.send_message(msg)

PHP (PHPMailer)

use PHPMailer\PHPMailer\PHPMailer;

$mail = new PHPMailer(true);
$mail->isSMTP();
$mail->Host       = 'smtp.mailinfra.ru';
$mail->Port       = 587;
$mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;
$mail->SMTPAuth   = true;
$mail->Username   = 'apikey';
$mail->Password   = 'mi_live_xxxxxxxx';

$mail->setFrom('hello@ваш-домен.ru', 'Магазин');
$mail->addAddress('client@example.com');
$mail->Subject = 'Заказ подтверждён';
$mail->msgHTML('<b>Спасибо за заказ!</b>');
$mail->send();

Как обрабатывается письмо

• Получатели берутся из SMTP-конверта (RCPT TO). Получатель, не указанный в заголовках To/Cc, считается скрытым (Bcc): письмо ему доставляется, а заголовок Bcc в исходящее письмо не попадает.
• Успешный ответ — 250 OK queued as <id>, где id — идентификатор письма для поиска в логах и API. Ответ приходит только после того, как письмо прошло все проверки и поставлено в очередь; любой другой код означает, что письмо не принято.
• Message-ID заменяется на платформенный (по нему трекаются bounce/жалобы). Для тредов используйте In-Reply-To / References — они проходят без изменений, как и ваши X-* заголовки.
• Теги: заголовок X-MailInfra-Tag: имя-тега (до 10 штук) — аналог tags в REST-запросе, работает в фильтрах логов и статистики.
• Return-Path выставляет платформа: отбойники приходят в нашу обработку и попадают в вашу статистику и suppression-список автоматически.

Лимиты

Лимит	Значение
Размер письма	25 МБ
Получателей на письмо	50
Писем на одно соединение	100, затем переподключитесь
Одновременных соединений с одного IP	10
Простой соединения	60 секунд
Скорость и месячный объём	по тарифу, общие с REST API

Не поддерживается в текущей версии: интернационализированные адреса (SMTPUTF8), рассылки без получателей в заголовке To (undisclosed-recipients), механизмы AUTH кроме PLAIN/LOGIN.

Коды ответов

Код	Что значит	Что делать
250	Письмо принято и поставлено в очередь.	Ничего — дальше следите по логам/вебхукам.
530 5.7.0	Нет TLS или не выполнен вход.	Включите шифрование и авторизацию в настройках.
535 5.7.8	Неверный логин или ключ.	Логин — строго apikey; проверьте ключ, он мог быть отозван.
538 5.7.11	Попытка входа без шифрования.	Включите STARTTLS (587/2525) или используйте порт 465.
550 5.7.1	Домен From не верифицирован / у ключа нет прав.	Верифицируйте домен и привяжите к проекту; создайте SMTP-ключ.
550 5.1.1	Получатель в списке подавления.	Адрес отписался или давал жёсткий возврат — см. список подавления.
550 5.6.0	Некорректное письмо (нет From, битый формат).	Проверьте формирование письма в вашей библиотеке.
552 5.3.4	Письмо больше 25 МБ.	Уменьшите вложения.
421 4.7.0	Слишком быстро: превышен RPS или лимиты соединений.	Притормозите, переподключитесь позже.
452 4.3.1	Исчерпана месячная квота тарифа.	Дождитесь нового месяца или повысьте тариф.
452 4.5.3	Больше 50 получателей в письме.	Разбейте отправку на части.
451 4.3.0	Временная ошибка на нашей стороне.	Повторите позже — библиотеки обычно делают это сами.

Коды 4xx — временные («повтори позже»), 5xx — постоянные («не повторяй, исправь причину»).