Как зарегистрировать бота в Telegram: пошаговая инструкция

В этой инструкции описано как создать Telegram-бота, какие настройки у него есть и что ни означают.

Что такое BotFather и зачем он нужен

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

Шаг 1: Открыть Telegram и найти BotFather

1. Откройте приложение Telegram (на телефоне или на компьютере).
2. В строке поиска вверху введите: @BotFather (с собакой в начале).
3. Выберите бота с именем "BotFather" и синей галочкой (официальный).
4. Нажмите "Запустить" или "Start".

Если вы уже писали BotFather раньше, откроется старый диалог — можно продолжать в нём.

Шаг 2: Создать нового бота

1. В чате с BotFather отправьте команду: /newbot
2. BotFather спросит: "Alright, a new bot. How are we going to call it? Please choose a name for your bot."
   • Это отображаемое имя бота — как его видят пользователи. Например: "Погода в городе" или "Поддержка магазина".
   • Введите любое понятное имя на русском или английском и нажмите отправить.
3. Дальше BotFather попросит: "Good. Now let's choose a username for your bot."
   • Username — это короткое имя с обязательным окончанием bot. Например: MyWeatherBot или magazin_support_bot.
   • Только латинские буквы, цифры и подчёркивание. Пробелы нельзя.
   • Это имя должно быть свободно. Если занято — BotFather попросит придумать другое.

После успешного создания BotFather пришлёт сообщение с токеном. Токен выглядит примерно так: 123456789:ABCdefGHIjklMNOpqrsTUVwxyz.

Токен — это секретный ключ доступа к боту. Его <u>нельзя никому показывать</u> и нельзя публиковать в интернете. Кто знает токен — тот может управлять ботом. Обычно токен передают разработчику или вставляют в настройки вашего сайта/сервиса в специальное поле (например, в .env).

Шаг 3: Меню настроек BotFather

В чате с BotFather можно в любой момент отправить команду /mybots. Появится список ваших ботов. Выберите нужного бота — откроется меню с разделами настроек.

Ниже описано, что делает каждый пункт и на что это влияет.

3.1. Редактировать бота ("Edit Bot")

Здесь меняют основные данные бота.

• "Edit Name" — изменить отображаемое имя бота (то, что пользователи видят в списке чатов и в профиле). На работу бота не влияет, только на то, как его воспринимают.
• "Edit Description" — краткое описание бота. Показывается в профиле бота, когда пользователь нажимает на имя. Помогает людям понять, для чего бот. На логику бота не влияет.
• "Edit About" — короткий текст "о боте". Виден в профиле под описанием. Тоже только для информации.

Имя, описание и "About" можно менять когда угодно — на поведение бота это не влияет.

3.2. Команды бота ("Edit Commands")

Здесь задаётся список команд, которые пользователь видит в меню рядом с полем ввода (кнопка "/" в чате с ботом).

Вы вводите команды в формате:

• команда - краткое описание

Например:

• start - Начать работу
• help - Помощь
• order - Оформить заказ

Это только подсказки для пользователя. Реальное поведение при нажатии на команду программируется в коде бота. То есть вы настраиваете, какие команды показывать и как они называются; что именно делает бот при каждой команде — решает разработчик.

Шаг 4: Дополнительные настройки через команды BotFather

Некоторые вещи настраиваются не через меню, а командами в чате с BotFather. Список ниже.

4.1. Язык интерфейса бота

Команда: /setlanguage

Позволяет выбрать язык интерфейса самого BotFather (не вашего бота). На то, на каком языке общается ваш бот с пользователями, это не влияет — язык ответов бота задаётся в коде.

4.2. Картинка (аватар) бота

Команда: /setuserpic

BotFather попросит отправить изображение. Это фото будет отображаться как аватар бота в списке чатов и в профиле. Влияет только на внешний вид, не на логику.

4.3. Описание для каналов (Inline-режим)

Если бот будет использоваться в режиме "inline" (когда пользователь вводит @username_бота в любом чате и получает подсказки):

• /setinline — включить или выключить inline-режим.
• /setinlinegeo — разрешить передачу местоположения в inline-запросах (нужно не всем ботам).

Влияет на то, будет ли бот доступен через @ в других чатах и что он может получать (например, геолокацию). Обычным ботам для поддержки или заказов чаще достаточно просто чата с ботом, без inline.

4.4. Команды в группах

• /setjoingroups — разрешить или запретить добавлять бота в группы. Если запретить — бота можно будет только открыть в личке.
• /setprivacy — режим приватности в группах:
  • Disabled — бот видит все сообщения в группе (чтобы реагировать на команды и текст).
  • Enabled — бот видит только сообщения, которые начинаются с "/" или содержат упоминание бота.

Влияет на то, где бот может находиться (только личка или и группы) и какие сообщения в группе ему доступны. Для бота-поддержки или заказа товаров часто достаточно личных сообщений; тогда добавление в группы можно отключить.

4.5. Платежи (Telegram Payments)

Команда: /payments (или настройка через меню бота, если есть пункт про платежи).

Здесь подключают приём оплаты через Telegram (карты и т.д.). Настраивается после регистрации бота у платёжного провайдера. Без этой настройки бот не сможет показывать кнопки оплаты через Telegram. Саму логику оплаты и связь с вашим сайтом/кассой делает разработчик.

4.6. Привязка к домену (для веб-приложений)

Команда: /setdomain (или аналогичный пункт в меню).

Если бот открывает веб-страницы внутри Telegram (мини-приложения), сюда добавляют домен вашего сайта. Без добавленного домена Telegram не будет открывать ваши ссылки внутри приложения. На обычный чат-бот без веб-страниц это не влияет.

Краткая сводка: что на что влияет

Что делать после регистрации

1. Сохраните токен в надёжном месте.
2. Передайте токен разработчику или вставьте в настройки проекта.
3. Дальнейшее поведение бота (приветствия, кнопки, ответы на вопросы, заказы) настраивается уже в коде и на сервере, а не в BotFather.

Если нужно что-то изменить в имени, описании или списке команд — снова откройте @BotFather, отправьте /mybots, выберите бота и нужный пункт меню.