Как создать бота в Телеграм: от @BotFather до первого сообщения

Обновлено: 29 октября 2026 г. · 8 мин чтения

Чтобы создать бота в Телеграм, напишите @BotFather команду /newbot, задайте имя и username с окончанием bot — в ответ придёт токен, с которым бота уже можно вызывать через Bot API. Регистрация занимает пару минут и ничего не стоит. Ниже — пошаговая инструкция: проверим токен через getMe, узнаем chat id, отправим первое сообщение на curl и Python, настроим команды и разберём, куда двигаться дальше.

Что понадобится

• аккаунт Telegram — подойдёт мобильное, десктопное или веб-приложение;
• для первых запросов — терминал с curl или Python 3 с библиотекой requests (pip install requests). Можно обойтись и без них: все проверки ниже выполняются в браузере в Bot API Tester;
• сервер понадобится позже, когда бот должен будет работать круглосуточно. Для разработки хватит своего компьютера.

Шаг 1. Создайте бота через BotFather

@BotFather — официальный бот Telegram, через который создают и настраивают всех остальных ботов. Ищите именно @BotFather с отметкой верификации: у подделок бывают похожие имена.

1. Откройте @BotFather и отправьте команду /newbot.
2. Введите имя (name) — оно показывается в профиле и списке чатов. Можно по-русски и с пробелами, позже его меняют командой /setname.
3. Введите username — 5–32 символа: латинские буквы, цифры и подчёркивания, в конце обязательно bot, например tetris_bot или TetrisBot. Регистр не важен. Если имя занято, BotFather попросит придумать другое.
4. BotFather пришлёт сообщение со ссылкой на бота вида t.me/your_bot и токеном для доступа к HTTP API.

Выбирайте username внимательно: в отличие от имени, по документации его нельзя изменить позже. Те же действия доступны в Mini App @BotFather — функции там те же, только через кнопки.

Шаг 2. Сохраните токен

Токен выглядит как 123456789:AAEexampleTokenReplaceWithYours: число, двоеточие и секретная строка. Это одновременно логин и пароль бота — любой, у кого он есть, полностью управляет ботом. Поэтому:

• не публикуйте токен в чатах, на скриншотах и в публичных репозиториях;
• храните его в переменной окружения, например BOT_TOKEN, а не в коде;
• если токен утёк, сразу отзовите его в @BotFather.

Где найти токен позже, как его проверить и отозвать — в отдельном гайде как получить токен бота.

Шаг 3. Проверьте токен через getMe

Метод getMe не требует параметров и нужен ровно для этого — проверить токен. Адрес любого метода выглядит как https://api.telegram.org/bot<token>/ИМЯ_МЕТОДА, причём слово bot пишется слитно с токеном.

export BOT_TOKEN="123456789:AAEexampleTokenReplaceWithYours"

curl -s "https://api.telegram.org/bot$BOT_TOKEN/getMe"

Если токен рабочий, придёт "ok": true, а в result — объект бота: id, first_name, username и флаги вроде can_join_groups и can_read_all_group_messages. Ответ 401 Unauthorized означает, что токен скопирован с ошибкой или уже отозван, а 404 Not Found — что адрес собран неверно: чаще всего забыли bot перед токеном.

Без терминала: откройте getMe в Bot API Tester, вставьте токен и нажмите Ctrl+Enter. Токен остаётся в localStorage вашего браузера, а запросы уходят напрямую на api.telegram.org.

Шаг 4. Узнайте chat id и отправьте первое сообщение

Бот не может написать человеку первым: сначала пользователь должен открыть чат с ботом и нажать «Запустить» (Start) — клиент отправит команду /start. Сделайте это со своего аккаунта, а затем заберите апдейты методом getUpdates:

curl -s "https://api.telegram.org/bot$BOT_TOKEN/getUpdates"

{
  "ok": true,
  "result": [
    {
      "update_id": 851234567,
      "message": {
        "message_id": 1,
        "from": {"id": 123456789, "is_bot": false, "first_name": "Иван", "language_code": "ru"},
        "chat": {"id": 123456789, "first_name": "Иван", "type": "private"},
        "date": 1793275200,
        "text": "/start"
      }
    }
  ]
}

Нужное значение — message.chat.id. В личном чате оно совпадает с id пользователя в from.id. Если result пустой, напишите боту ещё раз: апдейты хранятся не дольше 24 часов. Как найти id группы или канала, разобрано в гайде как узнать chat id.

Теперь отправим сообщение методом sendMessage:

curl -s -X POST "https://api.telegram.org/bot$BOT_TOKEN/sendMessage" \
  -H "Content-Type: application/json" \
  -d '{"chat_id": 123456789, "text": "Привет! Это мой первый бот"}'

То же на Python, а заодно простейший эхо-бот на long polling — он отвечает на каждое текстовое сообщение:

import os
import requests

TOKEN = os.environ.get("BOT_TOKEN", "123456789:AAEexampleTokenReplaceWithYours")
API = f"https://api.telegram.org/bot{TOKEN}"


def call(method, **params):
    data = requests.post(f"{API}/{method}", json=params, timeout=40).json()
    if not data["ok"]:
        raise RuntimeError(f"{method}: {data['error_code']} {data['description']}")
    return data["result"]


call("sendMessage", chat_id=123456789, text="Привет из Python!")

offset = 0
while True:
    # long polling: Telegram держит запрос до 30 секунд, пока не появятся апдейты
    for update in call("getUpdates", offset=offset, timeout=30):
        offset = update["update_id"] + 1  # подтверждаем полученные апдейты
        message = update.get("message")
        if message and "text" in message:
            call("sendMessage", chat_id=message["chat"]["id"], text="Вы написали: " + message["text"])

Запустите скрипт (BOT_TOKEN=... python bot.py) и напишите боту — он ответит. Параметр offset обязателен: без него getUpdates будет снова и снова возвращать одни и те же апдейты. Форматирование, кнопки и ошибки отправки подробно разобраны в гайде как отправить сообщение через бота.

Шаг 5. Описание и команды бота

Необязательный, но полезный шаг: пользователь сразу поймёт, что умеет бот. Основные команды @BotFather:

• /setdescription — описание до 512 символов. Его видно в пустом чате с ботом ещё до нажатия «Запустить»;
• /setabouttext — короткий текст до 120 символов для профиля бота. Он же отправляется вместе со ссылкой, когда бота кому-то пересылают;
• /setuserpic — аватарка;
• /setcommands — список команд, который появляется при вводе / и в меню бота.

Команды удобнее задавать из кода методом setMyCommands: так список хранится в репозитории вместе с ботом.

curl -s -X POST "https://api.telegram.org/bot$BOT_TOKEN/setMyCommands" \
  -H "Content-Type: application/json" \
  -d '{"commands": [
        {"command": "start", "description": "Запустить бота"},
        {"command": "help", "description": "Что умеет бот"},
        {"command": "settings", "description": "Настройки"}
      ]}'

Ограничения: команда — 1–32 символа (строчные латинские буквы, цифры и подчёркивания), описание — 1–256 символов, всего не больше 100 команд. Параметры scope и language_code позволяют показывать разные списки в группах, администраторам и пользователям с разными языками. Telegram просит все боты поддерживать /start и /help, а при наличии настроек — /settings. Описания тоже задаются из кода: методы setMyDescription и setMyShortDescription.

Если что-то не работает

Что дальше: polling, вебхук, библиотеки и Mini Apps

Polling или вебхук. Эхо-бот выше работает на long polling: он сам забирает апдейты через getUpdates, поэтому запускается где угодно, даже за NAT. В продакшене часто выбирают вебхук — Telegram сам присылает апдейты на ваш HTTPS-адрес. Одновременно оба способа не работают. Настройка описана в гайде вебхук для Telegram-бота.

Библиотеки. Работать с HTTP вручную полезно для понимания, но реального бота проще писать на фреймворке: он возьмёт на себя polling, роутинг команд, клавиатуры и состояние диалогов.

• Python: aiogram (асинхронный, очень популярен в русскоязычном сообществе), python-telegram-bot, pyTelegramBotAPI;
• Node.js: grammY и Telegraf;
• Go: telebot и go-telegram-bot-api.

Mini Apps. Если интерфейс не помещается в сообщения и кнопки, бот может открывать веб-приложение прямо внутри Telegram. Как его сделать и отладить, рассказано в гайде тестирование Mini App, а попробовать Telegram.WebApp API можно в Mini App Tester. Все методы Bot API с параметрами и примерами собраны в справочнике методов.