Telegram-бот
Бот присылает уведомления о конверсиях и ежедневную сводку и отвечает на команды со статистикой. Говорит на тех же семи языках, что и панель.
Подключение
- В Telegram откройте
@BotFather, выполните/newbotи получите токен вида1111:AAABBB…. - ⚙ → Интеграции → Telegram Bot — вставьте токен и нажмите Подключить.
- На той же странице Подключить чат → Получить код и отправьте боту
/start КОД(или откройте ссылку «Открыть бота»). Код одноразовый, действует 15 минут. Чаты без кода бот не принимает; отключить чат можно там же. - Включите нужные уведомления.
После /start бот закрепляет клавиатуру-меню: Статистика, Топ, Кампании, Конверсии, Уведомления, Сводка, Язык, Помощь — команды можно не набирать.
Как обновления доходят до бота
Режим панель выбирает сама и показывает на карточке статуса; его можно задать и вручную.
- Вебхук — Telegram вызывает
https://<домен>/telegram_bot.php. Работает только по HTTPS, на доменном имени и с сертификатом, которому Telegram доверяет. Запрос проверяется секретным токеном Telegram. - Опрос (polling) — крон
telegram_poll_cron.phpраз в минуту сам забирает обновления. Входящее соединение не нужно: бот работает на голом IP, поhttp://и за прокси. Установщик ставит крон:
* * * * * php /var/www/orbitra/telegram_poll_cron.php --quiet >> /var/www/orbitra/var/logs/telegram_poll.log 2>&1
При работающем вебхуке задача сразу выходит, ничего не делая.
Если бот молчит, карточка статуса покажет режим, ошибку, которую вернул сам Telegram (getWebhookInfo), и время последнего запуска опросчика. Пустое время при режиме «опрос» значит, что строки в 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в настройках интеграции. Сводку отправляет опросчик (для вебхука тоже), не чаще раза в сутки.
Telegram-каналы как офферы — отдельные боты воронки
Админский бот никогда не бывает направлением оффера «Telegram-канал». Посетители из рекламы общаются с отдельными ботами воронки (Админка → Telegram-боты воронки), которых опрашивает свой воркер; админский бот по-прежнему отвечает только допущенным чатам. Подробнее — Внешние PWA и Telegram-каналы.
Отбивка конверсий в каналы
Уведомления → Telegram → Отбивка конверсий в каналы (подключение бота остаётся в Интеграции → Telegram) отправляет выбранные конверсии в канал или группу через админского бота: выберите чат (бот должен быть администратором канала или участником группы, нажмите «Проверить»), статусы (депозит, регистрация, продажа, tg_join…), кампании и HTML-шаблон с макросами — {campaign}, {offer}, {status}, {payout}, {currency}, {country}, {flag}, {source}, {ad_campaign_name}, {adset_name}, {ad_name} (названия из рекламного кабинета, их подтягивает синк расходов), {sub1}–{sub3}, {click_id}, {time}, {date}. «Отправить тест» шлёт пример; журнал хранит последние 200 отправок на отбивку. Переключатель /notify для чатов работает как раньше.
Быстрый старт: первая кампания
Короткий путь: установите трекер, создайте кампанию и получите первые клики и конверсии меньше чем за час.
Читать гайд →ДокументацияУстановка и обновление
Установите Orbitra на чистый сервер Ubuntu или Debian одной командой и безопасно обновляйтесь до новых версий.
Читать гайд →ДокументацияМиграция из Keitaro
Перенесите кампании, офферы, источники и домены из Keitaro в Orbitra в один клик — что переносится и что проверить.
Читать гайд →ДокументацияМиграция из Binom
Перенесите кампании и потоки из Binom в Orbitra: что переносится автоматически, а что настроить вручную.
Читать гайд →ДокументацияВозможности Orbitra
Всё, что умеет Orbitra: кампании и потоки, клоакинг, лендинги, PWA, постбеки, расходы, отчёты и интеграции.
Читать гайд →ДокументацияКампании и потоки
Полный справочник: настройки кампаний, типы потоков, схемы, ротация, фильтры, тестовые ссылки и каждый параметр.
Читать гайд →ДокументацияКлоакинг
Полный справочник по клоакингу: уровни детекции, глобальные настройки, фильтры потоков, вердикты и отчёты.
Читать гайд →ДокументацияПроверка браузера
Как JS-проверка ловит ботов, виртуальные машины и эмуляторы через противоречия в окружении браузера.
Читать гайд →ДокументацияЛендинги
Типы лендингов, макрос {offer}, JS-адаптер, LeadForge и мульти-оффер лендинги — полный справочник.
Читать гайд →ДокументацияPWA-лендинги и Web Push
Собирайте устанавливаемые PWA-приложения и собирайте push-подписчиков: настройки, иконки, события и уведомления.
Читать гайд →ДокументацияPWA-воронка
Многошаговая PWA-воронка: приглашения к установке, отслеживание событий и возвратные уведомления.
Читать гайд →ДокументацияКонверсионные попапы
Показывайте реальные конверсии как попапы на странице: настройка, триггеры и размещение.
Читать гайд →ДокументацияЗаписи сессий и карта кликов
Воспроизводите реальные визиты, смотрите карты кликов и скроллов. Лимиты хранения и приватность.
Читать гайд →ДокументацияГалерея контента
Центральное хранилище иконок, скриншотов и креативов для PWA и лендингов.
Читать гайд →ДокументацияБиблиотека креативов
Храните креативы с отслеживанием по subid и тестируйте их в разных кампаниях.
Читать гайд →ДокументацияВнешние PWA и Telegram-каналы
Публикуйте PWA на внешних доменах и используйте Telegram-каналы как источник трафика.
Читать гайд →ДокументацияПостбеки и конверсии
Входящие постбеки, статусы и типы конверсий, исходящие S2S-постбеки в источник трафика.
Читать гайд →ДокументацияРасходы: импорт из рекламных кабинетов
Импорт расходов из Facebook, TikTok и Google Ads, обновление через API и крон — и как работает агрегатор доходов.
Читать гайд →ДокументацияPush и pop сети
Работа с пуш и поп источниками трафика: фиды, оптимизация зон и zone killer.
Читать гайд →ДокументацияFacebook / Meta integration
Импорт расходов из Meta Ads и Conversions API: серверные события с дедупликацией.
Читать гайд →ДокументацияDolphin / Fbtool — приём расходов (Keitaro Admin API)
Получайте расходы Facebook через API Dolphin (Fbtool) в реальном времени.
Читать гайд →ДокументацияЧистилка комментариев FB
Массовая модерация комментариев под рекламой Meta: скрывать, удалять и фильтровать по ключевым словам.
Читать гайд →ДокументацияИсточники трафика и партнёрские сети
Каталог 50+ источников трафика и 440+ сетей: шаблоны, параметры и адреса постбеков.
Читать гайд →ДокументацияОтчёты, логи и метрики
Конструктор отчётов, сохранённые отчёты, логи кликов и каждая метрика с пояснением.
Читать гайд →ДокументацияДомены и SSL
Добавление доменов, DNS, бесплатные сертификаты Let's Encrypt, редиректы, парковка и каждый переключатель на странице.
Читать гайд →ДокументацияCloudflare — DNS и SSL доменов
Как запускать домены кампаний через Cloudflare: DNS, режимы SSL и что отключить.
Читать гайд →ДокументацияАдминистрирование
Пользователи, роли и права, настройки безопасности, гео-базы, обновления и состояние системы.
Читать гайд →ДокументацияTelegram-бот
Управляйте трекером из Telegram: статистика, конверсии и алерты в чате.
Читать гайд →ДокументацияMCP-сервер: работа с трекером через нейросеть
Подключите Claude или любой MCP-клиент к Orbitra и управляйте кампаниями обычными словами.
Читать гайд →