Bot domain invalid переводится с английского как «недопустимый домен бота» — это ошибка, которую выдаёт BotFather в Telegram при попытке привязать домен к боту через команду /setdomain. Чаще всего она появляется, когда введённый адрес не проходит проверку: указан протокол http://, лишний путь после домена, поддомен, который Telegram не принимает, или домен вообще не существует в DNS.
Ошибка не связана с неисправностью устройства или самого мессенджера — это валидация на стороне сервера Telegram. Ниже разберём, что именно проверяет BotFather, какие форматы доменов допустимы и как пошагово устранить проблему, если вы настраиваете авторизацию через Telegram Login Widget или привязываете сайт к боту.
Что означает ошибка bot domain invalid
Дословный перевод фразы: bot — бот, domain — домен, invalid — недействительный, некорректный. То есть Telegram сообщает, что доменное имя, которое вы отправили боту, не соответствует требованиям платформы и не может быть привязано.
Эта проверка нужна для безопасности: домен используется в механизме входа через Telegram на сайте, и платформа должна убедиться, что бот привязан к реальному, корректно оформленному адресу. Если формат нарушен, сервер отклоняет запрос ещё до каких-либо сетевых проверок.
Ошибка bot domain invalid означает, что формат домена не прошёл валидацию Telegram — проблема в написании адреса, а не в боте или аккаунте.
В каких ситуациях возникает ошибка
Типичный сценарий — разработчик настраивает виджет входа через Telegram на своём сайте и выполняет в диалоге с @BotFather команду /setdomain. После отправки домена в ответ приходит сообщение об ошибке. Реже ошибка встречается при работе через Bot API, когда домен передаётся программно.
Причины, которые чаще всего приводят к отказу:
- 🔹 Домен указан с протоколом — например,
https://example.comвместо простоexample.com. - 🔹 В адрес включён путь или слэш —
example.com/page, что недопустимо. - 🔹 Использован поддомен или формат, который Telegram в данном контексте не принимает.
- 🔹 В строке есть опечатка, пробел, кириллический символ вместо латинского.
- 🔹 Домен не зарегистрирован или не резолвится в DNS.
Как правильно указать домен в BotFather
Основное правило: отправляйте чистое доменное имя без протокола, без www, без путей и параметров. Правильный вид — example.com. Если сайт работает по HTTPS, это не нужно указывать: Telegram сам работает с защищённым соединением, а в команде требуется только имя хоста.
/setdomain
example.com
Последовательность действий выглядит так:
- ✅ Откройте диалог с @BotFather и выберите нужного бота через
/mybots. - ✅ Найдите пункт настроек домена или отправьте команду
/setdomain. - ✅ Введите домен строго в формате
example.com— без http, без слэшей. - ✅ Убедитесь, что сайт на этом домене реально открывается и DNS-записи настроены.
☑️ Проверка перед отправкой домена
⚠️ Внимание: не путайте привязку домена к боту с настройкой вебхука. ДляsetWebhookв Bot API, наоборот, требуется полный URL с протоколомhttps://. Форматы в этих двух механизмах различаются, и смешение их — частая причина путаницы.
Проверка DNS и доступности сайта
Даже корректно написанный домен будет отклонён, если он не существует. Перед отправкой команды откройте адрес в браузере: сайт должен загружаться. Если домен только что зарегистрирован, DNS-записи могут ещё распространяться — в этом случае имеет смысл подождать и повторить попытку позже.
Проверить резолвинг домена можно стандартными средствами системы. Например, в терминале:
nslookup example.comЕсли команда возвращает IP-адрес, домен резолвится. Если приходит ошибка NXDOMAIN или таймаут — проблема на стороне DNS-настроек регистратора или хостинга, и Telegram здесь ни при чём.
Типичные форматы: что принимается, а что нет
Чтобы было проще сориентироваться, сведём распространённые варианты в таблицу. Учтите, что точные правила валидации могут меняться со стороны Telegram, поэтому при сомнениях сверяйтесь с актуальной документацией Bot API.
| Что введено | Результат | Причина |
|---|---|---|
example.com | Принимается | Корректный формат чистого домена |
https://example.com | Отклоняется | Лишний протокол в строке |
example.com/login | Отклоняется | Путь после домена недопустим |
example .com | Отклоняется | Пробел внутри доменного имени |
несуществующий-домен.test | Отклоняется | Домен не резолвится в DNS |
Скопируйте домен в текстовый редактор и внимательно проверьте каждый символ: визуально похожие кириллические «а», «е», «о» вместо латинских — частая скрытая причина отказа, особенно при копировании адреса из документов.
Если ошибка сохраняется после всех проверок
Когда формат точно правильный, а домен открывается в браузере, но BotFather продолжает отвечать отказом, возможна задержка на стороне самого Telegram. В такой ситуации разумно подождать некоторое время и повторить команду, а также попробовать привязать домен заново через меню настроек бота, а не текстовой командой.
Отдельный случай — поддомены: для Telegram Login Widget привязывается основной домен, и авторизация затем работает на нём и его поддоменах. Если вы пытаетесь привязать именно поддомен и получаете отказ, попробуйте указать корневой домен — во многих сценариях это решает задачу без дополнительных настроек.
⚠️ Внимание: не используйте сторонние сервисы и «помощников», обещающих привязать домен за вас, — для команды /setdomain достаточно официального @BotFather. Передача токена бота третьим лицам даёт им полный контроль над ботом.
Почему Telegram вообще требует привязку домена
Домен нужен для работы Telegram Login Widget — кнопки «Войти через Telegram» на сайте. Привязка гарантирует, что данные авторизации пользователя передаются только на тот сайт, который владелец бота явно указал. Это защита от фишинга: сторонний сайт не сможет использовать вашего бота для сбора данных авторизации.
Похожие ошибки BotFather и их отличия
При настройке бота можно встретить и другие сообщения об ошибках, которые легко спутать с bot domain invalid. Например, ошибки при установке вебхука обычно связаны с SSL-сертификатом или недоступностью URL, а не с форматом домена. Сообщения о неверном токене указывают на проблему авторизации API-запроса.
Различать их важно, потому что методы решения разные: ошибка домена решается исправлением формата адреса, ошибка вебхука — настройкой сервера и сертификата, ошибка токена — перевыпуском токена через /revoke или /token у BotFather.
Bot domain invalid — это всегда вопрос формата или существования домена. Исправьте написание на чистый вид example.com, проверьте DNS — и ошибка в подавляющем большинстве случаев исчезает.
Частые вопросы
Как переводится bot domain invalid на русский?
Дословно — «недопустимый домен бота» или «некорректный домен бота». Telegram сообщает, что доменное имя, отправленное командой /setdomain, не прошло проверку формата или не существует.
Нужно ли указывать https:// при привязке домена?
Нет. В команде /setdomain указывается только чистое доменное имя, например example.com. Протокол, слэши и пути приводят к ошибке. Полный URL с https требуется только при настройке вебхука через Bot API.
Можно ли привязать поддомен к боту?
Рекомендуется привязывать корневой домен — тогда Telegram Login Widget будет работать и на его поддоменах. Если при указании поддомена возникает ошибка, попробуйте основной домен.
Домен правильный, но ошибка не уходит. Что делать?
Проверьте, что домен резолвится (команда nslookup или открытие сайта в браузере), убедитесь в отсутствии кириллических символов и пробелов, затем повторите попытку позже — возможна временная задержка на стороне Telegram.
Опасна ли эта ошибка для бота или аккаунта?
Нет, это штатное информационное сообщение валидатора. Бот, токен и аккаунт остаются в безопасности — просто домен не привязывается до исправления формата.