Отправка и провайдеры¶

Mailroom сам не общается с почтовым сервером. Каждая кампания, письмо подтверждения и письмо автоматизации передаётся плагину Email для Grav, который отправляет их через тот транспорт, который вы ему дали: SMTP или транспортный плагин провайдера, например SMTP2GO, Amazon SES, SendGrid, Postmark, Mailgun, MailerSend или Resend. Эта страница описывает вкладки Sending и Providers в настройках Mailroom.

Может ли этот сайт отправлять почту?¶

Карточка вверху вкладки Sending читает плагин Email и сообщает:

• установлен ли он и отправляет ли письма («The Email plugin is configured and sending.»), и какой Engine использует;
• доходят ли Unsubscribe headers для отписки одним щелчком до этого транспорта. Доходят в большинстве случаев; транспорт, отбрасывающий собственные заголовки, лишает Gmail кнопки Unsubscribe, и карточка говорит об этом.

Под скоростью отправки карточка The queue worker говорит, когда обработчик запускался последний раз. Кампания — одно задание в очереди Mailroom, поэтому ничего не уходит, если обработчик не запущен (см. Задания и cron).

От кого приходит почта¶

В любом случае это должен быть адрес, с которого ваш почтовый провайдер разрешает отправлять. Баннер «no From address», предупреждение status и проверка Health появляются, только когда адреса нет ни у Mailroom, ни у плагина Email.

Кампания может переопределить оба и добавить Reply-to в редакторе кампании (см. Кампании). Список также может нести своё имя и адрес From, заданные через API (from_name и from_email у списка, см. REST API); страница списка показывает это как Sends as.

Как быстро отправляет сайт¶

Кампания, остановившая себя, показывает состояние Stopped и баннер на панели управления («The campaign ... stopped itself»). Исправьте настройки почты и нажмите Resume: никто из уже получивших её не получит письмо дважды.

Проверка Sending rate на экране Health предупреждает, когда скорость равна нулю (читается как одно сообщение в минуту) или выше того, что справляется один обработчик Grav и большинство тарифов провайдеров.

Что отправляет Mailroom¶

Три переключателя в What Mailroom Sends, каждый включён по умолчанию. Выключение останавливает этот вид сообщений, не трогая остальное.

Заголовки в почте кампаний и автоматизаций¶

Каждая кампания и каждое письмо автоматизации несут:

• List-Unsubscribe с формой mailto: вашего адреса From и HTTPS-ссылкой отписки, а также List-Unsubscribe-Post: List-Unsubscribe=One-Click. Вместе они ставят собственную кнопку Unsubscribe почтового клиента рядом с вашим именем (см. Отписку и предпочтения).
• Precedence: bulk.
• Собственный Message-ID и X-Mailroom-Campaign с id кампании.
• X-Grav-Send-Id, по которому webhook провайдера сопоставляет событие с сообщением, о котором оно.

Каждое сообщение, которое Mailroom передаёт плагину Email, также записывается в собственный журнал сообщений Mailroom (кто, что, когда, первое открытие и возврат), а задание, выполненное дважды, никогда не отправляет одно сообщение дважды. Журнал хранится Keep the Message Log For (mail_log.retain_days, 180 дней).

Webhook провайдеров¶

Провайдер может сообщить вашему сайту, что произошло с каждым сообщением: доставлено, возврат, отмечено как спам. Без этого Mailroom знает, что он передал, и что ваши читатели открыли и по чему перешли, но не что дошло. На вкладке Providers есть карточка для каждого транспортного плагина на сайте, который умеет сообщать о доставке.

Настройка¶

1. Откройте Settings Mailroom, затем вкладку Providers и найдите карточку своего провайдера.
2. Нажмите Generate a secret. Карточка показывает Webhook URL в форме https://www.example.com/newsletter/webhook/{provider}/{secret}.
3. Если у карточки есть кнопка Set up in для вашего провайдера, нажмите её: webhook создаётся через API провайдера с ключом, уже находящимся в настройках его транспортного плагина. Иначе нажмите Copy the URL, откройте How to set this up и создайте webhook в панели провайдера, как там сказано, с указанными событиями.
4. Если провайдер подписывает свои webhook, карточке нужен ключ подписи в настройках этого транспортного плагина. Пока его нет, карточка читается Needs a key, и каждое событие будет отклонено.

У каждой карточки есть состояние: Ready (секрет задан и всё, чем подписывает провайдер, присутствует), Needs a key или Not set up. Она также говорит, Signed ли события или «Not signed, so the secret in the URL is what protects it», и когда пришло последнее событие.

SMTP2GO¶

SMTP2GO ничего не подписывает, поэтому секрет в URL — вся его защита. Если вы добавляете заголовок Authorization в webhook в панели SMTP2GO, вставьте то же полное значение заголовка в providers.smtp2go.auth_header в user/config/plugins/mailroom.yaml (только YAML), и Mailroom будет проверять его при каждом событии.

Что отвечает webhook¶

Что делает каждое событие¶

У каждого события есть собственный ключ, поэтому webhook, отправленный провайдером снова, записывается один раз, а один временный сбой, доставленный трижды, никогда не становится тремя мягкими возвратами. То, что провайдер сказал о сообщении, хранится с хешем адреса и без самого адреса.

Чтобы увидеть, что сделала бы сохранённая полезная нагрузка, воспроизведите её:

bin/plugin mailroom webhook:replay mailgun payload.json          # показать, что будет сделано
bin/plugin mailroom webhook:replay mailgun payload.json --apply  # выполнить

См. CLI.

Когда всё замолкает¶

Проверка Bounce webhook на экране Health и баннер на панели управления говорят, когда webhook настроен и кампании ушли, но события не приходили днями, а также когда что-то отправляет на webhook провайдера, у которого ещё нет секрета («Something is posting to the ... webhook»). См. Устранение неполадок.

Связанные разделы¶

• Доставляемость
• Кампании
• Отписка и предпочтения
• Конфигурация