Получить webhook о bounce недостаточно. Адрес продолжит попадать в рассылку, если обработчик только сохраняет JSON в журнал или обновляет запись, которую отправитель не читает. Для permanent bounce нужен единый suppression-статус, который проверяется до постановки каждого нового письма в очередь.

Возьмите один `feedbackId` и адрес из `bouncedRecipients`. Найдите событие на входе, результат проверки подписи источника, запись в базе и последующую попытку отправки. Первое отсутствующее звено и есть место ремонта.

Решение зависит от типа отказа

bounceTypeСмыслИзменение получателя
PermanentУстойчивая невозможность доставкиНемедленно запретить новые отправки на адрес
TransientВременная проблема или исчерпанные попытки провайдераСохранить событие и применить ограниченную политику повторов
UndeterminedПровайдер не классифицировал ответНе удалять автоматически; отправить на разбор правила
SuppressedПровайдер уже не пытался доставитьСинхронизировать локальный suppression и прекратить очередь

Не удаляйте контакт целиком: у него могут быть заказы, согласия и история обращений. Меняйте пригодность конкретного email-канала, сохраняя причину, источник и время. Пользователь сможет указать другой адрес, а аудит не потеряется.

Обрабатывайте всех получателей события

Одно уведомление SES может относиться к нескольким bounced recipients. Код, который берёт только первый элемент массива, оставляет остальные адреса активными. Пройдите по всему списку и примените решение отдельно к каждой нормализованной записи.

event_id: <feedbackId + recipient>
recipient_key: sha256(normalized_email)
channel_state: suppressed
reason: permanent_bounce
provider: ses
observed_at: <bounce.timestamp>
source_message_id: <mail.messageId>

Хеш в техническом журнале уменьшает утечку адресов, но основная таблица доставки всё равно должна уметь найти конкретного получателя. Нормализацию определите один раз: пробелы и регистр домена очевидны, а агрессивное изменение local-part может объединить разные почтовые ящики.

Повтор события не должен менять решение второй раз

SNS и очереди могут доставлять уведомления повторно. Стабильный ключ из feedbackId и получателя позволяет сделать обработчик идемпотентным. Повтор сохраняет тот же итог, не создаёт несколько задач очистки и не отправляет серию уведомлений владельцу списка.

Событие может прийти одновременно с новой кампанией. Обновление suppression и выборка получателей должны иметь понятный порядок. Перед фактической отправкой полезна повторная проверка текущего channel_state, потому что список мог быть собран за несколько минут до bounce.

Suppression провайдера и ваша база решают разные задачи

Account-level suppression в SES защищает репутацию отправителя, но не заменяет состояние в приложении. Провайдер может принять API-вызов и не выполнить доставку, а ваша система отметит письмо как отправленное. Локальный фильтр нужен для корректной статистики, пользовательского интерфейса и работы при смене провайдера.

  • Permanent bounce блокирует адрес до подтверждённого исправления.
  • Transient bounce учитывается отдельно и не превращается автоматически в вечный запрет после одного события.
  • Complaint и unsubscribe не смешиваются с техническим bounce, хотя тоже прекращают отправку.
  • Ручное снятие suppression требует причины и повторной проверки владения адресом.

Тест, который обнаруживает разрыв

Используйте тестовый адрес или симулятор провайдера. Отправьте сообщение, получите permanent bounce, повторно доставьте то же событие и запустите формирование следующей кампании. Ожидаемый результат: одна запись аудита, подавленный email-канал и отсутствие новой задачи отправки этому адресу.

Для диагностики подготовьте обезличенное событие, message ID, feedbackId, переход статуса и SQL-условие выборки получателей без данных клиентов. Этого достаточно, чтобы проверить обработчик и гонку очередей.

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