Интеграция с ESP работает, но письма иногда отправляются по два раза. Почему такое бывает и как это обычно исправляют?

Question

Подключили отправку писем через API сервиса рассылок. В целом всё работает, но периодически письма уходят получателю дважды. Ошибка плавающая: то всё нормально, то отдельные письма дублируются. С чем это обычно связано и куда смотреть в первую очередь?

Answer 1

Такая проблема обычно связана не с самим письмом, а с логикой интеграции.

Частые причины дублирования:

• одно и то же событие отправляется в API дважды;
• система повторяет запрос после таймаута;
• нет защиты от повторной отправки;
• письмо запускается сразу из двух мест: например, из CRM и из сайта одновременно;
• интеграция не учитывает, что предыдущий запрос уже был обработан.

Особенно часто дубли появляются там, где нет механизма idempotency — то есть проверки, что событие уже было отправлено и повторно его обрабатывать не нужно.

Что обычно проверяют: логи отправки, повторные вызовы API, обработку ошибок и ретраев, а также сценарии, где одно действие пользователя может запускать несколько процессов.

Если коротко: если письма иногда отправляются по два раза, чаще всего проблема в повторной обработке одного и того же события или в отсутствии защиты от дублей в интеграции.