Отправка по 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	Превышены лимиты соединений.	Переподключитесь позже.
452 4.3.1	Исчерпана месячная квота тарифа.	Дождитесь нового месяца или повысьте тариф.
452 4.5.3	Больше 50 получателей в письме.	Разбейте отправку на части.
451 4.3.0	Временная ошибка на нашей стороне.	Повторите позже — библиотеки обычно делают это сами.

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