Блог
Підключення 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, локальні налаштування, аналітику й повідомлення про помилки.