Чтобы импортировать посты из 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 — другие юзеры её увидеть не могут.
Если когда-то решите отозвать доступ — на странице my.telegram.org можно удалить приложение, после чего сессия станет невалидной.
Лимиты Telegram API
Telegram даёт каждому аккаунту примерно 1000 запросов в час на чтение. Для разового импорта 100-200 постов это запас в десять раз. Если делать массовый импорт по 10+ каналам за день — лимит может ограничить.
Что важно: лимиты считаются на ваш Telegram-аккаунт, а не на API ID. Если будете импортировать через несколько разных приложений с одного номера — лимит общий.
Если что-то не получилось
- Код из Telegram не приходит — проверьте, что вводите тот же номер, что в Telegram-приложении.
- API ID / Hash не работают — попробуйте создать новое приложение, иногда первое не сохраняется корректно из-за ошибок в полях.
- «Telegram-сессия не активирована» в MaxSurge — после ввода ключей зайдите в Форвардер и авторизуйте сессию (там код подтверждения).