Задача от клиента
Небольшой компании нужен был бот, который автоматизирует рутину с документами. Менеджеры тратили по 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 — и бот там же.
Заказчик использует бота каждый день. В дальнейшем планирует расширить список документов и подключить шаблоны, чтобы менять текст без разработчика.