Telegram-Bot
Der Bot schickt Conversion-Benachrichtigungen und ein tägliches Digest und beantwortet Befehle mit Statistiken. Er spricht dieselben sieben Sprachen wie das Panel.
Verbinden
- Öffne in Telegram
@BotFather, führe/newbotaus und erhalte einen Token wie1111:AAABBB…. - ⚙ → Integrations → Telegram Bot — Token einfügen und Connect drücken.
- Auf derselben Seite Connect chat → Get code und dem Bot
/start CODEschicken (oder den „Open bot“-Link öffnen). Der Code gilt einmal und 15 Minuten lang. Ohne Code nimmt der Bot keine Chats an; einen Chat trennst du auf derselben Seite wieder. - Aktiviere die Benachrichtigungen, die du brauchst.
Nach /start pinned der Bot ein Tastatur-Menü: Stats, Top, Campaigns, Conversions, Notifications, Digest, Language, Help — die Befehle musst du nicht tippen.
Wie Updates den Bot erreichen
Das Panel wählt den Modus selbst und zeigt ihn auf der Status-Karte; du kannst ihn auch manuell setzen.
- Webhook — Telegram ruft
https://<domain>/telegram_bot.phpauf. Funktioniert nur über HTTPS, auf einem Domainnamen, mit einem Zertifikat, dem Telegram vertraut. Der Request wird über den Telegram-Secret-Token verifiziert. - Polling — der Cron
telegram_poll_cron.phpholt die Updates einmal pro Minute. Keine eingehende Verbindung nötig: Der Bot läuft auf einer nackten IP, überhttp://und hinter einem Proxy. Der Installer legt den Cron an:
* * * * * php /var/www/orbitra/telegram_poll_cron.php --quiet >> /var/www/orbitra/var/logs/telegram_poll.log 2>&1
Ist ein Webhook aktiv, beendet sich der Job sofort, ohne etwas zu tun.
Wenn der Bot schweigt, zeigt die Status-Karte den Modus, den Fehler, den Telegram selbst zurückgibt (getWebhookInfo), und den Zeitpunkt des letzten Poller-Laufs. Eine leere Zeit im „Polling“-Modus bedeutet: kein Crontab-Eintrag. Manueller Check:
sudo -u www-data php /var/www/orbitra/telegram_poll_cron.php --once
Befehle
| Befehl | Was er tut | ||||||
|---|---|---|---|---|---|---|---|
/stats | Die Statistik von heute; /stats yesterday, /stats 1d, /stats 7d, /stats 30d | ||||||
/campaigns | Aktive Kampagnen, mit einem Button pro Kampagne | ||||||
/campaign ID | Details zur Kampagne | ||||||
/top | Die Top-5-Kampagnen nach heutigem Revenue | ||||||
/conversions | Die letzten 10 Conversions | ||||||
| `/notify on\ | off` | Conversion-Benachrichtigungen; ohne Argument — der aktuelle Zustand und ein Button | |||||
| `/daily on\ | off` | Tägliches Digest | |||||
| `/lang en\ | ru\ | uk\ | es\ | zh\ | fr\ | de` | Die Sprache des Bots; ohne Argument — Wahl per Buttons |
/sources | Traffic-Quellen und der Status ihres URL-Checks | ||||||
/checksources | Die URLs aller Quellen prüfen | ||||||
/allow ID | Einen weiteren Chat per ID zulassen | ||||||
/help | Hilfe und erneutes Pinnen des Menüs |
Befehle ohne Argument ändern nichts: /notify zeigt den aktuellen Zustand, statt die Benachrichtigungen auszuschalten.
Benachrichtigungen
- Bei einer Conversion — Kampagne, Status, Betrag und Währung, Land mit Flagge, Zeitpunkt.
- Tägliches Digest — Klicks, Conversions, Revenue, Kosten, Profit und die Top-3-Kampagnen. Die Sendezeit ist
telegram_daily_timein den Integrationseinstellungen. Das Digest schickt der Poller (auch im Webhook-Modus), höchstens einmal pro Tag.
Telegram-Kanäle als Offers — separate Funnel-Bots
Der Admin-Bot ist nie das Ziel eines Telegram-Kanal-Offers. Ad-Visitor reden mit separaten Funnel-Bots (Admin → Telegram funnel bots), die ein eigener Worker pollt; der Admin-Bot beantwortet weiter nur die Chats, die du zugelassen hast. Siehe Externe PWA und Telegram-Kanäle.
Conversion-Alerts an Kanäle
Notifications → Telegram → Conversion alerts to channels (die Bot-Verbindung bleibt in Integrations → Telegram) schickt ausgewählte Conversions über den Admin-Bot in einen Kanal oder eine Gruppe: Chat wählen (der Bot muss Admin des Kanals oder Mitglied der Gruppe sein, Check drücken), die Statuswerte (deposit, registration, sale, tg_join …), die Kampagnen und ein HTML-Template mit Makros — {campaign}, {offer}, {status}, {payout}, {currency}, {country}, {flag}, {source}, {ad_campaign_name}, {adset_name}, {ad_name} (die Ad-Plattform-Namen aus dem Cost-Sync), {sub1}–{sub3}, {click_id}, {time}, {date}. Send test postet Beispielwerte; das Log behält die letzten 200 Sendungen pro Alert. Der /notify-Schalter pro Chat funktioniert wie bisher.
Schnellstart
Von einem nackten Server zur ersten Conversion in neun Schritten: Installation, erster Login, Domain, Netzwerk und Offer, Traffic-Quelle, Kampagne, Prüfung, Kosten.
Guide lesen →DocsInstallation und Updates
Systemvoraussetzungen, der Ein-Befehl-Installer, PHP-Updates inklusive Sicherheits-Hinweisen, Panel-Zugriff per IP und die lokale Entwicklungsumgebung.
Guide lesen →DocsMigration von Keitaro
Einstellungen per SQL-Dump von Keitaro zu Orbitra übertragen: was mitkommt, das Dump-Script, der Import und was du danach prüfen solltest.
Guide lesen →DocsMigration von Binom
Kampagnen, Offers, Streams und mehr direkt über die Binom-v2-Public-API importieren — ohne Dump-Datei, inklusive Mapping-Hinweisen.
Guide lesen →DocsFunktionen im Überblick
Alle Orbitra-Funktionen auf einen Blick: Traffic und Schemas, Postbacks und Kosten, Analytics, Infrastruktur und Verwaltung — mit Links auf die Detailseiten.
Guide lesen →DocsKampagnen und Streams
Der Kampagnen-Editor im Detail: Reiter, Kostenmodelle, Stream-Typen, alle Filter, Schemas, Rotation mit Auto-Optimierung, Test-Link und Duplikat-Schutz.
Guide lesen →DocsCloaking (Referenz)
Die vollständige Cloaking-Referenz: Detection layers, Sensitivity, Targeting filters, JavaScript-Verifizierung, Verdicts, Gründe und Diagnostik.
Guide lesen →DocsBrowser check
Bots, Moderator-VMs, Emulatoren und Anti-Detect-Browser an Widersprüchen im Browser selbst erkennen — Modi, Anzeichen und der sichere Einstieg.
Guide lesen →DocsLandingpages (Referenz)
Die vollständige Landingpage-Referenz: lokale, Redirect-, Preload- und Action-Landingpages, das {offer}-Makro, SubID-Weitergabe, JS-Adapter und PHP-Landings.
Guide lesen →DocsPWA und Web Push
PWA-Landingpages und eigenes Web Push: Builder, Domain-Bindung, VAPID-Keys, Abonnenten, Messages, der Versand-Cron, Attribution und Fehlerbehebung.
Guide lesen →DocsPWA Funnel
Der PWA-Besuch als konfigurierbarer Funnel: Screens in fester Reihenfolge, Event-Tracking pro Screen und Re-Engagement-Benachrichtigungen.
Guide lesen →DocsConversion-Popups
Echte Conversion-Events als Popup auf der Landing zeigen: Einrichtung pro Kampagne, Trigger und Platzierung.
Guide lesen →DocsSession-Aufzeichnungen und Heatmaps
Echte Besuche wie ein Video abspielen, dazu Klick-Heatmap und Scroll-Map. Speicher-Limits und Datenschutz-Hinweise.
Guide lesen →DocsContent Gallery
Die zentrale Mediathek des Trackers für Icons, Screenshots und Creatives, genutzt in PWAs und Landings: Ordner, Uploads, MediaPicker.
Guide lesen →DocsCreatives-Bibliothek
Creatives mit SubID-Tracking speichern und über Kampagnen hinweg testen.
Guide lesen →DocsExterne PWA und Telegram-Kanäle
PWAs auf externen Domains veröffentlichen und Telegram-Kanäle als Traffic-Quelle mit zuordenbaren Abonnenten fahren.
Guide lesen →DocsPostbacks und Conversions
Eingehende Postbacks, Conversion-Statuswerte und -Typen sowie ausgehende S2S-Postbacks an die Traffic-Quelle.
Guide lesen →DocsKosten
Spend aus Facebook, TikTok und Google Ads importieren oder per API und Cron pflegen — und wie der Revenue Aggregator arbeitet.
Guide lesen →DocsPush- und Pop-Netzwerke
Arbeit mit Push- und Pop-Traffic-Quellen: Feeds, Zonen-Optimierung und der Zone Killer.
Guide lesen →DocsFacebook / Meta
Kosten-Import aus Meta Ads und die Conversions API: serverseitige Events mit Deduplizierung.
Guide lesen →DocsDolphin / Fbtool
Facebook-Kosten über den Keitaro-kompatiblen Admin-API-Endpunkt empfangen: API-Key, Dolphin- und Fbtool-Setup und wie der Spend auf die Klicks verteilt wird.
Guide lesen →DocsFB-Kommentar-Cleaner
Spam-Kommentare unter Meta-Ads nach Zeitplan verstecken oder löschen: Regelwerke, Presets, Ausnahmen, Dry-run und Auto-Pause.
Guide lesen →DocsTraffic-Quellen und Affiliate-Netzwerke
Die beiden Verzeichnisse am Funnel-Rand: Templates für rund 200 Quellen und 440 Netzwerke, Parameter, Makros und Postback-URLs.
Guide lesen →DocsReports, Logs und Metriken
Der Report-Builder, Traffic-Log, Klick-Karte und jede Metrik erklärt — von Clicks und Visits über ROI bis zur Scroll-Tiefe.
Guide lesen →DocsDomains und SSL
Domains hinzufügen, DNS und A-Records, kostenlose Let's-Encrypt-Zertifikate, Cloudflare-Proxy und alle Schalter der Domain-Einstellungen.
Guide lesen →DocsCloudflare
Kampagnen-Domains über Cloudflare fahren: API-Token, Accounts, automatische A-Records, SSL-Modi und der orange Cloud-Proxy.
Guide lesen →DocsAdministration
Users, Rollen und Rechte, Settings, Geo-Datenbanken, Updates und Systemstatus — die Verwaltung des Trackers über das ⚙-Menü.
Guide lesen →DocsTelegram-Bot
Den Tracker aus Telegram steuern: Statistiken, Kampagnen und Conversions per Befehl, dazu Benachrichtigungen und tägliches Digest.
Guide lesen →DocsMCP: ein KI-Assistent im Tracker
Claude oder einen anderen MCP-Client an Orbitra anbinden und Kampagnen, Offers und Domains in natürlicher Sprache verwalten.
Guide lesen →