Кнопка «Отписаться» внутри письма и кнопка почтового клиента — два разных пути. Первая обычно открывает GET-страницу в браузере. One-click по RFC 8058 отправляет HTTPS POST на URL из заголовка `List-Unsubscribe`. Проверьте оба пути отдельно: рабочая HTML-ссылка ничего не доказывает о служебном POST.

Для one-click нужны два заголовка, URL с непрозрачным идентификатором получателя и списка, а endpoint должен обработать тело `List-Unsubscribe=One-Click`. RFC отдельно предупреждает не возвращать redirect на такой POST: исторически перенаправления меняли метод или обрабатывались ненадёжно.

Сначала определяем, какая именно кнопка сломана

СценарийЗапросЧто считать успехом
Ссылка в HTMLGET из браузераПонятное подтверждение и suppression state
Кнопка почтового клиентаPOST по RFC 80582xx без redirect и отключённая рассылка
mailto fallbackПисьмо на служебный адресАвтоматический разбор запроса
Повторный кликТот же token второй разТот же успешный итог без дубля
Истёкший/поддельный tokenGET или POSTБез раскрытия адреса и без изменения чужой подписки

Откройте «Показать оригинал» у реально доставленного экземпляра. Шаблон в панели рассылки может содержать заголовки, которые провайдер удалил, переписал или не включил в DKIM-подпись.

Минимальный one-click контракт виден в исходнике

List-Unsubscribe: <https://mail.example.ru/u/opaque-signed-token>
List-Unsubscribe-Post: List-Unsubscribe=One-Click

POST /u/opaque-signed-token HTTP/1.1
Content-Type: application/x-www-form-urlencoded

List-Unsubscribe=One-Click

# Ожидаемый ответ: 204 No Content, без 301/302

Идентификатор в примере условный. Не помещайте email открытым query-параметром: используйте непредсказуемый или подписанный token, который сервер связывает с конкретным subscription/list. RFC 8058 также требует валидную DKIM-подпись, покрывающую оба заголовка.

Endpoint меняет состояние один раз

  1. Проверить подпись и назначение token без пользовательской сессии и cookies.
  2. Найти конкретную подписку, а не глобально удалить контакт из всех обязательных потоков.
  3. Записать suppression state транзакционно и вернуть 2xx.
  4. Повтор того же POST вернуть как успех, не создавая новую операцию.
  5. Асинхронно передать suppression во внешние ESP и зафиксировать их acknowledgement.

Отписка от маркетинга не должна ломать обязательные сервисные сообщения, если продукт и применимое право действительно разделяют эти основания. Категории рассылки задаются явно; универсальная строка `subscribed=false` часто либо продолжает слать рекламу через другой канал, либо отключает нужные уведомления.

Редирект и защита сайта часто ломают POST

Проверьте HTTP-код без автоматического следования redirect. Типовые причины: перевод с одного hostname на другой, принудительный slash, CSRF middleware, обязательная login-cookie, WAF challenge или ожидание JSON вместо form-urlencoded. One-click endpoint — узкий публичный маршрут; защиту обеспечивает token и ограниченный контракт, а не браузерная сессия.

Не отключайте WAF целиком. Создайте точное правило только для пути и метода, оставьте rate limit и логируйте результат по token hash. Ответ не должен подтверждать, существует ли конкретный email в базе.

Кнопка появляется только у правильно собранного письма

Даже корректные заголовки не гарантируют одинаковый интерфейс во всех клиентах. Gmail в актуальных рекомендациях требует one-click для охваченных требований маркетинговых и подписных сообщений и отдельно просит видимую ссылку в теле. Проверяйте технический контракт по исходнику и запросу, а не только по наличию кнопки рядом с адресом отправителя.

Приёмка заканчивается suppression-проверкой

Отправьте письмо на тестовый адрес, выполните HTML GET и one-click POST на разных подписках, повторите запрос и затем запустите следующую кампанию. Успех: endpoint отвечает 2xx без redirect, состояние меняется один раз, контакт исключён из нужного списка, а транзакционные правила остаются неизменными.

Для разбора приложите обезличенный исходник письма, HTTP status/headers POST-ответа, token hash, subscription category и запись suppression. Полный URL с рабочим token и email получателя публиковать нельзя.

Проверенные источники