Telegram-бот
Бот надсилає сповіщення про конверсії та щоденний дайджест, а на команди відповідає статистикою. Він розмовляє тими самими сімома мовами, що й панель.
Підключення
- У Telegram відкрийте
@BotFather, виконайте/newbotі отримайте токен виду1111:AAABBB…. - ⚙ → Integrations → Telegram Bot — вставте токен і натисніть Connect.
- На тій самій сторінці Connect chat → Get code і надішліть боту
/start CODE(або відкрийте посилання «Open bot»). Код одноразовий і дійсний 15 хвилин. Бот не приймає чати без коду; чат можна відключити на тій самій сторінці. - Увімкніть потрібні сповіщення.
Після /start бот закріплює меню-клавіатуру: Stats, Top, Campaigns, Conversions, Notifications, Digest, Language, Help — команди можна не набирати.
Як оновлення потрапляють у бота
Панель обирає режим сама і показує його на картці стану; можна задати і вручну.
- Webhook — Telegram викликає
https://<domain>/telegram_bot.php. Працює тільки по HTTPS, на доменному імені, із сертифікатом, якому довіряє Telegram. Запит перевіряється секретним токеном Telegram. - Polling — cron
telegram_poll_cron.phpзабирає оновлення раз на хвилину. Вхідне з'єднання не потрібне: бот працює на голому IP, поhttp://і за проксі. Інсталятор додає cron:
* * * * * 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 показує поточний стан замість вимкнення сповіщень.
Сповіщення
- Про конверсію — кампанія, статус, сума та валюта, країна з прапорцем, час.
- Щоденний дайджест — кліки, конверсії, дохід, витрати, прибуток і топ-3 кампаній. Час надсилання —
telegram_daily_timeу налаштуваннях інтеграції. Дайджест надсилає поллер (у режимі webhook теж), щонайбільше раз на добу.
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 для окремого чата працює, як і раніше.
Швидкий старт: ваша перша кампанія
Короткий шлях: встановіть трекер, створіть кампанію та отримайте перші кліки й конверсії менш ніж за годину.
Читати гайд →ДокументаціяВстановлення та оновлення
Встановіть 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 й керуйте кампаніями, офферами та доменами звичайними словами.
Читати гайд →