Где взять Telegram API ID и Hash для импорта
Пошаговая инструкция получения API ID и Hash на my.telegram.org за 3 минуты. Безопасность, лимиты, типичные ошибки.
Чтобы импортировать посты из Telegram-канала в MAX, MaxSurge подключается к Telegram API от вашего имени — через персональные API ID и Hash. Это безопаснее общих ключей сервиса: у вас свои лимиты, изолированная сессия, никаких пересечений с другими юзерами.
Получение за 3 минуты
- Откройте my.telegram.org в браузере.
- Введите свой номер телефона (тот же, что использует ваш Telegram-аккаунт). На него придёт код в приложении Telegram — введите его.
- На главной странице выберите API development tools.
- В разделе Create new application заполните 4 поля:
- App title: любое имя, например «MaxSurge integration»
- Short name: короткое слово, например «maxsurge»
- URL: можно пропустить или указать
https://maxsurge.ru - Platform: Other
- Description: можно оставить пустым
- Нажмите Create application. На следующей странице вы увидите два значения:
- App api_id — число (обычно 7-8 цифр)
- App api_hash — длинная строка из букв и цифр
- Скопируйте оба значения и впишите в MaxSurge: Настройки → блок «Личные API-ключи» → раздел «Telegram API» → сохранить.
Безопасность
API ID и Hash сами по себе не дают доступа к вашему аккаунту — они только идентифицируют приложение. Реальный доступ создаётся при первой авторизации сессии в /app/forwarder/ (через код, который придёт в Telegram). Сессия хранится изолированно на нашем сервере под ключом tg_user_N — другие юзеры её увидеть не могут.
Чтобы отозвать доступ, откройте в официальном Telegram список устройств и завершите соответствующую сессию. Удаление API-ключей в настройках сервиса не подтверждает отзыв сессии.
Лимиты Telegram API
Фиксированного подтверждённого лимита чтения сервис не обещает. При ограничении остановите импорт и ориентируйтесь на ошибку и указанное время ожидания.
Что важно: лимиты считаются на ваш Telegram-аккаунт, а не на API ID. Если будете импортировать через несколько разных приложений с одного номера — лимит общий.
Если что-то не получилось
- Код из Telegram не приходит — проверьте, что вводите тот же номер, что в Telegram-приложении.
- API ID / Hash не работают — попробуйте создать новое приложение, иногда первое не сохраняется корректно из-за ошибок в полях.
- «Telegram-сессия не активирована» в MaxSurge — после ввода ключей зайдите в Форвардер и авторизуйте сессию (там код подтверждения).
Не получилось на одном из шагов?
Напишите в чат поддержки в кабинете или через форму: какой раздел открыли, что нажали, время и текст ошибки. На скриншоте скройте пароль, токен, QR-код и строку прокси. Не повторяйте операцию с неизвестным результатом.
Ответы на частые вопросы →