PROTOCOL A

← Гайды

гайд · 10.11.26 · 6 мин чтения

Как защитить автоматизацию от повторных событий

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

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

Нужно различать входящее событие, рабочую задачу и внешнее действие. Для каждого определить устойчивый идентификатор, состояние и правило повтора. Эту защиту часто называют идемпотентностью: повторный запрос не создаёт ещё один эффект в пределах согласованного действия.

Почему повтор возникает без ошибки клиента

Интеграции могут повторять доставку после сбоя соединения. Например, Telegram Bot API описывает повтор вебхука при ответе с кодом вне диапазона 2xx. Число попыток не заявлено как бесконечное, поэтому рассчитывать на вечное хранение события у отправителя тоже нельзя.

У входящего Update есть update_id. Документация указывает, что идентификатор помогает игнорировать повторные обновления и разбирать нарушенный порядок доставки. Но хранить и проверять его должна принимающая система.

Сам вебхук лишь доставляет событие. Он не гарантирует, что ваша запись в CRM или отправка сообщения произойдёт строго один раз. Для других поставщиков нужно изучить их идентификаторы, повторы и срок хранения отдельно.

Не путайте событие и деловой результат

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

Обратная ситуация: одно и то же деловое обращение пришло по двум каналам с разными идентификаторами. Проверка повторной доставки не обнаружит такое смысловое совпадение. Здесь нужен отдельный порядок поиска дублей клиента или заявки.

Не склеивайте все сообщения одного клиента в один ключ. Иначе его второй настоящий запрос будет принят за повтор. Не используйте только текст: две заявки «нужен расчёт» могут быть независимыми.

Практическое требование к подрядчику: показать, что именно считается одним действием и по какому признаку система узнаёт повтор. Это можно включить в задание на внедрение.

Из чего составить ключ

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

Пример ниже условный, 501 не относится к реальному сообщению:

text
Источник: telegram.
Подключение: bot-A.
Входящее событие: update_id=501.
Действие: создать задачу по обращению.

Ключ действия: telegram:bot-A:501:create-request-task.

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

Для задачи запишите также версию правил и исходные данные. Но не включайте новую версию программы в ключ автоматически: после обновления то же событие может снова создать карточку. Повторная обработка по новой версии должна быть отдельным разрешённым действием с понятной причиной.

Если отправитель не даёт надёжного идентификатора, зафиксируйте это ограничение. Собственный отпечаток набора полей может помочь, но требует правил для одинаковых законных обращений, изменений данных и срока сравнения. Обещать полное отсутствие дублей на основании одного совпадения нельзя.

Внешний эффект и подтверждение. Условная схема; порядок и ограничения разобраны в тексте.
Внешний эффект и подтверждение. Условная схема; порядок и ограничения разобраны в тексте.

Проверка и резервирование ключа должны работать вместе

Схема «посмотреть, что записи нет, потом создать» уязвима к двум одновременным запускам. Оба могут пройти проверку до появления первой записи.

Требование к реализации - согласованное резервирование уникального ключа перед действием. В базе это может опираться на ограничение уникальности и транзакцию; в другой системе нужен её поддерживаемый механизм. Название технологии не доказывает защиту, поэтому поведение проверяют одновременными запросами.

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

Состояние ключаЧто означаетКак вести повтор
ПринятРабота сохранена, действие не начатоПродолжить по правилу очереди
ВыполняетсяОдин исполнитель занял действиеНе запускать параллельный эффект
ЗавершёнСохранён идентификатор результатаИспользовать известный результат
Явно отклонёнДействие не выполнено по проверенной причинеИсправить причину и разрешить попытку
Исход неизвестенВозможно выполнение без подтвержденияСверить внешний результат

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

Что делать при потерянном ответе

Самое неудобное окно возникает между внешним действием и сохранением его результата. Внешняя система могла создать объект, а ваша не получила ответ. Локальный журнал не может отменить уже сделанное действие.

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

Когда такой проверки нет, состояние остаётся неизвестным и требует ручного разбора либо заранее принятой стратегии. Нельзя обещать универсальное выполнение «ровно один раз» для любой внешней отправки только за счёт локальной таблицы.

После подтверждения внешнего результата сохраните его идентификатор и завершите ключ. Не помечайте всю задачу успешной раньше, чем выполнены её обязательные шаги. В CRM под свой бизнес такая связь нужна между исходным обращением и созданной карточкой.

Набор проверок перед включением

Проверьте один входящий идентификатор дважды, два разных идентификатора с одинаковым текстом и одновременную доставку одного события. Ожидаемые результаты различаются: повтор не создаёт новый эффект, а независимое событие не теряется.

Добавьте остановку исполнителя до внешнего действия и потерю подтверждения после него. Для последнего случая система должна показать неизвестный исход и доступный путь сверки. Это важнее зелёного статуса при обычном последовательном запуске.

Затем проверьте границу хранения ключей. Срок должен покрывать согласованные повторы и ручные перезапуски. Если старый ключ удалён, повтор за этой границей может стать новым действием. Ограничение нужно описать в инструкции владельца.

Испытания проводите на проверочных объектах без реальных сообщений и платежей. Успешный искусственный пример проверяет конкретный сценарий, а не все возможные сбои. Для процесса с заявками маршрут принятия и результата можно сопоставить с гайдом о нейросотруднике.

Что должно остаться у владельца

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

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

Источник

  • Telegram Bot API - разделы Update и setWebhook: идентификатор обновления и повторная доставка.

Документация сверена 28 октября 2026 года. Состояния и ключ действия предложены как проектный шаблон. Реальные вебхуки не вызывались, одновременные запросы к рабочей системе не выполнялись.

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

Начать с разбора