Сделаем Telegram-бота, который выдаёт человеку полезный файл. Например, памятку, список вопросов перед консультацией или описание твоих услуг. Начнём с готового примера: писать программу самому не придётся.
Что бот умеет
Человек открывает бота, нажимает «Запустить» и получает подсказку. По команде /material бот отправляет файл. Ещё он умеет сохранять короткое описание задачи и удалять его по просьбе человека.
Внутри этого примера нет нейросети, которая придумывает ответы. ИИ помогает создать или изменить программу, а сам бот выполняет понятные команды. Для выдачи памятки этого достаточно.
Что понадобится
- Компьютер с Windows 10 или 11 и интернетом. Шаги запуска ниже написаны для Windows.
- Твой Telegram и готовый архив из этой статьи.
- Python — бесплатная программа, которая запускает нашего бота.
Отдельной платы за запросы к нейросети в этом примере нет. Пока бот работает на твоём компьютере, окно запуска нужно держать открытым. Постоянная работа на отдельном сервере потребует настройки и может стоить денег.
Мы проверили программу без отправки сообщений в Telegram. После подключения своего бота нужно отдельно проверить, что сообщение и файл действительно приходят.
Шаг 1. Скачай и распакуй бота
- Скачай готового бота в архиве.
- Нажми по архиву правой кнопкой мыши и выбери «Извлечь всё».
- Открой получившуюся папку. В ней должны быть bot.py и material.md.
Первый файл запускает бота. Второй — памятка, которую бот будет выдавать. Пока не переименовывай их.
Шаг 2. Подготовь компьютер
Если Python уже установлен, переходи к проверке ниже. Если нет, установи его с официальной страницы Python для Windows. Нужна версия 3.10 или новее. Актуальный порядок установки есть в официальной справке.
Открой папку с файлами бота. В верхней строке Проводника, где показан адрес папки, напиши powershell и нажми Enter. Откроется окно для команд. Это способ сказать компьютеру, какой файл запустить.
Вставь эту строку и нажми Enter:
python --version
Что должно появиться: надпись Python и номер версии. Если команда не найдена, попробуй py --version. Если сработал вариант py, во всех следующих командах заменяй слово python на py.
Если оба варианта не работают, вернись к установке Python. Остальные шаги пока выполнять не нужно.
Шаг 3. Проверь готовую программу
В том же окне вставь строку и нажми Enter:
python bot.py --self-test
Что должно появиться: несколько строк, а в конце строка, начинающаяся с PASS. Это означает, что встроенная проверка прошла. Она не подключается к твоему Telegram и никому не пишет.
Это отчёт проверки, а не окно Telegram. Английское uncertain здесь — часть специально созданной проверки сбоя; при итоговом PASS пугаться его не нужно.
Если написано, что bot.py не найден, закрой окно и открой его заново из папки, где лежит файл. Если другая ошибка — сохрани её текст и попроси помочь с этим шагом. Секретный ключ пока нигде не нужен.
Шаг 4. Создай бота в Telegram
- Открой официального BotFather. Это сервис Telegram для создания ботов.
- Отправь ему /newbot.
- В ответ на первый вопрос напиши название своего бота.
- Затем придумай свободное имя на латинице с окончанием bot. Если имя занято, BotFather попросит другое.
- После создания сохрани токен — длинную строку, которая даёт управление ботом. Относись к ней как к паролю.
Создай нового учебного бота. Не используй бота, который уже работает у тебя в другом сервисе: две программы могут мешать друг другу. Официальная инструкция Telegram описывает создание и получение ключа.
Шаг 5. Включи своего бота
В окне PowerShell, которое открывал раньше, введи:
python bot.py
Появится просьба Telegram token (hidden):. Вставь ключ, который выдал BotFather, и нажми Enter. Символы могут не показываться — это специально, чтобы ключ нельзя было подсмотреть.
Что должно появиться: строка Running @… с именем твоего бота. Оставь окно открытым. Если появилась ошибка, сравни её с таблицей ниже. Не отправляй никому снимок с ключом.
Шаг 6. Проверь бота как обычный пользователь
Перейди по ссылке на своего бота из сообщения BotFather. Нажми «Запустить» или отправь /start. Дальше отправляй по одному:
| Что отправить в Telegram | Что должно произойти |
|---|---|
| /start | Бот объяснит, что умеет |
| /material | Пришлёт файл с памяткой |
| /task Подготовка недельного отчёта | Подтвердит сохранение задачи |
| /task | Подскажет, как написать задачу |
| /forget | Подтвердит удаление сохранённых задач |
Открой полученный файл. Проверь, что внутри памятка, а не пустой документ. Для пробы достаточно вымышленной задачи: клиентские данные не нужны.
Шаг 7. Замени памятку на свою
Найди material.md в папке бота. Открой через «Открыть с помощью → Блокнот». Замени текст своим, сохрани файл под прежним именем. Затем снова отправь боту /material и открой полученную памятку.
Сначала используй обычный текст. Если хочешь выдавать PDF, нужно изменить программу: простого переименования файла недостаточно. Задание для ИИ можно написать так:
У меня есть работающий бот. Он выдаёт material.md. Хочу вместо него выдавать мой PDF. Объясни, что изменить, верни полный обновлённый bot.py и добавь проверку, что файл существует. Сохрани остальные команды. Секретный ключ в программу не записывай.
Прикрепи файл программы, но не ключ от бота. Обновлённую версию сначала проверь на учебном боте по шагам 3 и 6.
Если бот молчит
| Что случилось | Что попробовать |
|---|---|
| Не найден bot.py | Открой PowerShell из папки с распакованными файлами |
| Не найдена команда python | Проверь вариант py и установку Python |
| Telegram connection failed | Проверь ключ, интернет и что этот бот не запущен ещё где-то |
| Webhook is active | Возьми нового бота: этот уже подключён к другой программе |
| Another copy is running | Закрой свою предыдущую копию бота; не запускай две одновременно |
| Файл не приходит | Проверь наличие material.md рядом с bot.py |
| Бот замолчал после закрытия окна | Окно было программой бота; запусти её снова |
Чтобы остановить бота, нажми Ctrl+C в окне PowerShell. Чтобы включить снова, повтори шаг 5.
Как оставить бота работать круглосуточно
Для постоянной работы программу размещают на сервере — компьютере, который остаётся включённым. Это отдельный шаг. Передай исполнителю файлы и попроси настроить автоматический запуск, восстановление после сбоя и сохранение задач.
Не приглашай клиентов, пока не проверены выдача файла, удаление задач и работа после перезапуска. Этот пример не принимает оплату и не связывает человека с покупкой в клубе: такие возможности добавляются отдельно.
Следующий разбор: как поставить задачу ИИ-помощнику.
Дополнительно для настройки постоянной работы
Этот блок можно передать исполнителю. Для запуска на своём компьютере его читать не обязательно.