Реалізація управління відписками (Unsubscribe) від email на сайті

Система управління відписками від email-рассилок

Коректне управління відписками — це не тільки ввічливість, але й юридична вимога (GDPR, CAN-SPAM, російський ФЗ-152). Порушення ведуть до блокування домену та штрафів. Потрібна надійна система: одноклік-відписка, управління перевагами та повага до вибору користувача.

Таблиця підписок та переваг

CREATE TABLE email_subscriptions (
  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
  user_id UUID NOT NULL REFERENCES users(id),
  subscription_type VARCHAR(100) NOT NULL,
  -- 'marketing', 'digest', 'product_updates', 'security', 'transactional'
  is_active BOOLEAN NOT NULL DEFAULT true,
  unsubscribed_at TIMESTAMPTZ,
  unsubscribe_reason TEXT,
  created_at TIMESTAMPTZ DEFAULT now(),
  UNIQUE (user_id, subscription_type)
);

CREATE TABLE email_suppression_list (
  email VARCHAR(255) PRIMARY KEY,
  reason VARCHAR(100) NOT NULL,  -- 'unsubscribe', 'bounce', 'complaint'
  created_at TIMESTAMPTZ DEFAULT now()
);

Генерування підписаного посилання відписки

import { createHmac } from 'crypto';

function generateUnsubscribeToken(userId: string, type: string): string {
  const payload = `${userId}:${type}:${Date.now()}`;
  const signature = createHmac('sha256', process.env.UNSUBSCRIBE_SECRET!)
    .update(payload)
    .digest('hex');
  return Buffer.from(`${payload}:${signature}`).toString('base64url');
}

function generateUnsubscribeUrl(userId: string, type: string = 'all'): string {
  const token = generateUnsubscribeToken(userId, type);
  return `https://app.example.com/unsubscribe/${token}`;
}

Обробник відписки

// GET /unsubscribe/:token — посилання в листі (one-click preview)
app.get('/unsubscribe/:token', async (req, res) => {
  const decoded = parseUnsubscribeToken(req.params.token);
  if (!decoded) return res.status(400).render('unsubscribe-invalid');

  // Показати сторінку підтвердження / управління перевагами
  res.render('unsubscribe', {
    userId: decoded.userId,
    type: decoded.type,
    token: req.params.token,
  });
});

// POST /unsubscribe/:token — підтвердження відписки
app.post('/unsubscribe/:token', async (req, res) => {
  const decoded = parseUnsubscribeToken(req.params.token);
  if (!decoded) return res.status(400).json({ error: 'Invalid token' });

  const { type, reason } = req.body;

  if (type === 'all') {
    // Відписати від всіх маркетингових рассилок
    await db.query(
      `UPDATE email_subscriptions
       SET is_active = false, unsubscribed_at = now(), unsubscribe_reason = $1
       WHERE user_id = $2 AND subscription_type != 'transactional'`,
      [reason, decoded.userId]
    );

    // Додати до списку придушення
    const user = await db.users.findById(decoded.userId);
    await db.query(
      `INSERT INTO email_suppression_list (email, reason) VALUES ($1, 'unsubscribe')
       ON CONFLICT (email) DO NOTHING`,
      [user.email]
    );
  } else {
    // Відписати від конкретного типу
    await db.query(
      `UPDATE email_subscriptions
       SET is_active = false, unsubscribed_at = now()
       WHERE user_id = $1 AND subscription_type = $2`,
      [decoded.userId, type]
    );
  }

  res.json({ ok: true });
});

Заголовок List-Unsubscribe (RFC 8058)

Gmail та Outlook показують кнопку «Відписатися» в інтерфейсі, якщо лист містить заголовок List-Unsubscribe. Це обов'язково для відправників > 5 000 листів на день з лютого 2024:

await sendEmail({
  to: user.email,
  subject: 'Наш дайджест',
  html: emailHtml,
  headers: {
    // RFC 2369 — mailto для поштових клієнтів
    'List-Unsubscribe': `<mailto:[email protected]?subject=unsub-${userId}>, <https://app.example.com/unsubscribe/${token}>`,
    // RFC 8058 — POST-запит без відкриття браузера (Gmail one-click)
    'List-Unsubscribe-Post': 'List-Unsubscribe=One-Click',
  },
});

// POST /api/email/list-unsubscribe — обробник One-Click
app.post('/api/email/list-unsubscribe', async (req, res) => {
  const { 'list-unsubscribe' }: { 'list-unsubscribe': string } = req.body;
  // Поле = 'One-Click' — просто обробити
  // Ідентифікація користувача — через X-Token header або token в URL
  res.status(200).end();
});

Сторінка управління перевагами

Замість повної відписки — пропонувати користувачам вибрати типи рассилок:

Тривалість

Система відписок з одноклік-посиланням, заголовком List-Unsubscribe, сторінкою управління перевагами займає 2–3 дні.