ИНСТРУКЦИЯ · 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.


