Сообщить об ошибке.

Команды и оповещения @BotFather в Telegram

Для создания нового бота необходимо использовать команду /newbot. @BotFather запросит имя бота и имя пользователя бота (логин), а затем сгенерирует токен авторизации для вашего нового бота.

Имя бота отображается в контактных данных и в других местах.

Имя пользователя бота - это логин бота и представляет из себя короткое имя, которое будет использоваться в упоминаниях и ссылках на t.me. Обратите внимание, что в дальнейшем имя пользователя изменить нельзя! Имена пользователей (логины) состоят из 5–32 символов и нечувствительны к регистру, и могут включать только латинские символы, числа и символы подчеркивания. Имя пользователя бота должно заканчиваться на bot, например tetris_bot или TetrisBot.

Токен представляет собой строку типа 110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw, которая требуется для авторизации бота и отправки запросов в API бота. Держите свой токен в безопасности и храните его, он может быть использован кем угодно для управления вашим ботом.

Пересоздание токена авторизации Telegram бота.

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

Команды @BotFather

  • /mybots - возвращает список ваших ботов с удобными элементами управления для редактирования их настроек.
  • /mygames - делает то же самое для ваших игр

Команды редактирования Telegram бота:

  • /setname - изменить имя вашего бота.
  • /setdescription - изменить описание бота, текст до 512 символов, описывающий бота. Пользователи увидят этот текст в начале разговора с ботом, озаглавленный "What can this bot do?".
  • /setabouttext - изменить информацию о боте, более короткий текст до 120 символов. Пользователи увидят этот текст на странице профиля бота. Когда они делятся вашим ботом с кем-то, этот текст отправляется вместе со ссылкой.
  • /setuserpic - изменить фото профиля бота.
  • /setcommands - изменить список команд, поддерживаемых ботом. Пользователи будут видеть список команд всякий раз, когда они набирают '/' в разговоре с вашим ботом. Каждая команда имеет имя (должно начинаться с косой черты ‘/’, буквенно-цифровое значение плюс подчеркивание, не более 32 символов, без учета регистра), параметры и текстовое описание.
  • /deletebot - команда удаляет бота и освобождает его логин.

Команды изменения настроек Telegram бота.

  • /setinline - переключает встроенный режим запросов для бота.
  • /setinlinegeo - запрашивает данные о местоположении для предоставления встроенных результатов на основе местоположения.
  • /setjoingroups - переключатель, который отвечает за то, можно ли добавлять бота в группы или нет. Любой бот должен уметь обрабатывать личные сообщения, но если создаваемый бот не предназначен для работы в группах, то можно отключить этот режим.
  • /setprivacy - установить, какие сообщения будет получать бот при добавлении в группу. Если режим конфиденциальности отключен, то бот будет получать все сообщения. Мы рекомендуем оставить режим конфиденциальности включенным. Вам нужно будет повторно добавить бота в существующие группы, чтобы это изменение вступило в силу.

Команды управления играми.

  • /newgame - создать новую игру.
  • /listgames - получить список ваших игр.
  • /editgame - редактировать игру.
  • /deletegame - удалить существующую игру.

Обратите внимание, что изменения вступят в силу не сразу, а через несколько минут.

Ограничения и предупреждения о статусе Telegram бота.

Миллионы выбирают Telegram за его скорость. Чтобы оставаться конкурентоспособным в этой среде, ваш бот также должен быть быстрым. Чтобы помочь разработчикам поддерживать своих ботов в форме, @BotFather отправляет оповещения о статусе, если видит, что что-то не так.

Telegram будет проверять количество ответов и коэффициент конверсии запросов/ответов для популярных ботов (300 запросов в минуту: это значение может измениться в будущем). Если имеем аномально низкие показания, то получим уведомление от @BotFather.

Ответы на предупреждения.

По умолчанию вы будете получать только одно предупреждение на одного бота в час. Каждое предупреждение имеет следующие кнопки:

  • Fixed. Используйте эту кнопку, если обнаружили проблему с вашим ботом и исправили ее. Если нажать на кнопку Fixed, то отправку предупреждений в обычном режиме возобновится, для того чтобы увидеть, сработало ли исправление в течение 5–10 минут, вместо того, чтобы ждать час.
  • Support. Используйте эту кнопку, чтобы открыть чат с @BotSupport, если не видите проблем с ботом или считаете, что проблема на стороне Telegram.
  • Mute for 8h/1w. Используйте кнопку, если нет возможности исправить бота в данный момент. Это отключит все предупреждения для рассматриваемого бота за указанный период времени. Мы не рекомендуем использовать эту опцию, поскольку пользователи могут перейти на более стабильный бот. Можно включить оповещения в настройках своего бота через @Botfather.

Отслеживаемые проблемы Telegram бота.

В настоящее время Telegram будет уведомлять о следующих проблемах:

  1. Too few private messages are sent compared to previous weeks: {value}.

    Бот отправляет гораздо меньше сообщений, чем в предыдущие недели. Такие уведомления полезны для ботов в стиле новостной рассылки, которые рассылают сообщения без возможности получения ответов от пользователей. Чем больше значение, тем значительнее разница.

  2. Too few replies to incoming private messages. Conversion rate: {value}.

    Бот не отвечает на все сообщения, которые ему отправляются (коэффициент конверсии запроса/ответа для бота был слишком низким по крайней мере в течение двух из последних трех 5-минутных периодов). Чтобы обеспечить хороший пользовательский опыт, пожалуйста, отвечайте на все сообщения, которые отправляются вашему боту.

  3. Too few answers to inline queries. Conversion rate: {value}.

    Бот не отвечает на все встроенные запросы, которые ему посылаются, рассчитанные таким же образом, как и выше. Отвечайте на обновления inline_query, вызывая answerInlineQuery.

  4. Too few answers to callback queries. Conversion rate: {value} или Too few answers to callback game queries. Conversion rate: {value}.

    Бот не отвечает на все запросы обратного вызова, которые ему посылаются (с играми или без них), рассчитанные таким же образом, как и выше. Отвечайте на сообщения callback_query, вызывая answerCallbackQuery.

Обратите внимание, что функция оповещения о состоянии все еще тестируется и будет улучшена в будущем.