Партнёры в команде регулярно спрашивают одно и то же: как создать своего Telegram-бота. Решил собрать инструкцию в одном месте, чтобы не объяснять каждый раз.
К концу будет: рабочий бот в Telegram и его API-токен, сохранённый так, чтобы его не угнали. Программировать не надо - всё делается прямо в самом Telegram, через переписку с одним служебным ботом @BotFather. Уйдёт минут 5-10.
Один момент в самом начале, на котором тонут. В поиске Telegram по слову "BotFather" - десяток клонов с галочкой "официальный". Это мошенники. Настоящий один. Покажу как отличить - и заодно как сохранить токен, чтобы его потом не пришлось отзывать.
Что такое @BotFather и почему всё через него
@BotFather - это официальный бот самого Telegram, который создаёт других ботов. Не сайт, не приложение, не админка с логином-паролем. Просто бот в мессенджере, которому пишешь команды, а он создаёт для тебя нового бота.
Команда Telegram запустила его в 2015 году. Все остальные боты которыми ты когда-либо пользовался (от рассылок интернет-магазинов до игр с твоими друзьями) родились здесь. Других путей создать бота просто нет.
Всё бесплатно. Telegram деньги за создание ботов не берёт.
Шаг 1. Найти настоящего @BotFather
Это первое место где тонут. Когда в поиске Telegram пишешь "BotFather" - вылезает не только настоящий, но и двадцать клонов с похожими никами:
- BotFather (настоящий, @BotFather)
- Bot_Father
- BotFatherOfficial
- TheBotFather
- BotFather_Bot
- BotFather2024
Каждый клон попросит у тебя номер телефона, потом код подтверждения, потом "верификацию через перевод 100 рублей". И всё. Это та же схема что фейковые сайты Госуслуг.
- Username строго
@BotFather. Без подчёркиваний, без цифр, без приставок. Ровно эти 9 букв. - Синяя галочка верификации рядом с именем. На клонах галочки нет.
- Описание «I create bots and tokens». Если бот пишет на русском «Создание ботов от 100 руб» - это мошенник.
- Подписчики. У настоящего @BotFather их миллионы. У клонов сотни-тысячи.
Самый надёжный способ - открыть Telegram, нажать поиск, ввести @BotFather целиком (со собакой), выбрать первого с синей галочкой. Или просто перейти по этой ссылке - она ведёт на настоящего.
@Fazerrr4_bot, @BotFatherPoisk_bot, @BotFather123_robot. Не они.Шаг 2. Стартуем диалог
Открываешь @BotFather, видишь пустой чат. Дальше пошагово.
/startВ обычное поле сообщения. Бот тут же отвечает большим списком всех своих команд: /newbot, /mybots, /setname и ещё штук десять. Не пугайся - нам нужна сейчас только одна.
/newbot в самом верху.Шаг 3. Создаём нового бота
/newbotБот спрашивает как назвать бота - это отображаемое имя, его будут видеть пользователи в шапке чата.
По-человечески. Если бот будет помогать клиентам выбрать продукт - "Атоми Помощник" или "Ассистент Дениса". Не "BOT_v2_TEST" или "mybot123" - это сразу палит что бот, и доверие минус. Имя можно менять потом, не торопись.
Это ник по которому бота находят. Пишется через @, должен заканчиваться на _bot или bot. Например @atomy_dynasty_bot или @helpzinin_bot.
/newbot → "Ассистент Дениса" → бот просит username который заканчивается на bot.- Должен быть уникальным. Если занят - бот скажет «Sorry, this username is already taken». Придумываешь другой.
- Должен быть запоминаемым. Клиент увидит его в чате -
@xyz_2024_botон не запомнит, а@dynastybotзапомнит. - Соответствует бренду. Если у тебя сайт
atomybydynasty.com, ник вроде@atomydynastybotлогичен. - Username нельзя сменить после создания. Только пересоздавать бота с нуля. Не торопись - придумай сразу нормальный.
Шаг 4. Получаешь API-токен
Когда @BotFather принимает имя и username, он сразу присылает поздравление и API-токен - длинную строку вида:
8123456789:AAEhBP9876543210abcdefghijklmnop
Это и есть твой бот. Технически бот - это просто этот токен.
/revoke перед публикацией статьи (поэтому показываю открыто как пример). Свой никогда так не показывай.Шаг 5. Сохраняешь токен правильно
API-токен - это ключ от твоего бота. По нему любая программа (или человек) может писать сообщения от имени бота, читать всё что ему пишут пользователи, менять настройки, удалять.
Куда сохранять:
- Заметки на айфоне с пометкой «бот @имя_твоего_бота - токен»
- Менеджер паролей (1Password, Bitwarden, KeePass)
- Apple Keychain или Google Password Manager
- Защищённый блокнот с паролем
Куда не сохранять:
- В переписку Telegram. Особенно с другими людьми. Особенно с самим собой - потом перешлёшь скрин.
- В обычный гугл-документ без пароля.
- В скриншот, который потом «случайно» окажется в социальной сети.
- На стикер на мониторе.
Если кто-то получит твой токен - он может писать всем твоим клиентам от имени бота, удалять чаты, рассылать ссылки на мошеннический сайт от твоего имени. Восстановить ничего нельзя - придётся пересоздавать бота, рассылать всем новый ник, объяснять что произошло. Дни потеряешь.
Случайно показал кому-то (или, например, опубликовал в статье как я выше): пишешь @BotFather команду /revoke, выбираешь нужного бота, получаешь новый токен. Старый перестаёт работать. 30 секунд работы.
Не помнишь куда сохранил: без паники. Открываешь @BotFather, пишешь /mybots, выбираешь нужного бота, нажимаешь "API Token". Покажет тот же токен что выдавал.
/mybots: API Token, Edit Bot, Bot Settings, Payments, Transfer Ownership, Delete Bot. Все настройки бота отсюда.Что у тебя сейчас есть
После всех 5 шагов:
- Свой Telegram-бот с уникальным username и нормальным именем
- API-токен, сохранённый в надёжном месте
Ничего из этого ещё не работает «как ассистент». Это пока заготовка - бот умеет только принимать сообщения, ответов сам не даёт. И самое важное - сейчас бот работает в отдельном чате, не в твоей личке с клиентами.
Чтобы бот начал отвечать клиентам от твоего имени в личных переписках, нужны ещё две вещи:
- Telegram Premium - без него Business-режим не включается. Покупка из России со всеми хитростями - в отдельной статье.
- Подключение Telegram Business - привязка бота к личному аккаунту, выбор каких чатов ему доступны, создание горячих ссылок.