BotFather: как создать бота в Telegram и получить токен
Создать бота в Telegram проще, чем кажется. Код писать не нужно: всё делается перепиской с одним служебным ботом, и на это уходит минут пять.
BotFather — официальный бот Telegram, через который создают и настраивают других ботов. Вы отправляете ему команду /newbot, придумываете имя и адрес, а в ответ получаете токен — ключ, по которому сервис вроде Recordo подключает бота и начинает отвечать клиентам от его имени.
Ниже — пошаговая инструкция, команды BotFather на русском, что делать с токеном и как настроить описание и аватар.
Что такое BotFather и есть ли он на русском
BotFather — служебный бот самого Telegram. Через него создают ботов, получают и перевыпускают токены, меняют имя, описание и аватар. Для этого не нужен компьютер: всё работает в обычном приложении Telegram на телефоне.
Как не попасть на подделку. Настоящий BotFather — @BotFather с синей галочкой рядом с именем. Ботов с похожими названиями много, и некоторые просят токен «для проверки». Токен никому, кроме сервиса, к которому подключаете бота, не отправляйте.
Русского языка у BotFather нет. Он отвечает по-английски, а команды одинаковые для всех. Пугаться не стоит: фраз, которые нужно понять, всего несколько, и ниже мы перевели и их, и все нужные команды.
Как создать бота в BotFather: 5 шагов
Чтобы создать бота через BotFather, нужен только Telegram. Вся инструкция — пять сообщений.
- Откройте @BotFather. Найдите его в поиске Telegram, проверьте синюю галочку и нажмите «Запустить» (Start).
- Отправьте команду /newbot. Её можно набрать вручную или выбрать в меню команд. BotFather спросит, как назвать бота.
- Напишите имя. Это название, которое клиенты видят в чате и в списке контактов, например «Mira Nails — запись». Можно по-русски, с пробелами и эмодзи. Имя потом легко поменять.
- Придумайте username. Это адрес бота вида @mira_nails_bot: по нему бота находят в поиске и открывают по ссылке. Только латиница, цифры и подчёркивание, от 5 до 32 символов, в конце обязательно «bot». Username после создания поменять нельзя, поэтому выбирайте тот, что не стыдно напечатать на визитке.
- Скопируйте токен. В ответ придёт сообщение «Done! Congratulations on your new bot» и длинная строка вида 123456789:AAH… — это и есть токен. Нажмите на него, и он скопируется целиком.
Бот создан. Пока он пустой: отвечать клиентам он начнёт, когда вы подключите его к сервису.
Токен BotFather: где найти, куда вставлять и что делать при утечке
Токен BotFather — это пароль от бота. Кто знает токен, тот управляет ботом: может отвечать от его имени и читать сообщения, которые клиенты ему пишут. Поэтому токен не публикуют в чатах и не отправляют «службе поддержки», которая написала первой.
Где найти токен, если сообщение потерялось. Отправьте BotFather команду /mybots, выберите бота и нажмите API Token. Получать токен заново не нужно, он тот же.
Куда вставлять токен. В тот сервис, который будет работать от имени бота. В Recordo это раздел «Боты» → Telegram → вкладка «Свой бот через @BotFather»: вставьте токен в поле и нажмите «Подключить бота». Токен передаётся один раз и хранится в зашифрованном виде, в кабинете он больше нигде не показывается.
Если токен утёк. Перевыпустите его командой /token в BotFather: старый перестанет работать, и чужой человек потеряет доступ к боту. Username, имя и клиенты при этом не меняются. В Recordo кабинет сам покажет, что старый токен больше не действует. Вставьте новый, и бот продолжит работать как раньше: для клиентов это тот же бот.
Команды BotFather на русском
Команды BotFather — это сообщения со слэшем, которые вы отправляете ему в чат. Список целиком появляется, если набрать «/». Мастеру хватит десятка, остальные нужны разработчикам.
| Команда | Что делает | Когда пригодится |
|---|---|---|
| /newbot | Создаёт нового бота | Первый шаг |
| /mybots | Список ваших ботов с кнопками настроек | Найти токен, поменять что-то без команд |
| /token | Выпускает новый токен, старый перестаёт работать | Если токен попал в чужие руки |
| /setname | Меняет имя бота | Сменили название студии |
| /setdescription | Текст в пустом чате, до 512 символов | Объяснить, что умеет бот, до первого сообщения |
| /setabouttext | Короткое описание в профиле бота, до 120 символов | Адрес, услуги, часы работы одной строкой |
| /setuserpic | Меняет аватар | Поставить логотип или фото |
| /setcommands | Меню команд, которое видит клиент | Обычно настраивает сервис, вручную не нужно |
| /setjoingroups | Разрешает или запрещает добавлять бота в группы | Боту записи группы не нужны |
| /deletebot | Удаляет бота навсегда и освобождает username | Только если бот точно больше не нужен |
Username в этом списке нет: поменять его нельзя. Если адрес не нравится, остаётся создать нового бота.
Как настроить бота: описание, приветствие, аватар
Настроить бота в BotFather можно командами из таблицы выше или через /mybots → Edit Bot, там те же пункты кнопками. До первого сообщения клиент видит четыре вещи, и у каждой своя задача.
- Имя — чтобы клиент узнал вас в списке чатов среди десятка других. Лучше название студии или имя мастера плюс услуга: «Анна · маникюр», а не «Bot123».
- Аватар — та же задача, только картинкой. Логотип или фото работы читаются лучше, чем фото мастера издалека.
- Короткое описание (about) — видно в профиле бота и уходит вместе со ссылкой, когда бота пересылают. В 120 символов помещается главное: услуги, район, «запись круглосуточно».
- Текст в пустом чате (description) — его видит человек, который открыл бота впервые и ещё не нажал «Запустить». Здесь стоит объяснить, что будет дальше: «Выберите услугу и свободное время, запись подтвердится сразу».
Приветствие в BotFather не настраивается. Сообщение, которое бот присылает после «Запустить», задаёт сервис, к которому подключён бот. В Recordo это раздел «Тексты» на странице бота: туда можно вписать своё приветствие, и бот сам подставит имя клиента.
Если бот подключён к Recordo, BotFather для настройки уже не нужен. Имя, оба описания и аватар меняются в кабинете, во «Внешнем виде» на странице бота, и сразу появляются в Telegram. Там же видно, как описание будет выглядеть у клиента целиком. На бесплатном тарифе к короткому описанию добавляется небольшая подпись «Сделано на базе Recordo», на платных тарифах её нет.
Частые ошибки
Большинство проблем с ботом случаются на шаге username или при копировании токена. Вот что обычно идёт не так и как это исправить.
- «Sorry, this username is already taken». Адрес занят. Добавьте город, район или нижнее подчёркивание: mira_nails_spb_bot вместо mira_nails_bot.
- Username не принимается. Скорее всего, в конце нет «bot», есть кириллица, пробел или дефис. Дефис — частая ловушка: в username он запрещён, вместо него подчёркивание.
- Токен не подходит. Его скопировали не целиком: обрезали начало до двоеточия или зацепили пробел. Скопируйте ещё раз нажатием на токен в сообщении BotFather.
- Бот подключён к другому сервису. Один бот одновременно работает только с одним сервисом. Если раньше вы подключали его к другому конструктору, отключите его там или создайте нового бота.
- Бот подключён, но молчит. В Recordo проверьте по порядку: статус «Подключён» на странице «Боты», расписание мастеров (без него боту нечего предложить) и месячный лимит записей на бесплатном тарифе.
Бот для записи без BotFather
BotFather только создаёт пустого бота. Чтобы бот записывал клиентов, его подключают к сервису, который знает ваше расписание. В Recordo это можно сделать двумя путями.
Свой бот через BotFather. Подходит, если бот у вас уже есть или вы хотите всё контролировать сами: создаёте бота по инструкции выше и вставляете токен в кабинете.
«Создадим за вас». Подходит всем остальным: BotFather открывать не нужно. В разделе «Боты» нажмите «Создать бота», в открывшемся чате с ботом-помощником — «Старт» и «Создать бота», придумайте username. Имя бот получит по названию вашей студии. Вернитесь в кабинет: бот подключится сам, токен копировать не придётся. Подробно оба способа разобраны в статье как создать бота для записи клиентов.
После подключения бот проверяет свободные окна в вашем расписании, предлагает клиенту время и записывает его. За сутки до визита он сам напоминает о записи, а за несколько часов спрашивает «Вы придёте?». Если клиент нажал «Не приду», окно освобождается, а вам приходит уведомление. Как это выглядит у клиента, показали на странице бот для записи клиентов в Telegram.
В MAX своего BotFather нет: бота регистрируют на платформе MAX для партнёров, и это отдельная история. Её разобрали в статье как создать бота в MAX.
Частые вопросы
Как сделать бота в BotFather бесплатно? Создание бота в BotFather ничего не стоит, и Telegram Premium для этого не нужен. Платить или нет, зависит от сервиса, к которому вы подключаете бота. В Recordo начать можно бесплатно.
BotFather как получить токен, если я уже создал бота? Отправьте /mybots, выберите бота и нажмите API Token. Это тот же токен, что пришёл при создании.
Куда вставлять токен бота от BotFather? В сервис, который будет отвечать клиентам от имени бота. В Recordo: «Боты» → Telegram → «Свой бот через @BotFather» → поле для токена → «Подключить бота».
Как добавить бота в BotFather, если он был создан раньше? Добавлять не нужно: все боты, созданные с вашего аккаунта, уже есть в /mybots. Если бота создавали с чужого аккаунта, управлять им может только тот аккаунт.
Можно ли поменять username бота? Нет. Имя, описание и аватар меняются когда угодно, а username остаётся навсегда. Нужен другой адрес — создайте нового бота.