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

Telegram-бот

Бот присылает уведомления о конверсиях и ежедневную сводку и отвечает на команды со статистикой. Говорит на тех же семи языках, что и панель.

Подключение

  1. В Telegram откройте @BotFather, выполните /newbot и получите токен вида 1111:AAABBB….
  2. ⚙ → Интеграции → Telegram Bot — вставьте токен и нажмите Подключить.
  3. На той же странице Подключить чат → Получить код и отправьте боту /start КОД (или откройте ссылку «Открыть бота»). Код одноразовый, действует 15 минут. Чаты без кода бот не принимает; отключить чат можно там же.
  4. Включите нужные уведомления.

После /start бот закрепляет клавиатуру-меню: Статистика, Топ, Кампании, Конверсии, Уведомления, Сводка, Язык, Помощь — команды можно не набирать.

Как обновления доходят до бота

Режим панель выбирает сама и показывает на карточке статуса; его можно задать и вручную.

  * * * * * 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 показывает текущее состояние, а не выключает уведомления.

Уведомления

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 для чатов работает как раньше.

← Назад
Администрирование
Вперёд →
MCP-сервер: работа с трекером через нейросеть
Исходник на GitHub: github.com/fenjo26/Orbitra.link/wiki
Все гайды
Документация

Быстрый старт: первая кампания

Короткий путь: установите трекер, создайте кампанию и получите первые клики и конверсии меньше чем за час.

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

Установка и обновление

Установите 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 и управляйте кампаниями обычными словами.

Читать гайд →