Команды BotFather и ботов Telegram

Как создать бота в Телеграме и настроить команды: ограничения, правила BotFather, лайфхаки для новичков и разработчиков – полная инструкция в обзоре!

О том, как сделать первого Телеграм-бота через БотФазер и что для этого нужно, рассказывали в статье «Создаем бота в BotFather: инструкция, команды, настройки». В этом материале остановимся на командах для Telegram и работы с мессенджером:

• для BotFather – создание бота, редактирование, установка описания / аватара и т.д., управление играми в Telegram;
• для разработчиков – какие команды поддерживает бот в Телеграме, как устанавливать их, какие требования к названиям, как устанавливать через БотФазэра или пакетно.

Как настроить команды чат-бота в Телеграм через BotFather

Чтобы задать команды нашему боту, созданному ранее в пошаговой инструкции, идем в BotFather и выбираем /setcommands.

БотФазер предлагает задавать новые таким образом:

• command1 — Description;
• command2 — Another description.

Если перевести на русский, нам нужно ввести команду и ее краткое описание. В данном примере это command1 — info about ChatLabs. БотФазер уведомляет о том, что обновил лист (список) команд, и теперь в нем будут заданные нами.

Давайте проверим, что удалось создать. Запрашиваем список ботов через /mybots, выбираем нужный и видим, что у него есть 1 заданная command.

Давайте теперь перейдем в бота и проверим, действительно ли наша команда добавлена. Да, она вызывается и имеет короткое описание – все так, как мы и задавали. Теперь вы знаете, как сделать команды в Телеграм боте через @BotFather. Правда, нужно добавлять логику (что будет происходить после вызова, откуда приходят данные, какие они и т.д.).

Команды BotFather для создания ботов Telegram и управления ими

Чтобы увидеть список команд Бот Фазер, необходимо перейти в Телеграм (@BotFather, обязательно проверяйте галочку верификации!) и ввести команду /help. Также можно запросить меню с клавиатуры. Команды Телеграм, которые доступны сегодня, могут дополняться завтра. К примеру, в 2023 появился целый набор функций для работы с веб-приложениями Web Apps.

Давайте разберем команды для бота Телеграм через BotFather.

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

Бот Фазэр предоставляет команды:

• /newbot – создаем нового бота в Телеге;
• /mybots – редактирование chat bots на аккаунте.

Как редактировать бота в Telegram

Телеграм предоставляет следующие команды из категории «Edit Bots»:

• /setname – установить имя для чат-бота;
• /setabouttext – добавить информацию в раздел «О боте»;
• /setuserpic – установить фотографию профиля (обратите внимание, что сегодня тг поддерживает и иные форматы аватара);
• /setdescription – изменить дескрипшен (это короткое описание, которое имеет chatbot);
• /setcommands – изменить набор команд (задать все необходимые);
• /deletebot – удалить бота.

Как изменить настройки бота в Телеграм

Набор команд из категории «Bot Settings» в BotFather Телеграм выглядит таким образом:

• /token – сгенерировать токен авторизации;
• /revoke – отозвать авторизационный token;
• /setinline – перейти в inline mode (инлайн-режим позволяет взаимодействовать с чат-ботом без клика на «Start»);
• /setinlinegeo – активировать инлайн-запросы геолокации;
• /setinlinefeedback – изменить настройки инлайн-режима;
• /setjoingroups – параметры добавления в группы;
• /setprivacy – активация приватного (прайваси) доступа для работы с группами.

Как задавать настройки Web Apps (веб-приложений) в Телеграм

WebApp внешне напоминает сайт с каталогом или другой функциональностью. Команды для работы с веб-приложениями в Telegram:

• /myapps – редактировать веб-приложение;
• /newapp – создать новый веб-аппликейшн;
• /listapps – получить список Web Apps на аккаунте;
• /editapp – редактировать веб-приложение;
• /deleteapp – удалить web app.

Как создавать игры и управлять ими

Команды для Games были в режим beta, но сегодня доступны и работают полноценно. Разработчикам чат-ботов функциональность игр сегодня позволяет реализовать любую механику:

• Play2Earn (p2e) – играй, чтобы зарабатывать;
• Move2Earn (m2e) – двигайся, чтобы зарабатывать;
• Learn2Earn (l2e) – изучай, чтобы зарабатывать;
• Free2Play (f2p) – играй бесплатно и так далее.

Появление раздела с играми в Телеграмме открыло целое направление – геймификация в мессенджере. К примеру, мы делали бота для игры в шахматы в Телеграм (Web Apps).

Команды BotFather Телеграм, чтобы создать и отредактировать игру:

• /mygames – запросить игры;
• /newgame – создать новую игру в ТГ;
• /listgames – запросить список игр в Телеграме;
• /editgame – отредактировать игру;
• /deletegame – удалить игру в ТГ.

Естественно, дерево команд разветвленное. К примеру, после выбора /newbot Бот Фазер предложит задать имя и юзернейм, после чего выдаст ссылку и токен доступа.

Команды БотФазер в Телеграм позволяют создать простого бота. Чтобы chat bot работал по нужным сценариям с кнопками «Купить», «Оплатить», «Заказать», «Посмотреть» и так далее, нужно использовать дополнительные команды. Условно мы назвали их «Commands for developers». Т.е. команды чат-ботов для разработчиков – те, которые не предоставляет BotFather, но которые нужны для прикручивания определенного функционала. Они все равно задаются через БотФазера и /setcommands (или при взаимодействии с API напрямую).

Команды бота в Телеграм для разработчиков

Команда – ключевое слово, которое пользователь отправляет в чат-бот. Основные правила для работы с командами чат-ботов для девелоперов:

1. Команда боту в Телеграм всегда начинается со слеша (/) и выглядит как /keyword. Ключевое слово после слэша указывает чат-боту, что нужно делать.
2. Хайлайтс команд в сообщениях. Когда юзер нажимает на команду, она отправляется снова.
3. Список поддерживаемых ботов команд лучше делать с описанием. Короткий дескрипшен появляется после знака / и отвечает на вопрос, что произойдет после вызова команды. Чтобы реализовать функционал, нужно предоставить список команд @BotFather или через метод API.
4. Команды должны быть максимально конкретными. При этом разработчики Telegram делятся лайфхаком: /newlocation или /neworder лучше, чем просто команда /new. Причина в том, что в последнем случае нужно делать «двухходовку» и после команды /new вводить дополнительный параметр /location или /order.

Что касается кастомных команд, которые задает разработчик при создании бота, здесь есть нюансы:

• / обязателен (команда должна начинаться со слэша);
• длина – до 32 символов;
• буквы – только латиница (английские).

Допускается задавать команды с использованием цифр и знаков (настройки Телеграмма поддерживают подчеркивания).

Примеры команд для чат-бота:

• /next;
• /profile;
• /cancel;
• /newlocation;
• /newrule и так далее.

Можете посмотреть, как реализован чат-бот @ChatLabs_bot. Он – помощник в работе с входящими запросами от клиентов.

Глобальные (общие) команды ботов в Телеграмме

Мессенджер просит использовать при разработке так называемые «Глобальные» (Global Commands). Они нужны, чтобы привести всех ботов в Telegram к единообразному и удобному интерфейсу.

Глобальные (общие, публичные) команды для чат-бота в Телеграмме:

• /start – начало взаимодействия (к примеру, когда bot отправляет пользователю приветственное сообщение). Глобальная /start используется также для передачи боту дополнительных параметров через Deep Linking.
• /help – справка. Глобальная command в Телеграм нужна для короткого описания робота и его функциональности. В пару кликов юзер может увидеть список команд и «способностей» robot.
• /settings – настройки для конкретного пользователя и команды редактирования (если применимо).

Кнопку «Start» пользователи видят при первом взаимодействии с роботом. Ссылки на /help и /settings будут доступны после добавления их в @BotFather.

Области действия команд (Command Scopes, скоупы), настройка ролей

Функционал нужен для того, чтобы распределить роли. Если коротко, то бот может показывать одни команды администраторам, а совершенно другие – обычным пользователям. Command Scopes – продвинутая функция Телеграм.

На бекенде всегда нужно проверять: а) есть ли вообще запрашиваемые команды; б) имеет ли пользователь право работать с ними. Учитывайте, что у ботов Телеграм с включенным режимом конфиденциальности работа строится иначе.

Команды ботам в Privacy Mode (прайваси, режим конфиденциальности)

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

К примеру, chat bots в Privacy Mode в Telegram видят только команды:

• явно предназначенные для них (к примеру, имеющие формат /command@forthis_bot).
• общие (/start, /settings, /help), если bot был последним отправившим сообщение группе.

Режим конфиденциальности нужен, чтобы сделать робота более эффективным (особенно на хайлоад-проектах). Активированный Privacy Mode уменьшает количество вводных данных, которое должен обработать robot в TG.

Как создать команды для бота в Телеграм для администрирования группы, чата, канала

Команды Telegram бота для администрирования групп нужны для «поддержания порядка». Сегодня на рынке есть роботы-администраторы и модераторы, которые значительно упрощают работу с сообществами. Бесплатные боты для Телеграмм-каналов и чатов разбирали в отдельной инструкции.

Условия просты: команды отправляются в ответ на сообщение нарушителя, к которому применяются санкции. Основные commands:

• !kick – выбросить человека из чата (возможен возврат в любой момент);
• !unban – разбанить (снять бан);
• !mute – мут / читалка (участник получает ридонли, т.е. может читать чат, но не будет отправлять сообщения);
• !ban – забанить (в случае временного бана на определенный период может выглядеть как !ban 20d);
• !unmute – анмут, снимает действие !mute;
• !warn – выдает предупреждение (после трех / пяти предупреждений участник получает бан);
• !unwarn – снять все предупреждения, а также многие другие.

Команд Телеграм-бота для групп и сообществ может быть значительно больше: вывести статистику, понизить репутацию, получить информацию о пользователе, вывести ТОП участников (по определенному критерию), почистить чат или многие другие.

В Телеграм бот настройка команд проста. При работе с БотФазером проблем не возникает. Но сложности появляются, когда необходимо писать собственную логику на Питоне, Джаваскрипте или других языках программирования. Именно поэтому часто приходят в студию ChatLabs, а не пытаются создать чат-бота самостоятельно.

Благодаря пошаговой инструкции с обзором вы знаете, как прописать команды боту в Телеграм. В обзорах и материалах разберем кнопки с командами Телеграм бота, скрытые команды и многие другие фишки telegram bot API.

Ответы на часто задаваемые вопросы (FAQ)

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

«@BotFather –> /mybots –> название бота –> Edit commands –> ввести название команды». Также есть и более простая пошаговая инструкция, как прописать команды боту в Телеграм. Нужно вызвать /setcommands в настройках робота в @BotFather и задать необходимые.

Как добавить несколько команд в тг бота?

Задать через /setcommands в БотФазере или использовать API. Формат – «command — короткое описание» (command1 — Description).

Почему Телеграм бот не реагирует на команды?

Ошибка в программировании логики чат-бота на Python, Javascript или других языках – самая частая причина (не передали аргументы, не добавили обработчики и т.д.). Среди причин, почему не работают команды бота в Телеграм, настройки конфиденциальности профиля, параметры получения уведомлений бота, работа сервера, проблемы интернет-подключения, некорректный ввод и так далее.

Как удалить команду в боте Телеграм?

Прямой функции «Удалить команду №1» в Botfather нет. Вместо этого администратор запрашивает /setcommands в Ботфазер и задает новый список команд. К примеру, чат-бот работает с тремя:

• /start – начало работы;
• /viewlocation – показать локацию;
• /newlocation – новая локация.

Мы хотим удалить команду для задания новой локации. Для этого выбираем /setcommands в БотФазере и задаем новый набор commands:

• /start – начало работы;
• /viewlocation – показать локацию.

Botfather перезапишет их. Новый набор отобразится приблизительно через 10 минут (не переживайте, если информация обновилась не сразу).

Как добавить несколько команд в тг бота?

Запустить /setcommands в Botfather Телеграмма и вписать новые команды в формате: название – дескрипшн.

Почему команды бота недоступны в группе Телеграм?

Проверьте настройки приватности (Disable, group privacy). Также обратите внимание, что в Телеграме боты не видят сообщения друг друга и не могут на них реагировать.

Как увидеть в Телеграм боте список команд?

«@BotFather –> /mybots –> название бота». Если нужно редактирование, выбираем Edit commands.

Какие в Telegram команды iOS геопозиции?

В Telegram Bot API геопозиция доступна после запроса /setinlinegeo. Объект содержит обязательные параметры longitude и latitude. Дополнительно (опционально) в API предусмотрены horizontal_accuracy, live_period, heading, proximity_alert_radius.

Какая у Botfather инструкция – на русском команды вводить можно?

Инструкция для БотФазера и создания чат-ботов на русском есть на сайте. Bots Telegram поддерживают только английский (/newtoken, /neworder, /newlocation). При попытке задать значение на русском Бот Фазер покажет ошибку.

Какие есть интересные и прикольные команды в ТГ?

Они связаны не столько с разработкой, сколько с ежедневным использованием. Среди интересных фишек установка пароля на чаты, отложенные сообщения (можно настраивать дату публикации), пометить сообщение как непрочитанное, настроить счетчик уведомлений, установить скрытый текст и так далее.