Рассылки из listmonk через SMTP

listmonk — менеджер рассылок и списков подписчиков, который устанавливается на свой сервер. Он хранит базу и отправляет кампании, а доставку поручает SMTP-серверам, которые вы укажете: держит к каждому пул соединений и сам ограничивает скорость. Поэтому важны не только хост и пароль, но и пул, темп, отказы и отписки. Ниже — подключение к fmailer.

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

Шаг 1 — добавьте SMTP-сервер

Откройте Настройки → SMTP и отредактируйте существующий блок или добавьте новый:

Адрес отправителя кампании — и адрес по умолчанию в разделе Настройки → Общие — должен быть на подтверждённом домене, например news@mail.example.ru.

Шаг 2 — пул соединений и таймауты

Нажмите «Сохранить», затем «Проверить соединение» у блока — listmonk отправит тестовое письмо на указанный адрес.

Шаг 3 — ограничьте скорость

Часовой лимит тарифа проверяет релей: сверх него каждое письмо получает 550 hourly limit exceeded, а после «Максимального порога ошибок» listmonk ставит кампанию на паузу. Лучше, чтобы listmonk сдерживал себя сам, — в разделе Настройки → Производительность:

• «Включить ограничение скользящего окна», «Длительность» 1h, «Макс. сообщений» — чуть меньше часового лимита тарифа.
• «Параллелизм» × «Скорость отправки сообщений» — потолок писем в секунду. После настройки окна значения по умолчанию можно не трогать.

Прогрев нового домена устроен иначе: он ничего не отклоняет, а письма сверх потолка доставляет позже. Подробнее — на странице лимитов отправки.

Отписка

Если в разделе Настройки → Конфиденциальность включён заголовок List-Unsubscribe, listmonk добавляет в каждое письмо кампании пару заголовков для отписки в одно нажатие. Когда мы относим письмо к массовым, релей заменяет эту пару своей: отписка попадает в список отписавшихся домена, и следующие письма на этот адрес мы не доставляем. В listmonk подписчик при этом остаётся активным — кого обновить, подскажет вебхук unsubscribed. Ссылка отписки в самом шаблоне по-прежнему ведёт в listmonk.

Шаг 4 — настройте обработку отказов

Включите Настройки → Отказы → «Включить обработку отказов», задайте действия (жёсткий отказ: количество 1, действие «Чёрный список») и подключите один или оба источника:

• Почтовый ящик для отказов (POP3). Письма об отказах приходят на адрес конверта — адрес отправителя кампании или Return-Path из пользовательских заголовков SMTP-блока. Он должен быть на подтверждённом домене, а return path домена в панели — пустым, иначе он заменит адрес listmonk.
• Вебхуки для отказов. Отказ, полученный нашими серверами при доставке, письмом не возвращается — он приходит вебхуком bounced. Включите вебхуки для отказов, создайте API-пользователя с ролью, в которой есть право webhooks:post_bounce, и передавайте события:

# Передаёт события bounced и complained в API отказов listmonk.
import hashlib, hmac, os, time
import requests
from flask import Flask, abort, request

app = Flask(__name__)
SECRET = os.environ["WEBHOOK_SECRET"]           # секрет эндпоинта вебхуков
LISTMONK = "https://lists.example.ru"
API_AUTH = ("bounce-bot", os.environ["LISTMONK_TOKEN"])  # API-пользователь listmonk
TYPES = {"bounced": "hard", "complained": "complaint"}

@app.post("/hooks/delivery")
def delivery():
    raw = request.get_data(as_text=True)
    ts = request.headers["X-Webhook-Timestamp"]
    sig = request.headers["X-Webhook-Signature"]
    expected = hmac.new(SECRET.encode(), f"{ts}.{raw}".encode(), hashlib.sha256).hexdigest()
    if abs(time.time() - int(ts)) > 300 or not hmac.compare_digest(expected, sig):
        abort(400)

    event = request.get_json()
    if event["event"] in TYPES:
        requests.post(f"{LISTMONK}/webhooks/bounce", auth=API_AUTH, timeout=10, json={
            "email": event["email"],
            "source": "relay",
            "type": TYPES[event["event"]],
        }).raise_for_status()
    return "", 204

Разбор ошибок