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

Команды и оповещения @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.

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