Перейти к содержимому

Инструкция по созданию и настройки бота в BotFather

Инструкция по созданию и настройке бота в BotFather: пошаговая регистрация через @BotFather, выбор юзернейма и получение токена для подключения к RadistWeb.

Что такое BotFather

BotFather — это главный сервис в Telegram, через который регистрируются все пользовательские боты. Обязательное условие при создании — уникальный юзернейм с приставкой «bot» в конце, например «@MyFirstbot» или «@MyFirst_bot».

Чат с сервисом BotFather в Telegram

На один аккаунт Telegram можно зарегистрировать до 20 ботов — это ограничение самого Telegram (по данным справки Битрикс24). В личном кабинете RadistWeb по умолчанию доступно 5 подключений Telegram Bot; если нужно больше, лимит увеличит поддержка.

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

Регистрация происходит через главный сервис, который можно найти в обычной строке поиска Телеграма — «BotFather». Стоит обратить внимание на галочку, у официального сервиса она должна быть.

Пошаговая инструкция:

  1. открыть приложение Telegram на любом устройстве;

  2. в строку поиска ввести @BotFather;

  3. нажать на первый результат;

  4. запустить сервис при помощи кнопки «START»;

  5. в появившемся списке выбрать команду «/newbot»;

  6. ввести название — это имя, которое будет отображаться сверху;

  7. указать юзернейм — он должен состоять исключительно из английских букв и цифр, а также включать в название приставку «bot» в самом конце.

    Создание бота командой /newbot: имя и юзернейм

На этом процесс регистрации завершен, осталось сохранить полученный token для взаимодействия с HTTP API по вебхук-ссылке. При помощи него будет осуществляться отправка и получение сообщений.

❗️ Если вы обновили токен бота, подключённого к RadistWeb, его обязательно нужно обновить и в личном кабинете — иначе бот перестанет работать.

Как удалить бота

Иногда может возникнуть необходимость удалять ботов. Сделать это можно через тот же сервис, где происходит создание. Пошаговая «BotFather» инструкция для удаления:

  1. открыть «@BotFather»;

  2. ввести команду «/deletebot»;

  3. выбрать из появившегося списка необходимый объект;

  4. подтвердить удаление путем ввода подтверждающей фразы.

    Удаление бота командой /deletebot

❗️ Если вы удалите бота в BotFather, подключение останется в RadistWeb. Чтобы удалить его окончательно, обратитесь в нашу техническую поддержку.

Все функции BotFather: список команд

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

Основное

Эти команды запускают стадии создания нового и редактирование существующих ботов.

  • «/newbot» — создает нового.
  • «/mybots» — позволяет увидеть список существующих и управлять настройками.

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

  • API Token — покажет действующий токен.

  • Редактирование — изменение всех основных настроек, например, названия или аватарки.

  • Настройки — дополнительные настройки

  • Передать права — с помощью этой функции можно передать бота другому Телеграмм пользователю.

    Список ботов по команде /mybots и настройки

Редактирование созданного бота

В этом блоке происходит основная настройка бота в Телеграме через BotFather. Команды срабатывают, если предварительно выбрать объект при помощи команды «/mybots».

  • «/setname» — устанавливает имя. Оно будет отображаться сверху.
  • «/setdescription» — устанавливает описание. Его можно найти в профиле.
  • «/setabouttext» — устанавливает текст, который пользователь видит до нажатия на кнопку «START».
  • «/setuserpic» — устанавливает аватар. Отправлять файл необходимо в качестве обычной сжатой картинки любого формата.

То есть сначала идет команда, а потом название, которое будет отображаться в меню бота. Однако, если их не указать в «BotFather», они всё равно будут работать, но пользователь не сможет узнать об их существовании.

  • «/deletebot» — позволяет удалить бота. Для удаления потребуется подтвердить серьезность намерений вводом ключевой фразы. Она будет отправлена в ответ после ввода команды.

    Подтверждение удаления бота ключевой фразой

Настройки

Этот блок позволяет настраивать основные параметры бота. Например, можно сгенерировать новый токен, если он был утрачен или попал в руки злоумышленников.

  • «/token» — отображает актуальный токен.
  • «/revoke» — выпускает новый токен. Обращайтесь с этой командой аккуратно: новый токен генерируется сразу, без дополнительных подтверждений, а старый перестаёт работать.
В сети интернет очень много текстового и видео материала по работе в сервисе BotFather. Если не нашли нужную информацию в данной инструкции, можете посмотреть в открытых источниках в сети интернет.

Что дальше