Тип бота
Хватит выпрашивать четвёртый документ по почте
Telegram-бот сбора документов ведёт клиента по чек-листу, принимает фотографии и файлы прямо в переписке, проверяет каждый на читаемость и соответствие типу и напоминает о том, чего ещё нет. Он убирает почтовую погоню за документами. Подтвердить подлинность документа он не может.
Боты сбора документов: цена, сроки и ограничения
- Фиксированная цена
- $4,200 USD
- Срок
- 18 календарных дней с момента старта
- Передача файлов
- Скачивание до 20 МБ, отправка до 50 МБ
- Качество изображений
- Фото сжимаются, документы сохраняются байт в байт
- Сохранность файлов
- Идентификаторы стабильны, сохранность самих файлов не гарантирована
- Подлинность
- Бот не подтвердит, что документ подлинный и не изменён
As of 2025-10-01, Telegram Bot API 13.4
Какую задачу это решает
Онбординг в профессиональных услугах — регистрация компании, оформление виз, открытие счёта, страхование, сделки с недвижимостью — по сути задача сбора документов, переодетая в юридический костюм. Сама консультация занимает час. Получить копию паспорта, Emirates ID, торговую лицензию, договор аренды и подписанное соглашение об услугах — три недели, и три недели уходят ровно потому, что всё это ведётся по электронной почте.
Почта — отвратительная среда для чек-листа. Общего состояния нет, поэтому каждая сторона держит свой мысленный список, и списки расходятся. Вложения приходят в отрыве от контекста, с именем вида IMG_4471. Никто не помнит, было последнее письмо напоминанием или ответом на него. А клиент переживает всё это как нытьё в свой адрес — чем оно, собственно, и является.
Переписка с постоянным чек-листом меняет саму форму взаимодействия. Клиент видит, чего не хватает, не спрашивая; каждая загрузка привязывается к пункту, который она закрывает; а напоминания приходят от бота, а не от человека, которого клиенту неловко подводить. Фирмы, переносящие это в структурированный сценарий, обычно обнаруживают, что дело было вовсе не в готовности клиента — просто никто не мог вспомнить, чего именно ещё нет.
Как идёт разработка
Дело заводится, и чек-лист собирается сам
Ваша система или команда сотрудника создаёт дело с тем набором документов, который требуется для этой услуги. Клиент получает ссылку, открывающую бота уже в контексте его дела.
deep-linkКлиент в любой момент видит, чего не хватает
Одна команда показывает весь список с отметкой по каждому пункту. Снятая неопределённость насчёт остатка — и есть главная причина, по которой такие сценарии закрываются быстрее почтовых.
commandsЗагрузка привязывается к тому пункту, который закрывает
Клиент нажимает на пункт и отправляет фотографию, поэтому файл приходит уже подписанным. Восстанавливать, какое вложение чему соответствовало, — ровно та работа, которая делает сбор по почте дорогим на принимающей стороне.
file-transferКаждая загрузка проверяется до того, как её примут
Изображение это или PDF, хватает ли разрешения для читаемости, есть ли срок действия там, где он должен быть. Отклонить смазанную страницу паспорта сразу — значит сэкономить круг переписки, который иначе занял бы два дня.
file-transferНапоминания идут до прихода документа и на этом прекращаются
По каждому пункту, а не по делу целиком, — поэтому клиенту с одним недостающим документом не напоминают о четырёх уже присланных. Именно это различие делает напоминания терпимыми, а сплошные — отключаемыми.
broadcastЗакрытое дело передаётся дальше со всеми вложениями
Файлы ложатся в вашу систему управления документами или в структурированную папку с именами по делу и пункту, а не по галерее камеры. Тому, кто возьмёт дело следующим, ничего не придётся выводить заново.
webhook
Что Telegram разрешает, а что нет
Бот скачивает файлы размером до 20 МБ и отправляет файлы до 50 МБ.
Фотографии с телефона укладываются в лимит скачивания с большим запасом. Крупный скан с офисного сканера клиента может его превысить — и бот говорит об этом, а не падает молча; разница здесь между мелким неудобством и потерянной неделей.
Telegram сжимает изображения, отправленные как фото, но сохраняет файлы, отправленные как документы.
Сжатый скан паспорта может оказаться нечитаемым ровно там, где это важно. Там, где точность имеет юридическое значение, бот просит прислать документом, а не фото, и объясняет почему.
Идентификаторы файлов, которые выдаёт Telegram, стабильны, но сохранность самих файлов бессрочно не гарантируется.
Всё, что нужно хранить, копируется в ваше собственное хранилище в момент получения. Считать Telegram архивом документов — проблема соответствия требованиям, которая ждёт ближайшей проверки.
Бот не может подтвердить, что документ подлинный и не изменён.
Он проверяет тип, читаемость и наличие. Проверка подлинности остаётся работой человека или профильного KYC-провайдера, и любой процесс, построенный на допущении, что бот что-то проверил, построен неверно.
Telegram не даёт способа принудительно удалить файл из истории чата самого пользователя.
Копия остаётся у клиента бессрочно. Политика хранения распространяется на ваше хранилище, а уведомление о конфиденциальности обязано описывать положение дел таким, какое оно есть.
Когда это не нужно строить
- Вашим документам нужна живая подпись или нотариальное заверение. Бот соберёт фотографию подписанной страницы, а это не одно и то же, и процесс, выстроенный вокруг неё, даст брешь в самый неподходящий момент.
- Вы регулируетесь так, что обязаны работать через конкретного поставщика проверки личности. Собирайте через него; универсальный бот сбора документов перед ним добавляет шаг и вторую копию.
- В ваших делах меньше трёх документов. Накладные расходы на чек-лист превышают ту погоню, которую он убирает.
- Шаблоны чек-листов никто не будет поддерживать. Набор документов, разошедшийся с тем, что на самом деле требует ведомство, даёт уверенно собранные и бесполезные файлы.
На чём это работает
| Компонент | Версия | Зачем |
|---|---|---|
| grammY | 1.45 | Фреймворк бота: работа с файлами и состояние разговора по каждому делу. |
| Cloudflare Workers | current | Среда исполнения; напоминания по пунктам запускает планировщик. |
| Cloudflare R2 | current | Хранилище документов с правилами жизненного цикла под вашу политику хранения. |
| Cloudflare D1 | current | Дела, чек-листы, состояние пунктов и график напоминаний. |
| TypeScript | 5.9 | Строгий режим; шаблоны чек-листов типизированы, поэтому пропущенное имя пункта роняет сборку. |
О чём спрашивают перед стартом
Может ли бот определить, что копия паспорта подлинная?
Нет, и ни один универсальный бот сбора документов этого не может. Он проверяет, что файл нужного типа, читается и содержит то, что запрашивали. Подлинность — вопрос человеческого суждения или профильного KYC-провайдера, и настоящий риск в том, чтобы построить процесс, предполагающий обратное.
Куда в итоге попадают файлы?
В ваше хранилище — Google Drive, SharePoint, Dropbox или R2 — с именами по делу и пункту чек-листа. Они копируются из Telegram при получении, а не остаются там, потому что Telegram не архив документов и при проверке это всплывёт.
Как часто бот напоминает клиенту о недостающем?
С той частотой, которую вы зададите, по каждому недостающему пункту, и прекращает сразу, как пункт закрыт. Напоминание по пункту, а не по делу целиком, — та самая деталь, которая держит напоминания терпимыми: никого не дёргают из-за документов, которые он уже прислал.
Что если клиент прислал фотографию, которую невозможно прочитать?
Она отклоняется сразу и с объяснением, пока документ ещё лежит у клиента перед глазами. Поймать это в тот же момент, а не через три дня на проверке, — здесь и возникает основная экономия времени.
Видят ли сотрудники статус по всем открытым делам?
Да, с разбивкой по тому, чего каждое дело ждёт и сколько уже ждёт. Обычно этот список — первый случай, когда фирма видит, где онбординг реально буксует, и место чаще всего оказывается не тем, о котором думали.
Как это соотносится с обязанностями по защите персональных данных?
Файлы копируются в ваше хранилище под вашу политику хранения, а у клиента остаётся собственная копия в истории чата, и удалить её удалённо нельзя. Уведомление о конфиденциальности должно прямо об этом говорить, а не намекать на контроль, которого у вас нет.