Обновлено: октябрь 2026
Чтобы получить API ID и API Hash Telegram, нужно зайти на my.telegram.org, войти по номеру телефона и создать приложение в разделе API Development Tools. Вся процедура занимает 5–7 минут. В статье — пошаговый разбор с объяснением, зачем эти ключи нужны и как их не потерять.
TL;DR. API ID и API Hash — это два ключа, которые Telegram выдает при регистрации приложения на my.telegram.org. Без них не запустить ни бота через Telethon/Pyrogram, ни любую программу, работающую с вашим аккаунтом. Получить можно за 5 минут: номер телефона -> код из Telegram -> форма создания приложения -> копируете ключи.
Что такое API ID и API Hash и зачем они нужны
API ID — это числовой идентификатор вашего приложения. API Hash — секретный токен, который подтверждает, что запросы идут именно от вашего приложения. Вместе они заменяют «логин и пароль» для доступа к Telegram API.
API ID и API Hash Telegram нужны каждый раз, когда вы хотите написать программу, которая работает с вашим аккаунтом напрямую — не через обычный бот-токен, а через полноценный Telegram API. Разница принципиальная.
Обычный бот-токен (тот, что выдает @BotFather) дает доступ только к боту. А вот API ID с хешем открывают доступ к возможностям реального пользователя: читать сообщения в любых чатах, отправлять файлы, управлять каналами, скачивать медиа. Именно поэтому их используют в библиотеках Telethon и Pyrogram для создания так называемых user bot-ов.
| Тип ключа | Где получить | Для чего |
|---|---|---|
| Bot Token | @BotFather в Telegram | Управление ботом |
| API ID + API Hash | my.telegram.org | Доступ к аккаунту через Telegram API |
| Session string | Генерируется в коде | Авторизация без повторного ввода кода |
На практике токен telegram API в формате API ID + Hash нужен для: автоматизации действий в аккаунте, парсинга каналов и групп, создания скриптов на Python с Telethon, интеграции Telegram с внешними сервисами.
Шаг 1. Как зайти на my.telegram.org и войти по номеру телефона
Откройте my.telegram.org в браузере, введите номер телефона с кодом страны и вставьте код из Telegram-аккаунта. После этого попадете в панель управления приложениями.
Переходите прямо по адресу my.telegram.org — это официальный сайт Telegram для разработчиков. Никаких сторонних сервисов не нужно.
На открывшейся странице одно поле — номер телефона. Вводите в формате с кодом страны: для России это +7, дальше номер без пробелов и дефисов. Нажимаете «Next».
Telegram мгновенно пришлет код в ваше приложение — не SMS, а именно сообщение от официального бота в самом Telegram. Открываете мессенджер, копируете пятизначный код, вставляете на сайте и нажимаете «Sign In».
Вот и всё. Вы внутри.
Важный момент: многие рекомендуют использовать не основной аккаунт, а отдельный. Если API ключи утекут — посторонний получит доступ к вашему аккаунту. Для тестовых проектов это особенно актуально.
Шаг 2. Как найти раздел API Development Tools
После входа на my.telegram.org нажмите на пункт «API Development Tools» — он находится в верхнем меню. Именно здесь создаются приложения и выдаются ключи.
После успешной авторизации видите несколько пунктов меню. Нажимаете API Development Tools — это первый и главный пункт. Откроется страница с формой создания приложения.
Если аккаунт новый и приложений еще не было — форма пустая. Если раньше уже создавали приложение, сразу увидите API ID и API Hash в верхней части страницы без необходимости заново создавать.
Здесь же можно выйти из аккаунта или удалить его — но это уже другая история.
Шаг 3. Как заполнить форму и создать приложение
Заполните поля App title и Short name любыми значениями на латинице. Выберите платформу Desktop. Поле Description можно оставить пустым. Нажмите «Create Application».
Форма создания выглядит так:
| Поле | Что писать | Пример |
|---|---|---|
| App title | Любое название на английском | MyApp |
| Short name | Минимум 5 символов, только буквы | myapp |
| URL | Можно пропустить или вписать любой | myapp.pro |
| Platform | Выбираете Desktop | Desktop |
| Description | Необязательно | test |
Название приложения не влияет на работу ключей — это просто метка для вас. Можете написать «test», «mybot», что угодно. Главное — соблюдать минимум 5 символов для Short name и не использовать спецсимволы.
После заполнения нажимаете Create Application.
Максим: «Ребят, это работает даже если написать в поле название "пример" — ключи выдаются одинаково, независимо от того, что вы там написали. Мы запускали GoBanana с API ключами, созданными буквально за 6 минут. Форма — это просто формальность.»
Шаг 4. Где найти и как сохранить API ID и API Hash
После создания приложения API ID и API Hash появятся в верхней части страницы. Скопируйте оба значения и сохраните в надежном месте — они не восстанавливаются.
Сразу после создания страница обновится. В самом верху увидите два значения:
- App api_id — числовой идентификатор (обычно 7–8 цифр)
- App api_hash — строка из букв и цифр длиной около 32 символов
Скопируйте оба. Хранить удобно в текстовом файле или в менеджере паролей. Некоторые создают файл .envсразу — и туда вписывают оба значения вместе с номером телефона:
TELEGRAM_API_ID=12345678
TELEGRAM_API_HASH=abc123def456...
TELEGRAM_PHONE=+79991234567Потерять API Hash практически невозможно — он всегда доступен на той же странице my.telegram.org при повторном входе. Но проще сохранить сразу.
Критически важно: API ID и API Hash дают тому, кто ими завладеет, доступ к вашему аккаунту. Не публикуйте их в открытых репозиториях, не отправляйте в чатах. Если ключи утекли — немедленно отзовите приложение на my.telegram.org и создайте новое.
Как использовать API ID и API Hash в Python
Полученные ключи вставляются в код как переменные. Для работы с Telegram API на Python чаще всего используют библиотеку Telethon — она принимает api_id и api_hash при инициализации клиента.
Получить api id и api hash telegram — это половина дела. Дальше их нужно применить. Простейший пример с Telethon:
from telethon import TelegramClient
api_id = 12345678
api_hash = 'ваш_хеш_здесь'
client = TelegramClient('session_name', api_id, api_hash)
async def main():
await client.start()
print("Подключились к Telegram")
with client:
client.loop.run_until_complete(main())
При первом запуске Telethon попросит номер телефона и код из Telegram — один раз. После этого создает файл сессии и больше не спрашивает, даже если деплоите на сервер.
Pyrogram работает по той же схеме, но его разработчики официально объявили об остановке поддержки. Для новых проектов лучше использовать Telethon.
| Библиотека | Статус | Подходит для |
|---|---|---|
| Telethon | Активно поддерживается | User bot, парсинг, автоматизация |
| Pyrogram | Не поддерживается | Устаревшие проекты |
| python-telegram-bot | Активно | Обычные боты через Bot API |
Частые ошибки при получении API ключей
Большинство проблем связаны с форматом номера телефона или блокировкой аккаунта. Новый аккаунт Telegram не позволяет сразу получить ключи — нужно немного поработать в приложении.
Несколько ситуаций, с которыми чаще всего сталкиваются:
Код не приходит. Убедитесь, что вводите номер с кодом страны. Для России: +7 и дальше 10 цифр без пробелов. Код приходит именно в Telegram-приложение, не на телефон.
Ошибка «This phone number is banned». Свежие аккаунты, зарегистрированные только что, иногда не дают создать приложение. Telegram требует небольшой «истории» использования. Подождите день-два и попробуйте снова.
Short name слишком короткий. Поле Short name принимает минимум 5 символов. Это частая ошибка — люди пишут трех-четырехбуквенные названия и получают ошибку.
«Кнопка Create Application не активна». Скорее всего, не заполнено одно из обязательных полей. Проверьте App title и Short name.
Потеряли API Hash. Зайдите заново на my.telegram.org -> API Development Tools. Хеш отображается там же. Новый создавать не нужно.
Безопасность: что делать, если ключи утекли
Если API ID и API Hash попали к третьим лицам — немедленно зайдите на my.telegram.org, удалите текущее приложение и создайте новое. Старые ключи после удаления перестанут работать.
Это реальный риск. Если ключи утекли в публичный GitHub-репозиторий или в чат — нужно действовать быстро.
Алгоритм такой:
- Заходите на my.telegram.org
- API Development Tools -> находите своё приложение
- Прокручиваете вниз, нажимаете Delete application
- Создаете новое приложение с новыми ключами
- Обновляете ключи во всех своих проектах
Дополнительно — проверьте активные сессии в Telegram: Настройки -> Конфиденциальность и безопасность -> Активные сессии. Если видите незнакомые устройства — завершите их.
Для хранения ключей в продакшн-проектах используйте переменные окружения или секреты платформы (Railway Secrets, Vercel Environment Variables и так далее). Никогда не хардкодьте их прямо в код.
FAQ
Сколько API приложений можно создать на один аккаунт? По умолчанию Telegram позволяет создать одно приложение на аккаунт. Этого достаточно для большинства задач — один набор ключей можно использовать в нескольких проектах одновременно.
Нужно ли пересоздавать ключи для каждого проекта? Нет. Один API ID и API Hash работают в любом количестве проектов и скриптов. Создавать новое приложение нужно только если старые ключи были скомпрометированы.
Можно ли получить API ID без номера телефона? Нет. my.telegram.org требует авторизации через реальный номер телефона, привязанный к Telegram-аккаунту. Без этого ключи не выдаются.
Чем API ID и Hash отличаются от Bot Token? Bot Token выдает @BotFather и дает доступ только к боту. API ID и Hash — это ключи уровня аккаунта, они открывают полный доступ к Telegram API от имени обычного пользователя. Именно поэтому их нужно хранить особенно аккуратно.
Что такое Telethon и нужен ли он для работы с API? Telethon — Python-библиотека, которая упрощает работу с Telegram API. Без неё пришлось бы самостоятельно реализовывать протокол MTProto. При первом запуске Telethon запросит API ID, API Hash и номер телефона, после чего создаст файл сессии для последующих подключений без повторной авторизации.
Можно ли использовать чужой тестовый аккаунт для получения ключей? Технически — да, но это плохая практика. Ключи привязаны к аккаунту, и если владелец удалит приложение или аккаунт — ваши проекты перестанут работать. Всегда используйте собственный аккаунт.
Можно ли получить API ID на телефоне, а не на компьютере? Да. my.telegram.org открывается в любом браузере, включая мобильный. Процесс полностью идентичен — разница только в размере экрана.
Что дальше
Получили ключи — отлично. Теперь их можно применить: посмотрите каталог AI-инструментов на VibeCoderz — там собраны инструменты, которые реально используют в автоматизации с Telegram.
Если хотите разобраться, как встроить Telegram API в свой проект или автоматизировать работу с ботами — запишитесь на консультацию к Максиму. Он прошел этот путь на реальных проектах с сотнями тысяч пользователей.
Материал обновлен: октябрь 2026. Данные актуальны на момент публикации.