Обновление бота без потери заявок

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

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

1. Зафиксируйте рабочий путь заявки

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

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

2. Подготовьте копию и способ возврата

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

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

3. Проверьте сохранение входящих событий

У Telegram есть два взаимоисключающих способа получения обновлений: webhook и getUpdates. По документации Bot API, неполученные события не хранятся дольше 24 часов. Эту очередь нельзя считать долгосрочным резервным хранилищем. Для рабочего процесса важно иметь собственное устойчивое сохранение принятых событий и понятную обработку ошибок.

При настройке webhook и его удалении параметр drop_pending_updates удаляет ожидающие обновления, если включён. Не используйте его как обычную операцию очистки при выпуске. У webhook подтверждение приёма нужно связывать с надёжным сохранением события, а не с обещанием обработать его позже в памяти. Для getUpdates момент продвижения offset согласуйте с сохранением и обработкой: неверное подтверждение способно исключить ещё не обработанные обращения из повторного получения.

4. Сделайте повторную обработку безопасной

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

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

5. Сохраните совместимость старых сценариев

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

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

6. Выпускайте проверенную версию по шагам

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

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

7. Проверьте заявки, очередь и возможность отката

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

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

Что согласовать перед следующим обновлением

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

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