Блог
Подключение Telegram Ads: токен и доступ только на чтение
· 2 мин чтения
Для знакомства с Adtally не нужно подключать аккаунт. Демо использует вымышленные данные и всегда отмечено соответствующей плашкой. Свою статистику можно открыть на странице Подключение с токеном API Telegram Ads.
Как подключиться
Откройте Account → API в Telegram Ads, скопируйте токен и вставьте его на странице подключения. Сервер проверяет его одним запросом getCurrentAccount перед созданием сессии. Не отправляйте токен в чат, отчёт или публичный снимок экрана.
Если Telegram отклоняет токен, подключённая сессия не создаётся. Если сессия закончилась, подключитесь снова. Ошибка живой статистики не подменяется вымышленными показателями.
Только чтение: семь разрешённых методов
Сервер пропускает только getCurrentAccount, getRelatedAccountsList, getAccountsById, getAdsList, getAdStats, getAccountStats и getAccountReport.
Создание, редактирование, остановка объявлений и перевод денег не входят в этот список. Рекомендации помогают оценивать данные; изменения выполняются в Telegram Ads. Ограничения правил описаны в руководстве.
Шифрование сессии
Токен шифруется AES-256-GCM в cookie __Host-at_session с атрибутом HttpOnly. Скрипты страницы не могут прочитать эту cookie. Сервер расшифровывает её для запроса API: шифрование не означает, что серверу никогда не нужен токен.
Сессия действует 1 час. Работайте в своём доверенном браузере: защита cookie не делает общий компьютер безопасным для оставленного открытым аккаунта.
Что не хранится на сервере
Нет базы токенов или рекламных данных, логов с токенами и кеша ответов Telegram. Статистика проходит через сервер в браузер. Тема и сохранённые виды отчётов остаются локально на устройстве, отдельно от зашифрованной сессии.
Отключение удаляет cookie сессии. Оно завершает доступ этого сервиса через текущую сессию, но не отзывает сам токен Telegram.
Официальный API и отзыв токена
Рабочие запросы API идут к promoteapi.telegram.org. Для отзыва самого токена сбросьте его в Telegram Ads. Закрытие вкладки или отключение не заменяет это действие.
После подключения откройте отчёт по объявлениям. Если статистика не загрузилась, проверьте полноту данных. Политика конфиденциальности подробнее описывает cookie, локальные настройки, аналитику и сообщения об ошибках.