Перейти к основному контенту

Токен бота

Токен бота — это уникальный ключ доступа, который связывает бота с API Telegram. Если бот перестал отвечать на команды или выдаёт системные ошибки, причина может быть в недействительном токене. В этой статье разбираем, что такое токен, как определить его недействительность и как заменить через @BotFather и WinWinBot.

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

Токен — это секретный ключ, который выдаёт Telegram через @BotFather при создании бота. Он необходим для авторизации бота в системе Telegram и подключения к API для отправки сообщений и обработки команд.

Токен выглядит как строка из цифр, букв и символов:

1234567890:ABCdefGHIJKlmNoPQRsTuVWXYz

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

Причины неисправности токена

Ручное аннулирование токена. Вы или пользователь с доступом к @BotFather нажали на кнопку Revoke. Старый токен становится недействительным.

Утечка токена. Токен попал в открытый доступ — публичный код на GitHub, форумы, переписки. Telegram автоматически блокирует скомпрометированные токены.

Бот долго не использовался. Если бот неактивен несколько месяцев, Telegram может деактивировать токен.

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

Технические проблемы. Временные сбои серверов Telegram. Токен остаётся валидным, но API может не отвечать несколько часов.

Ошибки в коде. Частые неавторизованные запросы с неверным токеном могут привести к блокировке.

Признаки неисправности токена

Если бот перестал работать, проверяем признаки недействительного токена:

  • бот не отвечает на команды, хотя раньше работал корректно;
  • рассылки не отправляются, сценарии стоят на паузе или просрочены;

  • в логах появились ошибки: Unauthorized, 403 Forbidden, Invalid token;
  • при API-запросе приходит ответ invalid token;
  • бот есть в @BotFather, но неактивен в чатах.

Индикатор в WinWinBot

Платформа WinWinBot автоматически отслеживает валидность токена. При возникновении проблемы в личном кабинете появляется индикатор недействительного токена в разделе Мои чат-боты.

Получение нового токена в @BotFather

  1. Открываем @BotFather в Telegram.
  2. Вводим команду /mybots и выбираем бота из списка.
  3. Нажимаем кнопку API Token.
  4. BotFather отправляет сообщение с текущим токеном.
  5. Нажимаем кнопку Revoke current token.
  6. BotFather отправляет новый токен.
  7. Копируем новый токен.

Старый токен перестаёт работать сразу после сброса. Новый токен начинает действовать через несколько минут.

Замена токена в WinWinBot

После получения нового токена обновляем его в настройках WinWinBot.

  1. Открываем бота в личном кабинете WinWinBot.
  2. Переходим в раздел Настройки бота → Токен.
  3. Вставляем новый токен в поле Токен и проверяем корректность ввода.
  4. Нажимаем Сохранить.
  5. Перезапускаем бота, если требуется.
  6. Тестируем работу бота.

Убедитесь, что токен введён без пробелов и посторонних символов. Даже один лишний символ приведёт к ошибке авторизации.

Как избежать проблем с токеном

Соблюдаем правила безопасности для защиты токена от утечки и блокировки:

  • не публикуем токен в открытом доступе — коде на GitHub, форумах, переписках;
  • храним токен в защищённых местах — переменных окружения, менеджерах паролей;
  • регулярно используем бота — минимум раз в месяц;
  • соблюдаем правила Telegram для ботов — не рассылаем спам и не нарушаем условия использования;
  • периодически проверяем работоспособность бота через тестовые команды.

Следующие шаги

После замены токена бот должен работать корректно. Если проблемы остались, проверяем логи API и настройки сценариев в WinWinBot.

Обращение в поддержку Telegram

Если токен заблокирован ошибочно, обращаемся в поддержку Telegram:

  • для общих вопросов: Settings → Ask a Question в приложении Telegram;
  • при ошибочной блокировке: бот @SpamBot или email recover@telegram.org;
  • при нарушении авторских прав или запрещённого контента: abuse@telegram.org.

Обращение рассматривается в течение 2–3 дней. Telegram снимает ограничения, если алгоритм ошибочно определил нарушение.

Дополнительные ресурсы

Наверх