Как сделать бота в Телеграм

Сделать бота в Телеграм можно через официального бота @BotFather: отправьте ему команду /newbot, придумайте имя и юзернейм, и он выдаст токен. Так описано в документации Telegram для разработчиков ботов.

Токен нужен, чтобы управлять ботом через Bot API. Его хранят как пароль: по документации, любой, у кого есть токен, может управлять вашим ботом.

Как создать бота через @BotFather

Создание бота занимает пару минут и не требует программирования. Порядок по документации Telegram:

• Шаг 1. Найдите в Telegram @BotFather и откройте с ним чат.
• Шаг 2. Отправьте команду /newbot.
• Шаг 3. Введите имя бота, оно будет видно в контактах и в чатах.
• Шаг 4. Введите юзернейм бота, по нему его будут находить в поиске.
• Шаг 5. Сохраните токен, который пришлёт @BotFather.

После этого бот уже существует, но пока ничего не умеет. Чтобы он отвечал на сообщения, к нему подключают программу, которая работает через Bot API.

Требования к имени и юзернейму бота

У бота два названия: имя и юзернейм. Имя потом можно поменять, а юзернейм нельзя, поэтому выбирайте его внимательно.

Что	Требования из документации
Имя	Показывается в контактах, можно менять командой /setname
Юзернейм	От 5 до 32 символов: латиница, цифры и нижнее подчёркивание
Окончание юзернейма	Обязательно на «bot», например tetris_bot или TetrisBot
Регистр	Не важен

Юзернейм используется в поиске, упоминаниях и ссылках вида t.me. Если нужный уже занят, придётся выбрать другой.

Что такое токен и как его хранить

Токен — строка вида «110201543:AAHdqTcv…», которая подтверждает, что запросы к Bot API отправляет именно ваш бот. Он относится к боту, а не к вашему аккаунту Telegram.

Правила из документации:

• храните токен в надёжном месте и никому его не передавайте;
• если токен утёк или потерян, получите новый командой /token в @BotFather;
• в коде лучше не хранить токен напрямую, а выносить в файл настроек или переменные окружения.

Проверить токен можно прямо в браузере. Документация предлагает открыть адрес api.telegram.org/bot<токен>/getMe, и в ответ придут данные бота.

Как настроить бота после создания

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

Команда	Что меняет
/setdescription	Описание до 512 символов, его видят в начале чата
/setabouttext	Короткий текст до 120 символов в профиле бота
/setuserpic	Аватар бота
/setcommands	Список команд, которые бот подсказывает после «/»
/setjoingroups	Можно ли добавлять бота в группы
/deletebot	Удаление бота, его нельзя отменить

Полный список команд @BotFather показывает сам: введите «/» в поле сообщения. Документация предупреждает, что новые команды могут появиться в любой момент.

Какие команды нужны каждому боту

Документация Telegram советует поддерживать три базовые команды. Пользователи ожидают их от любого бота.

Что они делают:

• /start — начало общения, например приветствие, команда видна как кнопка Start при первом открытии чата;
• /help — короткая справка о том, что умеет бот, и список команд;
• /settings — настройки бота для пользователя, если они есть.

Список команд задают через /setcommands. Тогда Telegram будет показывать подсказки, когда пользователь вводит «/».

Как бот может принимать оплату

Боты в Telegram умеют продавать товары и услуги через встроенные платежи. Для цифровых товаров действует отдельное правило.

По документации Telegram о платежах:

Что продаёт бот	Чем платят
Цифровые товары и услуги	Только Telegram Stars (валюта XTR)
Физические товары	Отдельный порядок, описан на своей странице

Пользователи покупают звёзды через встроенные покупки Apple и Google или через @PremiumBot, а затем платят ими боту. Разработчик потом может обменять полученные звёзды на вознаграждение.

Как передать бота другому человеку

Бота можно передать другому пользователю: отправьте /mybots, выберите бота и передайте права. Передать можно только тому, кто хотя бы раз общался с ботом.

Что важно знать:

• новый владелец получает полный доступ, в том числе к сообщениям бота;
• он сможет удалить бота;
• передача окончательная, поэтому решайте заранее.

Служба поддержки Игродоната: «Если бот продаёт цифровые товары за звёзды, покупателям нужен баланс Stars. Звёзды можно пополнить по юзернейму, без входа в аккаунт Telegram».

На Игродонате продаются звёзды Telegram по юзернейму и Telegram Premium в подарок. Как оплатить Premium из России, мы разобрали в статье как оплатить Телеграм Премиум.