Как настроить бота в BotFather

Создать бота в @BotFather можно за минуту: команда /newbot, имя, username, токен. Это мы разбирали отдельно: как создать бота в Telegram через BotFather. Здесь следующий шаг: настройки. От них зависит, что клиент видит до первого сообщения, какие команды стоят в меню и может ли бот работать в группе.

Коротко

• Все настройки собраны в /mybots: выбираете бота, дальше кнопки Edit Bot (имя, описание, аватар, команды) и Bot Settings (группы, приватность, кнопка меню, платежи).
• До первого сообщения клиент видит имя, аватар и описание «Что умеет этот бот?». Это и есть витрина бота.
• Приветствие после нажатия «Запустить» BotFather не задаёт. Его отправляет программа, подключённая к боту.
• В группе бот по умолчанию видит не все сообщения: так работает режим приватности.

Как открыть настройки

Найдите @BotFather с синей галочкой и отправьте /mybots. Выберите бота, и BotFather покажет кнопки:

• Edit Bot: имя, описание, короткое описание, аватар, команды;
• Bot Settings: группы, режим приватности, кнопка меню, встроенный режим, платежи;
• API Token: показать токен или выпустить новый;
• Delete Bot: удалить бота насовсем.

Те же настройки доступны отдельными командами, их мы перечисляем ниже. У BotFather есть и мини-приложение с теми же настройками в более привычном виде, оно открывается из чата с ним.

Что клиент видит до первого сообщения

Описание работает как вывеска. Человек открыл бота и решает, нажимать ли «Запустить». Напишите, что бот делает и с чего начать: «Подскажу цены и запишу на стрижку. Нажмите «Запустить» и напишите, на когда хотите». Описание и короткое описание можно сделать на разных языках.

Имя пишите как название бизнеса, а не «Бот-помощник»: в списке чатов клиент ищет вас по названию.

Приветствие на /start BotFather не задаёт

Частый вопрос: как в BotFather поставить сообщение, которое бот пришлёт после нажатия «Запустить». Никак. Нажатие «Запустить» отправляет боту команду /start, а отвечает на неё программа, подключённая к боту. BotFather отвечает только за то, что видно до этой кнопки.

Поэтому новый бот без программы молчит и на /start. Чтобы появилось приветствие, к токену бота подключают программу или сервис, который ответит.

Меню команд: /setcommands

Команды это список, который клиент видит, когда набирает / или нажимает кнопку меню рядом с полем ввода. Отправьте /setcommands, выберите бота и пришлите список по одной команде в строке в формате команда - описание:

price - Цены
booking - Записаться
address - Адрес и часы работы
manager - Позвать менеджера

Название команды пишется латиницей в нижнем регистре, можно цифры и подчёркивание, до 32 символов. Описание пишите по-русски, его видит клиент.

Как и с приветствием, BotFather хранит только список. Что ответить на /price, решает программа бота.

Кнопка меню. Слева от поля ввода у бота стоит кнопка меню. По умолчанию она показывает команды. В Bot Settings → Menu Button вместо этого можно открыть по ней мини-приложение, например страницу записи.

Бот в группах: /setjoingroups и /setprivacy

/setjoingroups разрешает или запрещает добавлять бота в группы. Если бот нужен только для личной переписки с клиентами, группы можно закрыть.

/setprivacy включает и выключает режим приватности. Он включён у всех ботов по умолчанию. В этом режиме бот видит в группе только адресованные ему команды и ответы на свои сообщения, а остальную переписку не получает. Бот, которого сделали администратором группы, видит все сообщения независимо от режима.

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

Токен: /token и /revoke

/token показывает текущий токен бота. Токен это ключ: кто его знает, тот читает сообщения бота и пишет от его имени. Если токен засветился в переписке или на скриншоте, отправьте /revoke: BotFather выпустит новый, а старый перестанет работать сразу. После этого вставьте новый токен туда, где бот подключён.

Бота можно передать другому владельцу: в /mybots у бота есть передача прав. Удаление /deletebot необратимо.

Остальные настройки

• Платежи (Bot Settings → Payments): подключение платёжного провайдера, если бот принимает оплату внутри Telegram. За цифровые товары и услуги Telegram принимает оплату звёздами (Telegram Stars).
• Встроенный режим (/setinline): бота можно вызвать в любом чате, набрав его username. Бизнес-боту обычно не нужен.
• Домен (/setdomain): нужен, если на сайте стоит вход через Telegram.
• Бизнес-аккаунт. Чтобы бот отвечал в чатах вашего бизнес-аккаунта Telegram, в BotFather у бота включают режим для бизнеса (в настройках он называется Secretary Mode), а владелец аккаунта выбирает в Telegram, к каким чатам у бота есть доступ.

Что после настройки

Настроенный бот выглядит готовым, но отвечать он начнёт, только когда к токену подключена программа. В DOS AI это делается без кода: Каналы → Telegram, вставляете токен из BotFather и нажимаете «Подключить». Команды /start и /help появятся у бота сами, а описание и короткое описание можно менять прямо из кабинета, не открывая BotFather. ИИ-ассистент отвечает по вашим ценам и правилам, понимает голосовые и фото, записывает на свободное время и складывает заявки в CRM. В группах он отвечает, когда к нему обращаются по имени или отвечают на его сообщение.

Telegram подключается бесплатно и без подписки. Вы платите только за ответы бота с баланса проекта: разговор с клиентом обычно стоит 5-18 центов. На старте на баланс приходят $5. Подробная инструкция с экранами: подключить Telegram.

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

Как сделать приветствие в Telegram-боте на /start?
В BotFather его нет. После «Запустить» бот получает команду /start, а текст приветствия отправляет подключённая программа или сервис. В BotFather задаётся только описание, которое человек видит до этой кнопки.

Почему бот не видит сообщения в группе?
У ботов по умолчанию включён режим приватности: в группе бот получает только адресованные ему команды и ответы на свои сообщения. Выключите его командой /setprivacy или сделайте бота администратором группы, затем удалите бота из группы и добавьте снова.

Сколько команд можно добавить в меню?
До 100. На практике хватает пяти-семи: клиент не читает длинное меню.

Чем описание отличается от короткого описания?
Описание (/setdescription, до 512 знаков) клиент видит в пустом чате до кнопки «Запустить». Короткое описание (/setabouttext, до 120 знаков) стоит в профиле бота и в превью, когда ссылку на бота пересылают.

Можно ли настроить бота с телефона?
Да. BotFather и его мини-приложение работают в любом приложении Telegram.

Что делать, если токен попал в чужие руки?
Отправьте /revoke в BotFather и выберите бота. Старый токен перестанет работать сразу, новый нужно вставить туда, где бот подключён.

Подробнее: как создать бота через BotFather, почему бот в Telegram не отвечает, Telegram-бот для бизнеса, подключение Telegram.