При попытке создать приложение на my.telegram.org пользователь чаще всего упирается в одну из двух проблем: код подтверждения не приходит в Telegram или после заполнения формы появляется ошибка ERROR без объяснения причин. Именно на этом этапе большинство разработчиков и владельцев ботов застревают, хотя путь к получению api_id и api_hash занимает несколько минут — если знать порядок действий и ограничения платформы.
Сервис my.telegram.org — это официальный портал Telegram для разработчиков, где выдаются ключи доступа к Telegram API (не путать с Bot API, который работает через @BotFather). Ключи нужны для сторонних клиентов, скриптов на библиотеках вроде Telethon или Pyrogram, парсеров и автоматизации. В этой статье разберём, как пройти регистрацию приложения, что делать при ошибках и как хранить ключи безопасно.
Что такое my.telegram.org и зачем нужен раздел Apps
Портал my.telegram.org выполняет две функции: управление аккаунтом (например, удаление профиля) и выдачу ключей разработчика через раздел API development tools. Нас интересует второй вариант. После авторизации по номеру телефона вы создаёте «приложение» — формальную запись, к которой привязываются пара чисел и строк.
Эти данные идентифицируют ваш софт перед серверами Telegram. Без них библиотеки вроде Telethon просто не смогут подключиться к API. Важно понимать: приложение на my.telegram.org — это не мобильная программа и не бот, а техническая сущность, своего рода «пропуск» для вашего кода.
- 🔑 api_id — числовой идентификатор приложения, не является секретом в строгом смысле.
- 🔐 api_hash — секретная строка, аналог пароля, её нельзя публиковать.
- 📱 Привязка к номеру — ключи выдаются на конкретный аккаунт Telegram навсегда.
- 🛠️ Назначение — сторонние клиенты, скрипты автоматизации, интеграции через MTProto.
Пошаговое создание приложения
Авторизация на портале происходит через номер телефона, к которому привязан аккаунт Telegram. Код подтверждения приходит не по SMS, а сообщением внутри самого Telegram — от официального сервисного уведомления. Это первый момент, где многие ошибаются, ожидая SMS на телефон.
После входа откройте раздел API development tools и заполните форму создания приложения. Полей немного, но к ним есть требования: название не должно быть слишком коротким и не должно содержать слово «Telegram» и его вариации — такие заявки система отклоняет.
☑️ Создание приложения на my.telegram.org
Если форма выдала ошибку, проверьте заполнение полей: App title и Short name обязательны, URL и описание можно оставить пустыми. Иногда помогает смена браузера или отключение блокировщиков — форма на портале капризна к блокируемым скриптам.
Типичные ошибки и их решения
Самая частая жалоба — не приходит код подтверждения. Проверьте папку с сервисными уведомлениями в Telegram: сообщение может быть от аккаунта «Telegram» с кодом для веб-входа. Если его нет, убедитесь, что вы вошли в аккаунт хотя бы на одном устройстве — код доставляется только в активные сессии.
⚠️ Внимание: код подтверждения для my.telegram.org действует как код входа в аккаунт. Никому не передавайте его — с ним злоумышленник получит доступ ко всей переписке, а не только к порталу разработчика.
Вторая распространённая ситуация — ошибка ERROR при отправке формы создания приложения. Точных причин Telegram не публикует, но на практике помогают следующие проверки: смена названия на более уникальное, заполнение полей латиницей, повтор попытки через некоторое время. Возможна также временная блокировка создания приложений на новых аккаунтах — официально это не подтверждено, поэтому точную причину назвать нельзя.
Где используются api_id и api_hash
Полученные ключи подставляются в конфигурацию библиотек, работающих с MTProto — протоколом Telegram. Например, в Telethon подключение выглядит так:
from telethon import TelegramClient
api_id = 123456
api_hash = "ваш_api_hash"
client = TelegramClient("session_name", api_id, api_hash)
Числовой api_id в примере — условный, подставьте собственное значение из личного кабинета. При первом запуске скрипт запросит код из Telegram — это нормальный процесс авторизации пользовательской сессии, а не ошибка.
Не путайте Telegram API с Bot API. Для обычного бота достаточно токена от @BotFather, и ключи с my.telegram.org ему не нужны. Ключи разработчика требуются, когда вы управляете пользовательским аккаунтом (юзербот) или пишете собственный клиент.
Сравнение способов доступа к API Telegram
| Способ | Что нужно | Для чего подходит | Ограничения |
|---|---|---|---|
| Bot API (@BotFather) | Токен бота | Чат-боты, уведомления | Только функции ботов |
| Telegram API (my.telegram.org) | api_id + api_hash | Клиенты, юзерботы, парсинг | Требует осторожности с лимитами |
| Telegram Login Widget | Бот + домен | Авторизация на сайте | Только вход пользователя |
| TDLib | api_id + api_hash | Собственные приложения | Нужна сборка библиотеки |
Выбор зависит от задачи. Для простого бота хватит Bot API, для чтения чатов от имени пользователя — только MTProto с ключами разработчика. TDLib — официальная библиотека для тех, кто пишет полноценный клиент.
Безопасность ключей и ограничения
Пара api_id/api_hash привязана к вашему аккаунту, и злоупотребления через неё могут привести к ограничениям для всего аккаунта. Telegram применяет автоматические лимиты на частоту запросов — при их превышении аккаунт получает временную ошибку FloodWait, а при систематических нарушениях возможна блокировка номера.
⚠️ Внимание: массовая рассылка сообщений через юзерботов с ключами my.telegram.org — прямой путь к перманентной блокировке аккаунта. Антиспам-система Telegram реагирует на жалобы получателей, и восстановить номер после такого бана практически невозможно.
Если ключи скомпрометированы, официальной кнопки «перевыпустить» на портале нет — приложение можно удалить и создать заново, но новая пара ключей будет другой, и её придётся обновить во всех своих скриптах. Поэтому профилактика утечек важнее реагирования.
Что делать, если api_hash попал в открытый доступ
Удалите приложение в разделе API development tools и создайте новое — старые ключи перестанут работать. Обновите ключи во всех скриптах и сервисах, где они использовались. Проверьте активные сессии в настройках Telegram (Настройки → Устройства) и завершите незнакомые.
FAQ: частые вопросы о my.telegram.org
Можно ли создать несколько приложений на один номер?
Да, на одном аккаунте можно зарегистрировать несколько приложений, у каждого будет своя пара api_id и api_hash. Это удобно для разделения тестовых и рабочих проектов.
Чем my.telegram.org отличается от BotFather?
@BotFather выдаёт токены для ботов через Bot API, а my.telegram.org — ключи для работы с полным Telegram API (MTProto). Это разные уровни доступа с разными возможностями.
Почему код приходит в Telegram, а не по SMS?
Так устроена авторизация на портале: код доставляется сервисным сообщением в активные сессии аккаунта. Поэтому перед входом на my.telegram.org нужно быть авторизованным в Telegram хотя бы на одном устройстве.
Можно ли использовать ключи на нескольких устройствах одновременно?
Да, одна пара ключей может использоваться в нескольких скриптах и сессиях. Ограничения касаются частоты запросов к API, а не количества подключений.
Что делать, если форма создания приложения постоянно выдаёт ERROR?
Попробуйте изменить название приложения, убрать спецсимволы, использовать латиницу, сменить браузер и повторить попытку позже. Если ошибка сохраняется на новом аккаунте, возможно, действует временное ограничение — точные критерии Telegram не раскрывает.