Получить 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-условие выборки получателей без данных клиентов. Этого достаточно, чтобы проверить обработчик и гонку очередей.