16 июля 2026 г.
Без VPN my.telegram.org не открывается, с VPN форма отвечает ERROR. Разбираю, почему так выходит, и даю рабочую последовательность для Windows и macOS: файл hosts, форма приложения, хранение ключей и что делать, если ошибка осталась.
Что такое api_id и api_hash и почему с VPN выходит ошибка
Коротко: это пара ключей, по которой Telegram узнаёт ваше приложение. Форма их выдачи падает, когда номер российский, а адрес подключения зарубежный.
У Telegram два способа работать с ним из кода. Бот получает токен у BotFather и видит только то, что пишут ему или в чатах, куда его добавили. Свой клиент работает от имени вашего аккаунта: читает чаты, где вы состоите, собирает сообщения в таблицу, готовит черновики ответов. Второму нужны api_id (число) и api_hash (длинная строка из букв и цифр). Их выдают на my.telegram.org, а дальше с ними работают библиотеки вроде Telethon и Pyrogram.
Если люди сами пишут вам, а скрипт отвечает, хватит бота, и эта инструкция не нужна. Если нужно читать чаты, куда бота не добавить, - читайте дальше.
Почему с VPN не выходит, Telegram официально не объясняет. Опыт тех, кто через это прошёл, сходится: мешает несовпадение региона. Номер на +7, а адрес у VPN нидерландский или немецкий. Код приходит, форма отвечает ERROR или «[object Object]». Смена браузера и названия не помогает.
Без VPN сайт не открывается по другой причине: провайдер не отдаёт браузеру правильный адрес my.telegram.org. Это лечится одной строкой в файле hosts - в нём вы сами говорите компьютеру, где живёт сайт. После этого VPN для входа не нужен.
Как получить api id и api hash Telegram в России: подготовка
Коротко: девять из десяти неудач - недовыключенный VPN. Проверьте все пункты и убедитесь, что интернет российский.
- Программа VPN выключена. На Mac посмотрите строку меню вверху справа и «Системные настройки → VPN»: ни одно подключение не должно быть в статусе «Подключено».
- Расширение VPN в браузере выключено.
- Прокси выключен в настройках браузера и системы.
- Закрыты программы обхода блокировок: GoodbyeDPI, Zapret, Hiddify, v2RayTun, Happ, AmneziaVPN и похожие.
- В антивирусе на время выключено «защищённое соединение», если оно есть.
- Telegram открыт на телефоне или компьютере с тем номером, на который вы получаете ключи: туда придёт код.
Проверка. Откройте в браузере сайт 2ip.ru. Там должен быть российский провайдер и город. Видите Нидерланды, Германию или Финляндию - VPN ещё работает, ищите, что осталось включённым.
Номер берите свой и живой. Telegram предупреждает, что важные уведомления для разработчиков придут на номер, с которого создано приложение. Ключи нужны для второго, рабочего аккаунта - входите с номером именно этого аккаунта: у каждого аккаунта должен быть свой api_id.
Зачем вообще эта возня. Ключи открывают дорогу к инструментам, которые снимают с вас ручную работу: сбор заявок из профильных чатов, выгрузку обсуждений в таблицу, ассистента с черновиками ответов. Как из пары ключей собрать работающий инструмент без программиста, я показываю в вайбкодинге для контент-заводов.
Шаги на macOS
Коротко: три команды в Терминале - добавить строку, очистить кэш, проверить. Каждую команду копируйте целиком и вставляйте через Command + V.
Шаг 1. Откройте Терминал. Нажмите Command + Пробел, наберите «Терминал», нажмите Enter. Откроется окно с мигающим курсором.
Шаг 2. Добавьте строку в hosts. Скопируйте команду целиком, вставьте в Терминал и нажмите Enter:
echo "149.154.167.220 my.telegram.org" | sudo tee -a /etc/hosts
Терминал спросит Password. Это пароль, которым вы входите в свой Mac. Набирайте его вслепую: символы и звёздочки не появляются, так задумано. Нажмите Enter.
Что должно появиться: строка 149.154.167.220 my.telegram.org. Значит, она записана. Если написано Sorry, try again - пароль набран с ошибкой, наберите ещё раз.
Шаг 3. Очистите кэш адресов. Вставьте команду и нажмите Enter:
sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder
Терминал ничего не ответит или ещё раз спросит пароль. Это нормально.
Шаг 4. Проверьте, что компьютер видит новый адрес. Вставьте и нажмите Enter:
ping -c 1 my.telegram.org
Смотрите на первую строку: там должно быть PING my.telegram.org (149.154.167.220). Число в скобках совпадает - всё готово. Ниже может быть написано, что ответа нет, - это неважно, нам нужно только число. Если число другое или написано cannot resolve - повторите шаг 3 и перезагрузите Mac.
Шаг 5. Перезапустите браузер. Нажмите Command + Q, пока браузер активен. Красный кружок в углу закрывает только окно, а браузер продолжает жить со старым кэшем. Откройте браузер заново и переходите к входу на my.telegram.org.
Шаги на Windows 10 и 11
Коротко: дописать строку в hosts через Блокнот от администратора, очистить кэш, проверить и перезапустить браузер.
Шаг 1. Откройте Блокнот с правами администратора. Нажмите «Пуск», наберите «Блокнот», щёлкните по нему правой кнопкой и выберите «Запуск от имени администратора». На вопрос «Разрешить этому приложению вносить изменения?» ответьте «Да».
Шаг 2. Откройте файл hosts. В Блокноте: «Файл» → «Открыть». В адресную строку окна вставьте путь и нажмите Enter:
C:\Windows\System32\drivers\etc
Справа внизу окна переключите «Текстовые документы» на «Все файлы» - иначе нужного файла не видно. Выберите файл hosts и нажмите «Открыть».
Шаг 3. Допишите строку. Нажмите Ctrl + End - курсор уйдёт в конец файла. Нажмите Enter, чтобы начать новую строку, и вставьте:
149.154.167.220 my.telegram.org
Нажмите Ctrl + S. Если Блокнот предлагает сохранить копию в другую папку - он открыт без прав администратора, вернитесь к шагу 1.
Шаг 4. Очистите кэш адресов. «Пуск» → наберите «Командная строка» → правая кнопка → «Запуск от имени администратора». Вставьте и нажмите Enter:
ipconfig /flushdns
Должно появиться: «Кэш сопоставителя DNS успешно очищен».
Шаг 5. Проверьте адрес. В той же командной строке:
ping my.telegram.org
В первой строке в квадратных скобках должно стоять 149.154.167.220. Совпадает - готово.
Шаг 6. Перезапустите браузер целиком. Закройте все окна, затем откройте диспетчер задач (Ctrl + Shift + Esc) и убедитесь, что там нет процессов Chrome, Edge или Firefox. Откройте браузер заново.
Коротко: номер, код из Telegram, раздел API development tools, форма латиницей - и ключи сразу на экране. VPN всё ещё выключен.
Шаг 1. Откройте my.telegram.org. В поле Your Phone Number введите номер целиком, с +7, и нажмите Next.
Шаг 2. Код придёт сообщением внутри Telegram от официального аккаунта Telegram, СМС не будет. Введите его в поле Confirmation code и нажмите Sign In.
Шаг 3. На открывшейся странице нажмите API development tools. Если вместо формы сразу видны App api_id и App api_hash - приложение у этого номера уже есть, переходите к шагу 6.
Шаг 4. Заполните форму:
- App title - латиницей, без слова Telegram. Например, MyWorkTools.
- Short name - латиницей, без пробелов, от 5 символов. Например, myworktools.
- URL - оставьте пустым.
- Platform - Desktop.
- Description - одна фраза по-английски. Например, Personal app for my own chats.
Не пишите в названии Telegram (это запрещено условиями API) и слова вроде Parser, Scraper, Sender, Spam: с ними форма чаще отказывает.
Шаг 5. Нажмите Create application внизу формы.
Шаг 6. На странице появились App api_id (число) и App api_hash (строка). Сразу перенесите оба в менеджер паролей.
Одному номеру положено одно приложение - второй раз форму заполнить не дадут, ключи будут ждать на той же странице.
Что сделать сразу после получения ключей
Коротко: убрать строку из hosts, включить VPN обратно, если он нужен, и один раз запустить скрипт, чтобы он создал сессию.
Шаг 1. Уберите строку из hosts. Адрес у Telegram может смениться, и забытая строка однажды сломает вход на сайт - а вы уже не вспомните, откуда она.
На Mac одной командой (спросит пароль от Mac):
sudo sed -i '' '/my.telegram.org/d' /etc/hosts
Затем снова очистите кэш той же командой, что в шаге 3:
sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder
Проверка: команда grep telegram /etc/hosts ничего не выводит - строки больше нет.
На Windows откройте hosts через Блокнот от администратора, как в шагах 1-2, удалите строку с my.telegram.org, сохраните и выполните ipconfig /flushdns в командной строке от администратора.
Шаг 2. Включите VPN обратно, если он нужен вам для работы. Ключи уже у вас.
Шаг 3. Положите ключи на место. Менеджер паролей и файл .env вашего проекта. Заметки телефона и «Избранное» не годятся. Посмотреть ключи снова можно, но для этого придётся опять пройти весь путь со строкой в hosts.
Шаг 4. Запустите скрипт в первый раз. Библиотека спросит номер телефона, код из Telegram и облачный пароль, если он включён. После этого рядом со скриптом появится файл сессии, и следующие запуски пройдут без кода.
Шаг 5. Загляните в Telegram на телефоне. Придёт служебное сообщение о входе с нового устройства, а в «Настройки → Устройства» появится новый сеанс. Это ваш скрипт. Если рядом есть сеанс, который вы не запускали, - завершите его сразу.
Как хранить ключи и сессию, чтобы не потерять аккаунт
Коротко: api_hash и файл сессии - секреты уровня пароля от банка. У кого они, тот работает в вашем аккаунте.
Сам по себе api_id не пароль. Но в паре с api_hash он даёт право запускать клиент от вашего имени, а файл сессии пускает в аккаунт без кода и облачного пароля. Мои правила:
- Никому не отправляю api_hash, облачный пароль, файл или строку сессии и код входа. Telegram в самом сообщении с кодом пишет, что его нельзя давать никому, даже тем, кто представляется сотрудником Telegram.
- Ключи лежат в файле .env, который не попадает в репозиторий. На GitHub, форумы и в скриншоты они не уходят.
- Файл сессии не лежит в облачных папках и закрыт правами доступа.
- Облачный пароль включён. Раз в неделю проверяю «Устройства» на чужие сеансы.
- У каждого аккаунта свой api_id, полученный с его же номера. Тестовые ключи из открытых примеров Telegram ограничивает, на них прилетает ошибка API_ID_PUBLISHED_FLOOD.
- Скрипт ходит в Telegram с одного постоянного адреса, без прыгающих VPN. Telegram пишет, что аккаунты неофициальных клиентов под наблюдением, а вход с нового зарубежного сервера и сразу массовое чтение чатов выглядят для него как угон. Тогда он сбрасывает сессии и может заморозить ботов этого аккаунта.
За флуд, спам и накрутку Telegram блокирует аккаунт навсегда. Условия API запрещают действовать от имени человека без его согласия и обучать нейросети на данных платформы. Свой ассистент, сбор заявок из чатов, где вы состоите, выгрузка в таблицу - нормальная работа. Массовые рассылки незнакомым людям - короткая дорога к бану.
Ключи - самая простая часть. Дальше начинается то, ради чего всё затевалось: что собрать, где это будет работать круглые сутки и как встроить в продажи. Какие нейросети ставить в такую связку, я разбирала в статье про нейросети для создания контента, а кому отдавать такие задачи, когда своих рук не хватает, - в статье про ИИ-специалиста для контент-завода. Если хотите разобрать свою задачу на живом примере, приходите на консультацию.
Если не получилось
Коротко: идите по списку сверху вниз, после каждого пункта пробуйте снова.
- Сайт не открывается совсем. Повторите проверку адреса (шаг 4 на Mac, шаг 5 на Windows). Число не то - строка не записалась или кэш старый: повторите очистку кэша и перезагрузите компьютер. Если число верное, а сайт всё равно не грузится, адрес мог смениться. Узнайте текущий командой nslookup my.telegram.org 1.1.1.1, удалите старую строку из hosts и добавьте новую с этим числом.
- Форма отвечает ERROR. Почти всегда что-то из VPN ещё работает. Снова откройте 2ip.ru и пройдите список из подготовки.
- ERROR остался при российском адресе на 2ip.ru. Перезагрузите компьютер: браузер иногда держит старое соединение. Затем попробуйте другой интернет - раздачу с телефона или другого оператора. Строку в hosts на это время не удаляйте.
- После ошибки обновите страницу API development tools. Приложение могло создаться, несмотря на ERROR.
- Замените название на самое простое, латиницей и без слов из правил выше.
- Код не приходит. Он приходит в Telegram, а не по СМС. Откройте Telegram на том номере, который ввели, и найдите сообщение от официального аккаунта Telegram.
- Аккаунт заблокировали, хотя правил вы не нарушали. Telegram предлагает написать на recover@telegram.org и объяснить, для чего вы используете API. Письма читает человек, поэтому пишите своими словами: шаблонные автописьма там распознают и блокируют.
Я, Анастасия Майер, собираю свои системы так, чтобы они работали без меня, и для задач в Telegram дорога к такой системе часто начинается именно с этой формы. Если хотите собирать такие вещи вместе с людьми, которые делают то же самое, загляните в мастер-группу Майер: там мы разбираем свои связки и ошибки.
Источники
- Telegram, официальная инструкция Creating your Telegram Application: шаги получения api_id и api_hash, одно приложение на номер, тестовые ключи и ошибка API_ID_PUBLISHED_FLOOD, вечный бан за флуд и спам, адрес recover@telegram.org.
- Telegram, условия использования API: свой api_id для своего приложения, запрет слова Telegram в названии, действия только с согласия пользователя, запрет обучать нейросети на данных платформы.
- Адрес my.telegram.org сверен через публичные DNS 1.1.1.1, 8.8.8.8 и 9.9.9.9 в октябре 2026 года.
- Мои правила работы с ключами и сессиями Telegram на собственных инструментах.
- Раздел «Вайбкодинг для контент-заводов» на сайте.