Как создать бота в ТГ

Как создать бота в BotFather

1. Откройте @BotFather и нажмите «Запустить».
2. Отправьте команду /newbot.
3. Введите имя бота — его отображаемое название.
4. Введите юзернейм — адрес бота вида @my_shop_bot. Он должен состоять из 5–32 символов, только латинские буквы, цифры и подчёркивания, и заканчиваться на bot.
5. BotFather пришлёт токен. Бот создан.

Токен: что это и как хранить

Токен выглядит как набор цифр и букв через двоеточие. Любой, у кого он есть, полностью управляет ботом, поэтому по рекомендации Telegram храните токен в безопасном месте и передавайте только тем, кому нужен доступ.

• Не выкладывайте токен в открытый код, на GitHub и в чаты.
• Если токен утёк, получите новый: в справке Telegram для этого указана команда /token в BotFather. Обновите токен везде, где он используется в вашей программе.
• Токен нужен только для ботов. Ключи api_id и api_hash — другая вещь, они для программ, которые входят как пользователь: как их получить.

Что настроить в BotFather

Команда /mybots открывает интерактивное меню настроек ваших ботов; то же есть в мини-приложении BotFather. Оформление задаётся и отдельными командами:

• /setname — имя бота.
• /setdescription — описание бота, короткий текст до 512 символов.
• /setabouttext — «О боте», текст короче описания, до 120 символов.
• /setuserpic — аватар бота.
• /setcommands — список команд: когда человек вводит /, Telegram подсказывает их.
• /setjoingroups — можно ли добавлять бота в группы.
• /setprivacy — какие сообщения в группах бот будет получать.
• /deletebot — удалить бота и освободить его юзернейм.

Как заставить бота отвечать

Бот — это программа, которая общается с Telegram через Bot API. Все запросы идут на адрес https://api.telegram.org/bot<токен>/МЕТОД. Получать сообщения можно двумя способами, и они взаимоисключающие:

• getUpdates (длинный опрос): программа сама запрашивает новые сообщения. Проще всего для начала — публичный адрес не нужен.
• Webhook: Telegram сам присылает сообщения на ваш сервер. Нужен HTTPS и один из портов 443, 80, 88 или 8443.

Писать код можно на любом языке с HTTP-запросами. Для Python популярны библиотеки aiogram и python-telegram-bot, для JavaScript — Telegraf и grammY. Официальный учебник Telegram показывает путь на Java: от BotFather до «Hello World». Запустить бота можно на своём компьютере, пока он включён, или на VPS — тогда он работает круглосуточно.

Кнопки и команды в боте

• Команды — слова вида /start, которые бот обрабатывает; список для подсказки задаётся через /setcommands.
• Кнопки под сообщением (inline-кнопки) не отправляют текст в чат: они присылают боту нажатие или открывают ссылку.
• Кнопки вместо клавиатуры (reply-клавиатура) показывают готовые варианты ответа.
• Mini App — полноценный интерфейс, который открывается прямо внутри Telegram.

Подробности — в описании возможностей ботов.

Оплата в боте

Цифровые товары и услуги в ботах оплачиваются звёздами Telegram: счёт выставляется в валюте XTR, платёжный провайдер не нужен. Как это подключить, описано в статье оплата звёздами в боте, а звёзды, накопленные ботом, выводятся через Fragment — как вывести звёзды из бота.

Частые вопросы