Что такое Telegram Session+Json и как его использовать? Полное руководство

"Файл сессии Telegram (.session) — это база данных SQLite, которая хранит учетные данные аутентификации, включая ключ авторизации, адрес сервера и данные пользователя. В сочетании с JSON-файлом метаданных, содержащим app_id, app_hash и номер телефона, это обеспечивает полный доступ к API через MTProto." — Справочник Telegram API Documentation.

Вы написали парсер, которому нужно проверять 500 Telegram-групп каждый час. Или создаете бота для уведомлений вашего SaaS-продукта. Единственное, что стоит между вами и рабочим кодом — это файл .session.

Библиотеки Python, такие как Telethon и Pyrogram, аутентифицируются исключительно через файлы .session. Это руководство рассказывает, что такое Session+Json, как загрузить его в ваши скрипты и что приводит к блокировке аккаунтов (и как этого избежать).

Нужны Telegram-аккаунты для автоматизации? На accs.tg вы можете купить Telegram-аккаунты Session+Json, готовые к использованию с Telethon и Pyrogram. Мгновенная доставка с соответствующими метаданными. Посмотреть каталог →

Что такое Telegram Session+Json?

Session+Json — это формат из двух файлов, который хранит всё необходимое для аутентификации аккаунта Telegram через MTProto API. В отличие от Tdata (который работает с Telegram Desktop), Session+Json предназначен для автоматизации через код.

  • .session файл — База данных SQLite, хранящая ключ авторизации, серверную соль и состояние соединения. Telethon и Pyrogram читают этот файл, чтобы продолжить сессию без кода входа.
  • .json файл метаданных — Обычный JSON с app_id, app_hash, номером телефона и опциональным паролем 2FA. Эти значения необходимы для инициализации MTProto клиента.

Почему Session+Json лучше Tdata для автоматизации

Аккаунты Session+Json работают на уровне API, а не на уровне GUI. Скрипт Telethon с аккаунтом Session+Json может отправлять сообщения, вступать в группы, собирать участников и управлять каналами в несколько строк Python. Вам не нужен десктопный клиент или GUI-автоматизация. И скрапинг экрана тоже не нужен. Вы можете запускать сотни сессий на одном VPS без запуска дополнительных десктопов.

Если вы сравниваете форматы, ознакомьтесь с руководством по Tdata для десктопного подхода.

Как использовать Telegram Session+Json аккаунты (пошагово)

  1. Установите Telethon или Pyrogram. Выполните pip install telethon или pip install pyrogram tgcrypto в вашем Python-окружении.
  2. Разместите файлы. Поместите файлы .session и .json в директорию вашего проекта рядом со скриптом.
  3. Загрузите сессию в коде. Используйте имя файла сессии (без расширения) при создании клиента. JSON-метаданные предоставляют API-учетные данные. 
    # Telethon example
from telethon import TelegramClient
import json

with open('account.json') as f:
    meta = json.load(f)

client = TelegramClient('account', meta['app_id'], meta['app_hash'])
client.start(phone=meta['phone'])
# Session is active. You can call any API method now.
  4. Запустите скрипт. Telethon и Pyrogram читают существующий файл .session при запуске. QR-код или SMS не нужны.

Session+Json vs Tdata: какой формат выбрать?

Критерий Session+Json Tdata
Лучше всего для Python-скриптов, API-автоматизации, чат-ботов Десктопного GUI, Telegram Portable
Протокол MTProto API (прямой протокол Telegram) Локальный десктопный кеш (косвенный)
Одновременные сессии Безлимитно (один VPS может запускать тысячи) Ограничено ресурсами десктопа
Доступ к API Полный MTProto API (сообщения, каналы, контакты) Только то, что предоставляет Telegram Desktop
Время настройки 30 секунд (pip install + размещение файлов) 2 минуты (скачать portable + настройка папки)

Решение распространенных проблем Session+Json

  • Сессия отозвана (ошибка 401). Аккаунт был удаленно разлогинен. Telegram помечает аккаунты, которые действуют слишком быстро. Дайте аккаунту отдохнуть 24 часа перед повторной попыткой.
  • Ошибки Flood wait. Вы превышаете лимиты API. Добавляйте случайные задержки между действиями (от 5 до 15 секунд) и избегайте отправки одного сообщения в несколько чатов подряд.
  • Неверный номер телефона. Телефон в .json файле не соответствует сессии. Убедитесь, что ваши метаданные относятся к тому же аккаунту, что и файл сессии.

Правила антибана для Session+Json аккаунтов

Аккаунты Session+Json используют сырой Telegram API, что делает их более заметными для системы обнаружения злоупотреблений Telegram. Эти правила помогут сохранить аккаунты живыми дольше:

Правило Описание Рекомендация
Совпадение прокси GEO прокси должен совпадать со страной регистрации аккаунта. Лучше всего работают мобильные SOCKS5 прокси.
Файл сессии Не изменяйте .session файл. Редактирование или перегенерация ломает аутентификацию. Храните резервные копии в защищенной директории.
Лимиты Соблюдайте лимиты методов Telegram. Не превышайте 30 сообщений в секунду на аккаунт.
Разминка Не запускайте автоматизацию на свежей сессии. Подождите 12-24 часа после первого входа.
2FA Двухфакторный пароль защищает аккаунт после покупки. Добавьте его в .json файл метаданных.

Где купить Telegram Session+Json аккаунты

На accs.tg доступны аккаунты Session+Json для США, Великобритании, Украины, России и других GEO. Каждый заказ включает файл .session и метаданные .json с app_id и app_hash. Доставка занимает менее 5 секунд. Аккаунты зарегистрированы на чистых IP-пулах через реальные мобильные устройства, что обеспечивает высокий уровень доверия.

Каждый аккаунт поставляется со всем необходимым для начала автоматизации в течение нескольких минут.

Посмотрите полный каталог на accs.tg/services или используйте API для оптовых заказов. Если вы предпочитаете десктопный формат, прочитайте руководство по Tdata.

Регистрация Каталог Вход