Документація

Telegram-бот

Бот надсилає сповіщення про конверсії та щоденний дайджест, а на команди відповідає статистикою. Він розмовляє тими самими сімома мовами, що й панель.

Підключення

  1. У Telegram відкрийте @BotFather, виконайте /newbot і отримайте токен виду 1111:AAABBB….
  2. ⚙ → Integrations → Telegram Bot — вставте токен і натисніть Connect.
  3. На тій самій сторінці Connect chat → Get code і надішліть боту /start CODE (або відкрийте посилання «Open bot»). Код одноразовий і дійсний 15 хвилин. Бот не приймає чати без коду; чат можна відключити на тій самій сторінці.
  4. Увімкніть потрібні сповіщення.

Після /start бот закріплює меню-клавіатуру: Stats, Top, Campaigns, Conversions, Notifications, Digest, Language, Help — команди можна не набирати.

Як оновлення потрапляють у бота

Панель обирає режим сама і показує його на картці стану; можна задати і вручну.

  * * * * * php /var/www/orbitra/telegram_poll_cron.php --quiet >> /var/www/orbitra/var/logs/telegram_poll.log 2>&1

Коли webhook активний, задача виходить одразу, нічого не роблячи.

Якщо бот мовчить, картка стану покаже режим, помилку від самого Telegram (getWebhookInfo) і час останнього запуску поллера. Порожній час у режимі «polling» означає, що запису в crontab немає. Перевірка вручну:

sudo -u www-data php /var/www/orbitra/telegram_poll_cron.php --once

Команди

КомандаЩо робить
/statsСтатистика за сьогодні; /stats yesterday, /stats 1d, /stats 7d, /stats 30d
/campaignsАктивні кампанії, з кнопкою для кожної
/campaign IDПодробиці кампанії
/topТоп-5 кампаній за доходом за сьогодні
/conversionsОстанні 10 конверсій
`/notify on\off`Сповіщення про конверсії; без аргумента — поточний стан і кнопка
`/daily on\off`Щоденний дайджест
`/lang en\ru\uk\es\zh\fr\de`Мова бота; без аргумента — вибір кнопками
/sourcesДжерела трафіку та статус перевірки їх URL
/checksourcesПеревірити URL усіх джерел
/allow IDДозволити ще один чат за його ID
/helpДовідка і повторне закріплення меню

Команди без аргумента нічого не змінюють: /notify показує поточний стан замість вимкнення сповіщень.

Сповіщення

Telegram-канали як оффери — окремі воронкові боти

Адмін-бот ніколи не є ціллю оффера Telegram-каналу. Відвідувачі реклами розмовляють з окремими воронковими ботами (Admin → Telegram funnel bots), яких опитує власний воркер; адмін-бот продовжує відповідати лише чатам, які ви допустили. Дивіться Зовнішні PWA та Telegram-канали.

Алерти про конверсії в канали

Notifications → Telegram → Conversion alerts to channels (підключення бота лишається в Integrations → Telegram) надсилає обрані конверсії в канал або групу через адмін-бота: оберіть чат (бот має бути адміністратором каналу або учасником групи, натисніть Check), статуси (deposit, registration, sale, tg_join…), кампанії та HTML-шаблон із макросами — {campaign}, {offer}, {status}, {payout}, {currency}, {country}, {flag}, {source}, {ad_campaign_name}, {adset_name}, {ad_name} (назви з рекламних платформ із синхронізації витрат), {sub1}–{sub3}, {click_id}, {time}, {date}. Send test публікує зразкові значення; лог зберігає останні 200 надсилань на кожен алерт. Перемикач /notify для окремого чата працює, як і раніше.

← Попередній
Адміністрування
Наступний →
MCP: ШІ-асистент у трекері
Переглянути джерело на GitHub: github.com/fenjo26/Orbitra.link/wiki
Усі гайди
Документація

Швидкий старт: ваша перша кампанія

Короткий шлях: встановіть трекер, створіть кампанію та отримайте перші кліки й конверсії менш ніж за годину.

Читати гайд →
Документація

Встановлення та оновлення

Встановіть Orbitra на чистий сервер Ubuntu або Debian однією командою та безпечно оновлюйтеся до нових версій.

Читати гайд →
Документація

Міграція з Keitaro

Перенесіть кампанії, оффери, джерела та домени з Keitaro в Orbitra одним імпортом — що переноситься і що перевірити після нього.

Читати гайд →
Документація

Міграція з Binom

Перенесіть кампанії та потоки з Binom у Orbitra через Public API: що переноситься автоматично, а що налаштувати вручну.

Читати гайд →
Документація

Огляд можливостей

Усе, що вміє Orbitra: кампанії та потоки, клоакинг, лендинги, PWA, постбеки, витрати, звіти та інтеграції.

Читати гайд →
Документація

Кампанії та потоки

Повна довідка: налаштування кампаній, типи потоків, схеми, ротація, фільтри, тестові посилання та кожна опція з поясненням.

Читати гайд →
Документація

Клоакинг

Повна довідка з клоакингу: шари детекції, глобальні налаштування, фільтри потоку, вердикти та звіти.

Читати гайд →
Документація

Перевірка браузера

Як JS-перевірка ловить ботів, віртуальні машини та емулятори за суперечностями в браузерному оточенні.

Читати гайд →
Документація

Лендинги

Типи лендингів, макрос {offer}, JS-адаптер, LeadForge та мультиофферні лендинги — повна довідка.

Читати гайд →
Документація

PWA та Web Push

Створюйте встановлювані PWA-застосунки та збирайте push-підписників: налаштування, іконки, події та сповіщення.

Читати гайд →
Документація

PWA-воронка

Воронка візиту на PWA-лендинг: екрани до встановлення, трекінг кожного екрана, статистика показів і матриця переходів.

Читати гайд →
Документація

Конверсійні попапи

Попап із кнопкою оффера на лендингах: вкладка Popup, вертикальні шаблони, тригери показу і метрики показів та CTR.

Читати гайд →
Документація

Записи сесій і теплові карти

Реплеї реальних візитів, теплові карти кліків і скролу, ліміти сховища, приватність і запис цілих сайтів.

Читати гайд →
Документація

Галерея контенту

Повна довідка Галереї: папки, завантаження, MediaPicker у редакторах, контракти розміру, обмеження форматів і відео.

Читати гайд →
Документація

Бібліотека креативів

Креативи з витратами, доходом і ROI: синк файлів з Facebook і TikTok, дедуплікація, звіти і алерт вигорання креативів.

Читати гайд →
Документація

Зовнішні PWA та Telegram-канали

Сторонні PWA-сервіси як цілі потоків (/eflow) і Telegram-канали як оффери: funnel-бот, вступи-конверсії та атрибуція.

Читати гайд →
Документація

Постбеки та конверсії

Вхідні постбеки, статуси й типи конверсій, вихідні S2S-постбеки на джерело, черга доставки, тестер і імпорт конверсій.

Читати гайд →
Документація

Витрати

Імпорт витрат з Facebook, TikTok, Google Ads і push/pop-мереж, розподіл по кліках, агентські комісії та агрегатор доходу.

Читати гайд →
Документація

Push- і pop-мережі

Імпорт витрат із push/pop-мереж і Zone Killer: правила, що знаходять і блокують зони, які палять бюджет.

Читати гайд →
Документація

Facebook / Meta

Імпорт витрат з Meta Ads і Conversions API: токени, мапінг статусів, серверні події з дедуплікацією і діагностика.

Читати гайд →
Документація

Dolphin / Fbtool

Отримуйте витрати Facebook у трекер через API Dolphin (Fbtool) у реальному часі: API-ключ, налаштування сервісів і розподіл витрат по кліках.

Читати гайд →
Документація

Чистильник коментарів FB

Масова модерація коментарів під рекламою Meta за розкладом: набори правил, винятки, сухий прогін, журнал дій і авто-пауза.

Читати гайд →
Документація

Джерела трафіку та партнерські мережі

Два довідники, що налаштовують «краї» воронки: шаблони джерел і мереж, параметри, постбек у джерело та офферні параметри.

Читати гайд →
Документація

Звіти, логи та метрики

Дашборд, список кампаній, конструктор звітів, тренди й когорти, лог трафіку та картка кліка — і як рахується кожна метрика.

Читати гайд →
Документація

Домени та SSL

Додайте домени, наведіть DNS на сервер, отримайте безкоштовний сертифікат Let's Encrypt і розберіться з кожним перемикачем на сторінці Domains.

Читати гайд →
Документація

Cloudflare

Інтеграція з Cloudflare через API: A-записи ставляться автоматично, а з проксі SSL роздає Cloudflare — без certbot і очікування валідації.

Читати гайд →
Документація

Адміністрування

Користувачі, ролі та права по ресурсах, налаштування безпеки, гео-бази, оновлення панелі й розширення Ads Manager.

Читати гайд →
Документація

Telegram-бот

Керуйте трекером із Telegram: статистика, конверсії та сповіщення в чаті, вебхук або поллінг і алерти в канали.

Читати гайд →
Документація

MCP: ШІ-асистент у трекері

Підключіть Claude або будь-який MCP-клієнт до Orbitra й керуйте кампаніями, офферами та доменами звичайними словами.

Читати гайд →