Iusuf Vozerkhanov › yusufvozerkhanov
Рейтинг
202
№ 6 772 в каталоге
Отзывы
0
Профессионализм
-/10
Коммуникация
- /10
На сайте с
2026 года

Telegram-бот: автозаполнение и генерация документов (справки, договоры, счета)

Используемые навыки API Python Веб-разработка Чат-боты

Описание

Задача от клиента

Небольшой компании нужен был бот, который автоматизирует рутину с документами. Менеджеры тратили по 10–15 минут на каждую справку или договор: открывали шаблон в Word, вручную вбивали ФИО, должность, компанию, сумму, сроки, потом сохраняли и отправляли клиенту. При потоке в 20–30 документов в день это превращалось в часы работы и постоянные опечатки.

Цель: сделать Telegram-бота, который сам спрашивает нужные данные и выдаёт готовый документ. Без Word, без ручного копирования, без ошибок.

Как реализовано

Бот написан на Python (aiogram 3). Взаимодействие с пользователем построено через FSM — пошаговый диалог: бот задаёт вопрос, получает ответ, сохраняет его и переходит к следующему шагу.

Логика:

Пользователь пишет /doc.

Бот показывает инлайн-меню: «Справка» или «Договор».

Для справки спрашивает ФИО, должность, компанию.

Для договора — ФИО, услугу, сумму, срок.

Проверяет ввод: цифры в имени или пустые строки отсекаются.

Генерирует .docx через python-docx — заголовок, текст, поля для подписи.

Отправляет готовый файл пользователю.

Результат

Заказчик получил бота, который заменяет ручную работу менеджера. Один документ создаётся за 30 секунд вместо 10–15 минут. Ошибки в данных исключены — бот проверяет ввод на каждом шаге. Два типа документа с возможностью лёгкого добавления новых шаблонов.

Технические детали
• Python, aiogram 3, FSM, python-docx, io.BytesIO.
• Файл собирается в памяти и сразу отправляется в Telegram — без сохранения на диск.
• Проверка ввода: длина, отсутствие цифр в текстовых полях, число в сумме.
• После каждого документа состояние очищается — можно начинать заново.
• Токены — в .env, код без хардкода секретов.

Что можно расширить
— Добавить счета и акты.
— Подключить шаблоны через docxtpl, чтобы менять текст без правки кода.
— Сохранять историю выданных документов в SQLite.

Срок выполнения — 3 дня. Заказчик получил рабочего бота, инструкцию по запуску и помощь с развёртыванием.

Решение

Решение

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

Проектирование
Разбил задачу на этапы:

Меню выбора документа через инлайн-кнопки.

Пошаговый сбор данных через FSM (aiogram 3).

Генерация .docx через python-docx.

Отправка файла в чат.

Заранее решил, что документ будет собираться в памяти (io.BytesIO), без сохранения на диск — это безопаснее и быстрее.

Реализация
• Настроил FSM: отдельные состояния для ФИО, должности, компании (для справки) и для ФИО, услуги, суммы, срока (для договора).
• Добавил проверки ввода на каждом шаге: имя не должно содержать цифр, сумма — только число, пустые строки отсекаются.
• Написал две функции генерации — generate_spravka и generate_dogovor. Каждая создаёт документ с заголовком, текстом и полями для подписи.
• Сделал меню выбора через InlineKeyboardMarkup — пользователь видит два варианта, не вводит команды вручную.
• После отправки документа состояние очищается — можно сразу начинать новый.

Тестирование
Проверил все сценарии:
— справка: ФИО → должность → компания → файл;
— договор: ФИО → услуга → сумма → срок → файл;
— неверный ввод: цифры в имени, пустая строка, буквы в сумме — бот просит повторить;
— повторный запуск: состояние чистое, можно создавать новый документ.

Что получилось
Бот работает автономно: пользователь пишет /doc, выбирает тип, отвечает на вопросы и получает готовый .docx. Менеджеру больше не нужно открывать Word и вручную заполнять шаблон. Время на документ — 30 секунд вместо 10–15 минут.

Дополнительно
— Токены вынесены в .env, код без хардкода.
— Обработал ошибки генерации и отправки: если файл не создался или не отправился, пользователь видит сообщение, а не «молчание».
— Подготовил инструкцию по запуску и帮助 с развёртыванием.

Итог
Заказчик получил не просто скрипт, а готовый инструмент с понятным интерфейсом, проверками и защитой от ошибок. В дальнейшем можно добавить новые шаблоны (счёт, акт) и подключить docxtpl для гибкой настройки без правки кода.

Результат

Результат

Заказчик получил готового Telegram-бота, который автоматизирует создание документов. Бот работает автономно, без участия разработчика: пользователь открывает чат, выбирает тип документа и получает готовый файл .docx за 30 секунд.

Что умеет бот
— Создавать справку: ФИО, должность, компания — на выходе документ с полями для подписи.
— Создавать договор оказания услуг: ФИО заказчика, услуга, сумма, срок — на выходе готовый договор.
— Проверять ввод на каждом шаге: цифры в имени, пустые строки, буквы в сумме — отсекаются, бот просит повторить.
— Показывать меню выбора через инлайн-кнопки — пользователю не нужно запоминать команды.
— Отправлять файл прямо в чат, без сохранения на диск.

Как применяют на практике
Менеджеры используют бота для ежедневной работы с документами. Раньше каждый документ занимал 10–15 минут: открыть Word, найти шаблон, вручную вбить данные, сохранить, отправить клиенту. Теперь — 30 секунд и одно сообщение в Telegram. При потоке 20–30 документов в день экономия — 4–6 часов работы менеджера.

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

Что получил заказчик
— Рабочий бот, развёрнутый на сервере.
— Исходный код с комментариями.
— Инструкцию по запуску и добавлению новых шаблонов.
— Помощь с первым запуском.
— Бесплатные правки в течение 2–3 дней после сдачи.

Как можно расширить
— Добавить новые типы документов: счёт, акт, коммерческое предложение.
— Подключить docxtpl — чтобы менять текст шаблона без правки кода.
— Сохранять историю выданных документов в SQLite: кто, когда, какой документ создал.
— Добавить экспорт в PDF для клиентов, которым нужен именно этот формат.

Почему это работает
Бот решает конкретную боль: рутина с документами отнимает время у менеджеров, а ошибки в данных портят репутацию компании. Автоматизация через Telegram — самый простой путь: не нужно ставить софт, не нужно учить новый интерфейс. Менеджер уже в Telegram — и бот там же.

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

Оценили проект:

Другие проекты

Все проекты →
Веб-разработка и IT Телеграмм-бот который ишет информацию об ip
Телеграмм-бот который ишет информацию об ip
27