гайд · 10.11.26 · 6 мин чтения
Как защитить автоматизацию от повторных событий
Как избежать повторных действий при доставке событий: ключ, состояния и внешний результат. Пример вебхука, одновременные запуски и проверки.

Клиент отправил одну заявку, а в CRM появились две карточки. Или сценарий выполнил действие, не получил ответ и повторил его. Такие случаи нельзя закрыть только проверкой текста сообщения: одинаковое содержание может принадлежать разным реальным обращениям.
Нужно различать входящее событие, рабочую задачу и внешнее действие. Для каждого определить устойчивый идентификатор, состояние и правило повтора. Эту защиту часто называют идемпотентностью: повторный запрос не создаёт ещё один эффект в пределах согласованного действия.
Почему повтор возникает без ошибки клиента
Интеграции могут повторять доставку после сбоя соединения. Например, Telegram Bot API описывает повтор вебхука при ответе с кодом вне диапазона 2xx. Число попыток не заявлено как бесконечное, поэтому рассчитывать на вечное хранение события у отправителя тоже нельзя.
У входящего Update есть update_id. Документация указывает, что идентификатор помогает игнорировать повторные обновления и разбирать нарушенный порядок доставки. Но хранить и проверять его должна принимающая система.
Сам вебхук лишь доставляет событие. Он не гарантирует, что ваша запись в CRM или отправка сообщения произойдёт строго один раз. Для других поставщиков нужно изучить их идентификаторы, повторы и срок хранения отдельно.
Не путайте событие и деловой результат
Один вход может породить несколько действий: создать задачу, подготовить текст, отправить подтверждение. У них разные состояния. Если текст подготовлен, но сообщение не отправлено, повторять всю цепочку целиком не требуется.
Обратная ситуация: одно и то же деловое обращение пришло по двум каналам с разными идентификаторами. Проверка повторной доставки не обнаружит такое смысловое совпадение. Здесь нужен отдельный порядок поиска дублей клиента или заявки.
Не склеивайте все сообщения одного клиента в один ключ. Иначе его второй настоящий запрос будет принят за повтор. Не используйте только текст: две заявки «нужен расчёт» могут быть независимыми.
Практическое требование к подрядчику: показать, что именно считается одним действием и по какому признаку система узнаёт повтор. Это можно включить в задание на внедрение.
Из чего составить ключ
Ключ должен оставаться тем же при повторной попытке того же действия. Если добавлять текущее время каждого запуска, повтор всегда получит новый ключ и защита потеряет смысл.
Пример ниже условный, 501 не относится к реальному сообщению:
Источник: telegram.
Подключение: bot-A.
Входящее событие: update_id=501.
Действие: создать задачу по обращению.
Ключ действия: telegram:bot-A:501:create-request-task.Область подключения нужна, чтобы не смешивать идентификаторы разных источников или аккаунтов. Отдельное название действия позволяет хранить его результат независимо от следующего шага.
Для задачи запишите также версию правил и исходные данные. Но не включайте новую версию программы в ключ автоматически: после обновления то же событие может снова создать карточку. Повторная обработка по новой версии должна быть отдельным разрешённым действием с понятной причиной.
Если отправитель не даёт надёжного идентификатора, зафиксируйте это ограничение. Собственный отпечаток набора полей может помочь, но требует правил для одинаковых законных обращений, изменений данных и срока сравнения. Обещать полное отсутствие дублей на основании одного совпадения нельзя.

Проверка и резервирование ключа должны работать вместе
Схема «посмотреть, что записи нет, потом создать» уязвима к двум одновременным запускам. Оба могут пройти проверку до появления первой записи.
Требование к реализации - согласованное резервирование уникального ключа перед действием. В базе это может опираться на ограничение уникальности и транзакцию; в другой системе нужен её поддерживаемый механизм. Название технологии не доказывает защиту, поэтому поведение проверяют одновременными запросами.
Повторный исполнитель должен получить существующее состояние и действовать по нему. Если первый ещё работает, второй не начинает то же внешнее действие. Если результат сохранён, его можно вернуть вместо нового создания.
| Состояние ключа | Что означает | Как вести повтор |
|---|---|---|
| Принят | Работа сохранена, действие не начато | Продолжить по правилу очереди |
| Выполняется | Один исполнитель занял действие | Не запускать параллельный эффект |
| Завершён | Сохранён идентификатор результата | Использовать известный результат |
| Явно отклонён | Действие не выполнено по проверенной причине | Исправить причину и разрешить попытку |
| Исход неизвестен | Возможно выполнение без подтверждения | Сверить внешний результат |
Для занятого ключа нужен порядок восстановления после падения исполнителя. Истечение срока ожидания само по себе не доказывает, что действие не произошло. Просроченную запись сначала разбирают по состоянию и доступным подтверждениям.
Что делать при потерянном ответе
Самое неудобное окно возникает между внешним действием и сохранением его результата. Внешняя система могла создать объект, а ваша не получила ответ. Локальный журнал не может отменить уже сделанное действие.
Если поставщик поддерживает собственный ключ идемпотентности, изучите его область и срок действия. Если позволяет искать результат по вашему идентификатору, используйте эту связь для сверки. Эти возможности нужно подтвердить документацией конкретного метода.
Когда такой проверки нет, состояние остаётся неизвестным и требует ручного разбора либо заранее принятой стратегии. Нельзя обещать универсальное выполнение «ровно один раз» для любой внешней отправки только за счёт локальной таблицы.
После подтверждения внешнего результата сохраните его идентификатор и завершите ключ. Не помечайте всю задачу успешной раньше, чем выполнены её обязательные шаги. В CRM под свой бизнес такая связь нужна между исходным обращением и созданной карточкой.
Набор проверок перед включением
Проверьте один входящий идентификатор дважды, два разных идентификатора с одинаковым текстом и одновременную доставку одного события. Ожидаемые результаты различаются: повтор не создаёт новый эффект, а независимое событие не теряется.
Добавьте остановку исполнителя до внешнего действия и потерю подтверждения после него. Для последнего случая система должна показать неизвестный исход и доступный путь сверки. Это важнее зелёного статуса при обычном последовательном запуске.
Затем проверьте границу хранения ключей. Срок должен покрывать согласованные повторы и ручные перезапуски. Если старый ключ удалён, повтор за этой границей может стать новым действием. Ограничение нужно описать в инструкции владельца.
Испытания проводите на проверочных объектах без реальных сообщений и платежей. Успешный искусственный пример проверяет конкретный сценарий, а не все возможные сбои. Для процесса с заявками маршрут принятия и результата можно сопоставить с гайдом о нейросотруднике.
Что должно остаться у владельца
Сохраните описание ключа, состояния, ссылку на результат и порядок ручного продолжения. По одной заявке должно быть возможно объяснить, почему система создала объект, использовала существующий или остановилась для сверки.
В отчёте учитывайте повторы доставки отдельно от дублей деловых обращений. Первые показывают работу транспорта и защиты, вторые требуют анализа бизнес-данных. Подготовку такой схемы можно обсудить на странице услуг.
Источник
- Telegram Bot API - разделы Update и setWebhook: идентификатор обновления и повторная доставка.
Документация сверена 28 октября 2026 года. Состояния и ключ действия предложены как проектный шаблон. Реальные вебхуки не вызывались, одновременные запросы к рабочей системе не выполнялись.
Шаги выше можно пройти самому. Если хотите, чтобы под ваш процесс это собрал я, начнём с разбора: посмотрим, где утекают часы, и решим, что автоматизировать первым.