Регистрация бота в BotFather и получение токена

Привет! Хочешь создать своего Telegram-бота? Всё начинается с регистрации через BotFather — официального «отца всех ботов» в Telegram. Это самый важный шаг, без которого невозможно начать разработку.

В этой статье мы разберём:

• Что такое BotFather и зачем он нужен
• Как зарегистрировать бота
• Как выбрать имя и username
• Как получить и сохранить API токен

Что нужно знать перед началом

Для этого урока тебе понадобится:

• Установленный Telegram (любая версия: мобильная, десктопная или веб)
• Зарегистрированный аккаунт в Telegram

Совет: Рекомендуется использовать мобильную версию Telegram — она наиболее стабильна для взаимодействия с BotFather

Основная часть

Что такое BotFather

BotFather — это официальный бот Telegram, который создаёт и управляет другими ботами . Все боты в Telegram создаются только через него. Никаких других способов нет.

BotFather выполняет три основные функции :

• Создание — регистрация новых ботов
• Управление — настройка имени, описания, аватарки
• Безопасность — выдача и сброс токенов

Как найти BotFather

1. Открой Telegram
2. В поиске введи @BotFather 
3. Выбери аккаунт с синей галочкой — это официальный бот

Совет: Можно также открыть прямую ссылку: https://t.me/BotFather 

Начало работы с BotFather

1. Нажми кнопку Start внизу экрана
2. Появится список доступных команд
3. Отправь команду /newbot 

/newbot

Выбор имени бота

После команды /newbot BotFather попросит ввести имя бота — это название, которое будут видеть пользователи.

Правила:

• Можно использовать любые символы, включая русские
• Ограничение — до 32 символов 

Примеры хороших имён:

• Бот для задач
• My Shop Assistant
• Заказчик Support 

# Пример ввода
Бот для задач

Выбор username бота

Следующий шаг — выбор username (уникального идентификатора). Это техническое имя бота, по которому его будут находить в Telegram .

Обязательные правила:

• Только латиница (a-z)
• Цифры (0-9) разрешены
• Символ подчёркивания _ разрешён
• Имя обязательно должно заканчиваться на bot (регистр не важен) 
• Длина: 5–32 символа 

Примеры правильных username:

• my_task_bot
• ShopHelperBot
• service_01_bot 

Примеры неправильных username:

Важно: Username уникален глобально. Если имя занято, BotFather предложит выбрать другое

# Пример ввода
my_task_bot

Получение API токена

После успешного создания бота BotFather отправит сообщение с API токеном .

Формат токена:

123456789:AAExampleTokenxxxxxxxxxxxxxxxxxxx

• Первая часть — ID бота (число)
• Вторая часть — уникальная строка, сгенерированная Telegram 

Совет: Нажми на токен в Telegram, чтобы скопировать его. Не теряй его и не показывай никому.

Важно: Токен — это аналог пароля. Любой, кто получит токен, сможет управлять твоим ботом.

Проверка токена

После получения токена можно проверить его работоспособность. Открой браузер и перейди по адресу:

https://api.telegram.org/bot<ТВОЙ_ТОКЕН>/getMe

Если всё правильно, ты увидишь информацию о боте в формате JSON:

{
  "ok": true,
  "result": {
    "id": 123456789,
    "first_name": "Бот для задач",
    "username": "my_task_bot"
  }
}

Сохранение токена

Токен нужно сохранить в надёжном месте. В коде его обычно хранят в переменной окружения, а не в самом коде .

Плохо (опасно):

TOKEN = "123456789:AAExampleTokenxxxxxxxxxxxxxxxxxxx"  # Не делайте так!

Хорошо (безопасно):

В файле .env:

BOT_TOKEN=123456789:AAExampleTokenxxxxxxxxxxxxxxxxxxx

В коде:

import os
from dotenv import load_dotenv

load_dotenv()
TOKEN = os.getenv("BOT_TOKEN")

Совет: Никогда не публикуй токен в GitHub, в открытых чатах или на форумах. Если это сделать, ботом может завладеть кто угодно.

Если токен скомпрометирован

Если ты случайно опубликовал токен или подозреваешь, что его кто-то получил:

1. Открой чат с BotFather
2. Отправь команду /revoke 
3. Выбери нужного бота
4. Получи новый токен

Важно: Старый токен перестанет работать сразу после замены.

Задачи для закрепления

Задача 1. Найди BotFather в Telegram и начни с ним диалог.

Задача 2. Создай нового бота с именем «Мой первый бот».

Задача 3. Выбери уникальный username, который заканчивается на bot.

Задача 4. Скопируй и сохрани полученный токен в безопасное место.

Задача 5. Проверь токен через браузер, перейдя по адресу https://api.telegram.org/bot<ТОКЕН>/getMe.

Нюансы и подводные камни

Username нельзя изменить после создания

Важно: Username бота нельзя изменить. Если ошибёшься, придётся удалять бота и создавать заново.

Имя бота можно менять

В отличие от username, имя бота (display name) можно изменить в любое время через BotFather (команда /setname).

Срок жизни токена

Токен не имеет срока действия и действует до тех пор, пока ты не сменишь его через /revoke .

Несколько ботов

Один аккаунт Telegram может создавать неограниченное количество ботов.

Частые ошибки и как их избежать

Ошибка 1: Username не заканчивается на bot

# Неправильно
my_task
shop_helper

# Правильно
my_task_bot
shop_helper_bot

Ошибка 2: Использование кириллицы в username

# Неправильно
мой_бот

# Правильно
moy_bot

Ошибка 3: Публикация токена в коде

Храни токен в переменных окружения (файл .env).

Ошибка 4: Username слишком короткий

Минимальная длина — 5 символов. Слишком короткие имена уже заняты.

Шпаргалка

Заключение / Выводы

Сегодня мы:

• 🤖 Познакомились с BotFather — официальным создателем ботов
• 📝 Создали первого бота
• 🔑 Получили и сохранили API токен
• ⚠️ Узнали о безопасности токена

КВИЗ

Что дальше?

• Следующая статья: «Установка aiogram и первый бот»