2 октября 2026 г.

Telegram Unauthorized и TokenValidationError: бот не принимает токен

Бот падает сразу при старте с TelegramUnauthorizedError: Unauthorized, telegram.error.InvalidToken, TokenValidationError: Token is invalid! или просто 401 Unauthorized. Telegram отказывается разговаривать с этим токеном.

Что значит эта ошибка

Токен бота — это и логин, и пароль одновременно. Ошибок тут две разных:

• TokenValidationError (aiogram) или InvalidToken — библиотека даже не стала отправлять запрос: строка не похожа на токен. Часто это значит, что токена нет вообще: в код пришло None.
• Unauthorized / 401 — запрос ушёл в Telegram, и тот ответил: такого токена нет. Он неверный или отозван.

Причины по убыванию вероятности

1. Переменная в коде называется иначе. В коде os.getenv("TOKEN") или os.getenv("API_TOKEN"), а на сервере задана BOT_TOKEN. getenv молча возвращает None, и библиотека падает на проверке.
2. Токен брался из .env, а .env не попал на сервер. И правильно, что не попал: секретам не место в git. Но тогда load_dotenv() ничего не находит, и снова None.
3. Токен скопирован с мусором: пробел или перенос строки в конце, кавычки вокруг, обрезан последний символ.
4. Токен отозван. Вы (или кто-то с доступом) нажали /revoke в @BotFather. Старый токен перестаёт работать мгновенно.
5. Токен от другого бота или тестового сервера Telegram.

Как исправить

1. Проверьте сам токен одной командой. Если он живой, Telegram вернёт имя бота:

   curl "https://api.telegram.org/bot<ТОКЕН>/getMe"

   "ok":true — токен в порядке, проблема в том, как он попадает в код. 401 — возьмите новый токен в @BotFather (/mybots → бот → API Token).
2. Сверьте имя переменной в коде с тем, что задано на сервере. Надёжнее читать токен так, чтобы при пустом значении бот сразу сказал, в чём дело:

   import os
   TOKEN = os.getenv("BOT_TOKEN")
   if not TOKEN:
       raise SystemExit("Не задан BOT_TOKEN")

3. Уберите пробелы на всякий случай: os.getenv("BOT_TOKEN", "").strip().
4. Если токен когда-то лежал прямо в коде публичного репозитория — сделайте /revoke и выпустите новый. Боты сканируют GitHub на токены за минуты.

Как это устроено в botdepo

Токен бота, который вы вводите при создании, попадает в контейнер как переменная окружения BOT_TOKEN. Читайте его через os.getenv("BOT_TOKEN"). Если в коде переменная называется иначе, проще добавить её в «Переменные окружения» под нужным именем. Если бот упадёт с Unauthorized, в логе рядом с ошибкой будет подсказка и ссылка на этот разбор. Задеплоить бота.

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