База знаний· Телеграм· Токен Telegram и изменение настроек бота

Телеграм

Токен Telegram и изменение настроек бота

Как пересоздать токен, поменять имя или username бота, обновить аватарку и описание. Безопасное обращение с токеном и что делать, если он попал в чужие руки.

Токен — это «пароль» вашего Telegram-бота. Управление токеном, именем и оформлением бота происходит через @BotFather — официального бота Telegram. ЭТОЧАТБОТ только использует токен, но не выдаёт его и не меняет имя бота за вас.

Что такое токен

Токен — длинная строка вида 1234567890:AAExxxxxxxxxxxxxxxxxxxxxxx. Она даёт полный контроль над ботом:

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

Поэтому: никому не передавайте токен. Кроме формы подключения в ЭТОЧАТБОТЕ.

Где посмотреть текущий токен

Откройте Telegram → @BotFather → команда /mybots → выберите бота → «API Token». Telegram покажет токен.

Не делайте скриншот этой страницы

На скриншотах токен «утекает» чаще всего. Если уже сделали скриншот и куда-то отправили — сразу пересоздайте токен (см. ниже).

Пересоздать токен (revoke)

Если есть подозрение, что токен в чужих руках — нужно его отозвать.

  1. @BotFather → /mybots → выберите бота → «API Token».
  2. Нажмите «Revoke current token».
  3. Подтвердите.

Старый токен мгновенно перестаёт работать. Telegram сразу же показывает новый.

После этого:

  1. Скопируйте новый токен.
  2. Войдите в ЭТОЧАТБОТсписок ботов → откройте нужного бота.
  3. В левом меню — «Настройки» → карточка «API-токен» → «Сменить токен».
  4. Вставьте новый токен и подтвердите.

Бот мгновенно начнёт работать с новым токеном — переписки и сценарии не теряются.

Что произойдёт со старым токеном

Если у кого-то был старый токен — он сразу же перестанет работать. Это лучшая защита от утечки.

Изменить имя бота

Имя — это то, что клиент видит в шапке диалога: «Бот ЭТОЧАТБОТ».

  1. @BotFather → /setname → выберите бота → введите новое имя.
  2. Telegram применит мгновенно. В ЭТОЧАТБОТЕ имя обновится в течение нескольких минут (мы периодически синхронизируемся с Telegram).

Изменить username

Username — это @etochat_bot, по которому бота находят в поиске.

  1. @BotFather → /setusername → выберите бота → введите новый username.
  2. Должен заканчиваться на _bot или bot, быть свободным.

Старый username освободится

Через какое-то время старый username может занять кто-то другой. Если у вас есть промо-материалы со старым username — лучше не менять, или меняйте только при крайней необходимости.

Аватарка бота

@BotFather → /setuserpic → выберите бота → отправьте картинку.

Хороший аватар:

  • Квадратный, минимум 640×640 px.
  • Узнаваемый — логотип или иконка проекта.
  • Контрастный — он маленький в списке диалогов клиента.

Описание

Два разных текста:

  • About text (/setabouttext) — короткий текст, показывается на странице бота над описанием. До 120 символов.
  • Description (/setdescription) — более длинный текст, показывается при первом открытии бота. До 512 символов.

Совет

Опишите коротко: «Что я делаю?» и «Что клиент получит, нажав Start?». Это первое впечатление — оно сильно влияет на конверсию /start.

Категория бота

@BotFather → /setcommands (это для команд) и /setdescription. Прямой «категории» нет, но через @BotFather можно настроить много мелочей: эмодзи в имени, тему-«группу», список рабочих команд.

Сменили владельца Telegram-аккаунта

Если бот переходит к другому человеку (вы передаёте проект): в Telegram это делается через /transfer в @BotFather (если функция доступна) или через техподдержку Telegram. Это длительный путь — лучше держать одного владельца Telegram-аккаунта с ботом, а доступ к ЭТОЧАТБОТУ передавать через команду.

Удалить бота

  1. @BotFather → /deletebot → выберите бота → подтвердите.
  2. Telegram удалит бота навсегда. Username освободится.
  3. В ЭТОЧАТБОТЕ откройте список ботов → удалите карточку этого бота (или оставьте — сообщения никуда не пропадут, просто бот будет «недоступен»).

Что дальше

Не нашли ответ?

Напишите в поддержку — подскажем по шагам в рабочее время.