ИНСТРУКЦИЯ · 4 МИН. ЧТЕНИЯ

Telegram-бот без программирования: от BotFather до первого заказа

Как создать Telegram-бота для приёма заказов с AI-агентом: регистрация в BotFather, безопасное хранение токена, правильная постановка задачи и запуск на компьютере.

Как работает Telegram-бот

Telegram-бот похож на обычный аккаунт, но управляет им программа, а не человек. Она получает новые сообщения от серверов Telegram и отправляет ответы: Клиент → Telegram → ваша программа → Telegram → клиент.

Программа общается с Telegram через Bot API. Код пишет AI-агент — Claude Code или Codex. Вы подробно описываете, что должен делать бот, и проверяете результат.

Шаг 1: создайте бота в BotFather

1. Найдите официальный @BotFather с синей отметкой подтверждения в Telegram и нажмите Start. 2. Отправьте /newbot. 3. Укажите имя бота, видимое клиентам, например «Shirin Tortlar». 4. Придумайте username длиной 5–32 символа из латинских букв, цифр и _, обязательно с окончанием bot, например shirin_tortlar_bot. 5. В ответ BotFather пришлёт токен.

Шаг 2: безопасно сохраните токен

Токен — длинная секретная строка. По документации Telegram, любой, у кого есть токен, может управлять ботом. Поэтому: — не отправляйте его другим и не показывайте на скриншотах; — храните в .env, а не в коде; — добавьте .env в .gitignore, чтобы файл не попал на GitHub; — при утечке получите новый токен через /token в BotFather, старый перестанет работать.

Важная привычка: не пишите токен в чате с агентом. Создайте .env и вставьте токен самостоятельно. Агент должен написать код, читающий значение из файла.

Шаг 3: задайте агенту правила проекта

Откройте агента в пустой папке проекта и попросите создать CLAUDE.md для Claude Code или AGENTS.md для Codex. Правила: — общайся со мной на узбекском, я не программист; — токены и секреты читай только из .env, никогда не записывай их в код и не выводи на экран; — бот должен быть без состояния: никаких многошаговых диалогов; — ответы клиентам — на узбекском.

Зачем бот без состояния? На некоторых серверах, например Vercel, программа запускается отдельно для каждого сообщения и не помнит предыдущие. Вместо диалога «Имя?» → «Телефон?» попросите клиента указать всё в одном сообщении. Если предусмотреть это сразу, позже не придётся переделывать бота.

Шаг 4: опишите бота

Дайте агенту точную задачу с целью, ограничениями и критерием готовности. Например:

ЦЕЛЬ: Telegram-бот для приёма заказов. — /start: приветствие и 3 кнопки: «Меню и цены», «Адрес», «Заказать». — «Меню и цены»: 5 товаров с ценами. — «Заказать»: просьба указать имя, телефон и заказ одним сообщением. — Любое сообщение, не являющееся командой, считать заказом: клиенту ответить «Спасибо, скоро свяжемся», владельцу отправить уведомление «Новый заказ». — /myid: вернуть chat ID отправителя. ОГРАНИЧЕНИЯ: без состояния, минимум пакетов, токен нигде не выводить. ГОТОВО, ЕСЛИ: все кнопки и команды работают; без chat ID владельца бот не падает, а показывает предупреждение. Сначала предложи план.

«Сначала предложи план» — важная часть. Агент показывает план, вы читаете и подтверждаете, затем он пишет код и устанавливает нужную библиотеку, например grammY.

Шаг 5: запустите и проверьте

Попросите у агента команду запуска бота и выполните её в отдельном терминале. Отправьте боту /myid в Telegram — получите свой chat ID. Добавьте его в .env и перезапустите бота: изменения .env подхватываются при перезапуске.

Нажмите /start, проверьте кнопки и отправьте заказ. Клиент должен получить благодарность, а вы — отдельное сообщение с заказом. Попросите знакомого тоже проверить заказ.

Как обеспечить работу бота 24/7

На компьютере бот работает через polling: программа постоянно спрашивает Telegram, появились ли сообщения. Если выключить компьютер или закрыть терминал, бот перестанет отвечать.

Для постоянной работы бота размещают на сервере и переключают на webhook: Telegram сам отправляет сообщения программе. Бесплатный Hobby у Vercel по документации предназначен для личных некоммерческих проектов; коммерческому боту потребуется платный тариф.

Публикацию бота, безопасную настройку webhook и работу с базой данных разбираем на живом курсе по вайбкодингу в Zoom.

СЛЕДУЮЩИЙ ШАГ

Превратите знания в практику.

В статье — идеи. На живых занятиях в Zoom вы примените их к своему проекту с помощью объяснений, промптов и практики.