Клиент отправил несколько файлов, бот ответил «Всё получено», а сотрудник обнаружил, что один документ относится к другой заявке и в другом не хватает страницы. Формально сообщения пришли, но комплект ещё не готов к работе.
Полезная автоматизация показывает, какие материалы нужны, что уже загружено и что проверено человеком. Она не приравнивает наличие файла к его пригодности и не выдаёт юридическое заключение по названию документа. До разработки согласуйте именно эти различия.
Не начинайте с команды «Пришлите документы». Создайте перечень типов материалов с понятным назначением. Для каждого укажите, зачем он нужен, кто предоставляет, когда обязателен и кто подтверждает пригодность.
Один список может не подходить всем. Новому партнёру нужны одни сведения, действующему при обновлении данных — другие. Если обязательность зависит от ответа, бот должен объяснять связь: «Для выбранного варианта нужен дополнительный материал».
Согласуйте источник требований. Менять перечень через случайные сообщения менеджера опасно: клиент будет видеть старые условия, а проверяющий — новый список. Сохраните версию комплекта в конкретной заявке и определите порядок перехода на новые требования.
Эти правила следует включить в техническое задание на Telegram-бота, а не оставлять на этап наполнения кнопок.
Комплектность: у каждого обязательного пункта есть связанный материал или согласованное исключение. Техническая пригодность: файл открывается и соответствует разрешённому формату. Содержательная проверка: уполномоченный сотрудник подтвердил, что материал подходит для конкретной задачи.
Автоматически можно выявить часть технических ошибок и отсутствие обязательного вложения. Но файл с правильным расширением может содержать не тот документ, а распознанный текст — ошибочные значения. Поэтому фраза «Комплект загружен» не должна превращаться в «Документы утверждены».
Если применяется распознавание текста или AI, обозначьте роль инструмента: подсказка для проверки, извлечение реквизитов или предварительная классификация. Сотрудник должен видеть исходник и происхождение извлечённых данных. Спорные совпадения не следует разрешать автоматически ради красивого статуса.
Общего зелёного индикатора недостаточно. Покажите список материалов с текущим состоянием и доступным действием. Клиенту не нужно угадывать, какой из отправленных файлов ещё рассматривается.
Состояния могут быть другими, но смысл должен сохраняться. «Отклонён» без объяснения не помогает собрать комплект. Лучше: «Нужна полная версия документа: в полученном файле отсутствует указанное приложение» — если это действительно проверил сотрудник.
Один человек может вести несколько проектов. Перед загрузкой покажите, какой комплект открыт. Сохраняйте идентификаторы клиента, заявки, типа документа и версии файла. Не определяйте принадлежность только по отображаемому имени в Telegram.
Если пользователь отправил свободное сообщение с несколькими вложениями, предложите распределить их по пунктам или передайте на разбор. Не назначайте все файлы первому незаполненному пункту без подтверждения.
При повторной доставке одного события нельзя создавать новую версию того же файла бесконечно. При этом осознанная замена должна оставаться доступной. Правила отличия повтора от новой загрузки фиксируются в реализации и проверяются на приёмке.
После загрузки новой версии старое одобрение не должно автоматически подтверждать новое содержимое. Покажите, что материал заменён и потребуется проверка. Сотруднику полезно видеть, какая версия была принята раньше и почему появилась следующая.
Не удаляйте безусловно прежние файлы ради аккуратного интерфейса. Сроки и основания хранения определяет бизнес для своего процесса и применимых требований. Одновременно не храните бессрочно все дубликаты без необходимости.
Если изменился сам перечень, объясните клиенту новые пункты. Уже принятое по прежним правилам не следует молча объявлять неполным. Назначьте ответственного за такие переходы и сохраните историю решений.
Представим, что поставщик собирает материалы для нового товарного каталога. Пример вымышленный и показывает процесс, а не фактические требования агентства.
«Готов к работе над каталогом» не означает «Каталог утверждён» или «Товар сертифицирован». Название итогового состояния должно отражать реальное действие процесса.
Согласуйте необходимые форматы, размер, количество и допустимую обработку. Возможности загрузки и скачивания нужно проверить для выбранной конфигурации бота и хранилища. Не переносите случайный лимит одной системы на все варианты Telegram.
Рекомендации OWASP по загрузке файлов объясняют необходимость нескольких защитных мер. Проверка расширения сама по себе недостаточна; важны также доступ, хранение и обработка содержимого.
Не пересылайте весь комплект в общий чат сотрудников. Для уведомления часто достаточно идентификатора и ссылки на интерфейс с проверкой прав. Подробности разделения данных есть в статье о персональных данных в Telegram-боте.
Не показывайте технический адрес скачивания, если он содержит секретный ключ. Пользовательские ссылки и диагностические журналы не должны раскрывать токены интеграции.
Поступление файла и принятие в работу — разные события. Назначьте проверяющего, срок реакции по реальному регламенту и замену при отсутствии. Если два сотрудника открыли пункт, изменения не должны незаметно перезаписывать друг друга.
Комментарий связывается с конкретной версией. Клиенту показываются действие и объяснение; внутренние обсуждения остаются в предусмотренном рабочем месте. Принципы сохранения контекста рассмотрены в материале о передаче диалога менеджеру.
После сбоя система должна отличать принятый файл от неудавшейся попытки. Если обработка приостановлена, сообщайте о текущем состоянии и сохраняйте задачу для восстановления. Порядок сопровождения можно согласовать по регламенту поддержки бота.
Не всегда один файл соответствует одному пункту. Клиент может прислать общий PDF с несколькими приложениями или один документ отдельными сканами. Согласуйте, допускается ли такая подача и кто связывает страницы с требованиями. Без этого бот будет просить уже предоставленное повторно.
Если один исходник закрывает несколько пунктов, храните понятную связь с общей версией. Замена исходника может затронуть все эти пункты. Система должна показать проверяющему, что прежнее подтверждение требует пересмотра, вместо сохранения противоречивых отметок.
Условный пример: общий файл содержит описание проекта и техническое приложение. Сотрудник подтверждает описание, но просит исправить приложение. После загрузки полного нового файла нужно определить, изменилось ли также описание. Не объявляйте его автоматически новым или прежним без предусмотренной проверки.
Архив не следует считать полным комплектом только по наличию файла. Если архивы нужны, отдельно определите распаковку, допустимое содержимое и обработку неподходящих вложений. Клиенту удобнее заранее увидеть принимаемые способы, чем узнавать ограничения после длительной загрузки.
Для срока действия документа используйте только утверждённые правила процесса. Бот может напомнить о пересмотре по заданной дате, но дата сама не делает юридическое заключение. Различайте окончание рабочего срока пересмотра, замену версии и решение специалиста о пригодности.
Проверяйте понятность итоговой сводки: клиент должен видеть, что реально осталось сделать, а не количество сообщений, которое система от него получила.
Для каждого типа документа заполните: название, назначение, условие обязательности, инструкцию, разрешённые форматы, место хранения, роль проверяющего, причины возврата и правила замены. Для всего комплекта определите итоговую готовность и следующий этап.
Процесс можно обсудить в рамках разработки Telegram-ботов и Mini Apps. В коммерческом предложении отдельно согласуйте хранение, рабочее место проверяющего и интеграцию с системой учёта. Требования к содержанию документов и юридические решения подтверждает заказчик с компетентными специалистами.