Bot Telegram
Le bot envoie les notifications de conversion et un digest quotidien, et répond aux commandes avec des statistiques. Il parle les mêmes sept langues que le panneau.
Connexion
- Dans Telegram, ouvrez
@BotFather, lancez/newbotet récupérez un token du genre1111:AAABBB…. - ⚙ → Integrations → Telegram Bot — collez le token et pressez Connect.
- Sur la même page, Connect chat → Get code et envoyez
/start CODEau bot (ou ouvrez le lien « Open bot »). Le code est à usage unique et valable 15 minutes. Le bot n'accepte pas de chat sans code ; un chat peut être déconnecté sur la même page. - Activez les notifications dont vous avez besoin.
Après /start le bot épingle un menu clavier : Stats, Top, Campaigns, Conversions, Notifications, Digest, Language, Help — pas besoin de taper les commandes.
Comment les mises à jour arrivent au bot
Le panneau choisit le mode lui-même et l'affiche sur la carte de statut ; vous pouvez aussi le régler à la main.
- Webhook — Telegram appelle
https://<domain>/telegram_bot.php. Ne fonctionne qu'en HTTPS, sur un nom de domaine, avec un certificat en lequel Telegram a confiance. La requête est vérifiée par le secret token de Telegram. - Polling — le cron
telegram_poll_cron.phpva chercher les mises à jour une fois par minute. Aucune connexion entrante nécessaire : le bot marche sur une IP nue, enhttp://et derrière un proxy. L'installateur ajoute le cron :
* * * * * php /var/www/orbitra/telegram_poll_cron.php --quiet >> /var/www/orbitra/var/logs/telegram_poll.log 2>&1
Quand un webhook est actif, la tâche sort immédiatement sans rien faire.
Si le bot est silencieux, la carte de statut montrera le mode, l'erreur renvoyée par Telegram lui-même (getWebhookInfo) et l'heure du dernier passage du poller. Une heure vide en mode « polling » signifie qu'il n'y a pas d'entrée crontab. Vérification manuelle :
sudo -u www-data php /var/www/orbitra/telegram_poll_cron.php --once
Commandes
| Commande | Ce qu'elle fait | ||||||
|---|---|---|---|---|---|---|---|
/stats | Les statistiques du jour ; /stats yesterday, /stats 1d, /stats 7d, /stats 30d | ||||||
/campaigns | Les campagnes actives, avec un bouton pour chacune | ||||||
/campaign ID | Le détail d'une campagne | ||||||
/top | Le top 5 des campagnes par revenus aujourd'hui | ||||||
/conversions | Les 10 dernières conversions | ||||||
| `/notify on\ | off` | Les notifications de conversion ; sans argument — l'état courant et un bouton | |||||
| `/daily on\ | off` | Le digest quotidien | |||||
| `/lang en\ | ru\ | uk\ | es\ | zh\ | fr\ | de` | La langue du bot ; sans argument — choisir avec des boutons |
/sources | Les sources de trafic et l'état de leur vérification d'URL | ||||||
/checksources | Vérifier les URL de toutes les sources | ||||||
/allow ID | Autoriser un chat de plus par son ID | ||||||
/help | L'aide et le ré-épinglage du menu |
Les commandes sans argument ne changent rien : /notify montre l'état courant au lieu de couper les notifications.
Notifications
- Sur une conversion — campagne, statut, montant et devise, pays avec un drapeau, heure.
- Digest quotidien — clics, conversions, revenus, dépense, profit et le top 3 des campagnes. L'heure d'envoi est
telegram_daily_timedans les réglages de l'intégration. Le digest est envoyé par le poller (en mode webhook aussi), au maximum une fois par jour.
Chaînes Telegram comme offres — des funnel bots séparés
Le bot admin n'est jamais la destination d'une offre de chaîne Telegram. Les visiteurs des pubs parlent à des funnel bots séparés (Admin → Telegram funnel bots), interrogés par leur propre worker ; le bot admin ne continue de répondre qu'aux chats que vous avez admis. Voir PWA externes et chaînes Telegram.
Alertes de conversion vers des chaînes
Notifications → Telegram → Conversion alerts to channels (la connexion du bot reste dans Integrations → Telegram) envoie les conversions choisies vers une chaîne ou un groupe à travers le bot admin : choisissez le chat (le bot doit être admin de la chaîne ou membre du groupe, pressez Check), les statuts (deposit, registration, sale, tg_join…), les campagnes, et un template HTML avec macros — {campaign}, {offer}, {status}, {payout}, {currency}, {country}, {flag}, {source}, {ad_campaign_name}, {adset_name}, {ad_name} (les noms côté plateformes pub venant de la sync des coûts), {sub1}–{sub3}, {click_id}, {time}, {date}. Send test publie des valeurs d'exemple ; le journal garde les 200 derniers envois par alerte. L'interrupteur /notify par chat continue de fonctionner comme avant.
Démarrage rapide : votre première campagne
Le chemin court : installez le tracker, créez une campagne et obtenez vos premiers clics et conversions en moins d'une heure.
Lire le guide →DocsInstallation et mises à jour
Installez Orbitra sur un serveur Ubuntu ou Debian tout neuf en une commande, et passez aux nouvelles versions sans risque.
Lire le guide →DocsMigrer depuis Keitaro
Déplacez campagnes, offres, sources et domaines de Keitaro vers Orbitra : ce qui est transféré et quoi vérifier après l'import.
Lire le guide →DocsMigrer depuis Binom
Déplacez campagnes et streams de Binom vers Orbitra via l'API publique v2 : ce qui est transféré automatiquement et quoi régler à la main.
Lire le guide →DocsAperçu des fonctionnalités
Tout ce qu'Orbitra sait faire : campaigns et streams, cloaking, landings, PWA, postbacks, coûts, rapports et intégrations.
Lire le guide →DocsCampaigns et streams
La référence complète : réglages de campagne, types de streams, schémas, rotation, filtres, test links et chaque option expliquée.
Lire le guide →DocsCloaking
La référence complète du cloaking : couches de détection, réglages globaux, filtres par stream, verdicts et rapports.
Lire le guide →DocsBrowser check
Comment la vérification JS attrape bots, VM et émulateurs à travers les contradictions de l'environnement du navigateur.
Lire le guide →DocsLanding pages
Types de landings, la macro {offer}, l'adaptateur JS, LeadForge et les landings multi-offres — la référence complète.
Lire le guide →DocsPWA et Web Push
Construisez des apps PWA installables et collectez des abonnés push : réglages, icônes, événements et notifications.
Lire le guide →DocsFunnel de visite PWA
Le funnel configurable des landings PWA : étapes ordonnées, store, instructions et carte push, tracking par écran, statistiques de transitions et éditeur.
Lire le guide →DocsPopups de conversion
Un popup avec bouton d'offre sur vos landings : templates par vertical, déclencheurs, designs, une vraie étape du funnel et les métriques Popup CTR.
Lire le guide →DocsEnregistrements de session
Replay des visites façon vidéo, heatmap de clics et carte de scroll : activation, sites entiers, consentement cookies, stockage et dépannage.
Lire le guide →DocsContent Gallery : référence complète
La médiathèque partagée du tracker : dossiers, uploads, limites de formats, MediaPicker et contrat de taille dans les éditeurs PWA, landing et offre.
Lire le guide →DocsBibliothèque de créas
L'onglet Creatives de la galerie : sync Facebook/TikTok, dépense et ROI par créa, rattachement des brouillons, alertes burnout et rapports.
Lire le guide →DocsPWA externes et chaînes Telegram
Builders PWA tiers comme cibles de stream avec installs et postbacks attribués, et offres chaîne Telegram via funnel bots avec conversions tg_join.
Lire le guide →DocsPostbacks et conversions
Postbacks entrants, types de conversion et devises, postbacks S2S sortants, macros, file de livraison, testeur, import et Conversions API.
Lire le guide →DocsCoûts : import de la dépense
Import de la dépense Facebook, TikTok, Google Ads et réseaux push/pop : matching par IDs, diagnostics, agences, métriques plateforme et agrégateur de revenus.
Lire le guide →DocsRéseaux push et pop
Import de dépense AdMaven, PropellerAds, Kadam et autres, et le Zone Killer : règles dry-run/auto pour bloquer les zones qui brûlent de l'argent.
Lire le guide →DocsFacebook / Meta
Les deux intégrations Facebook : import de coûts avec mapping des paramètres, et Conversions API avec matching navigateur, consentement et dépannage.
Lire le guide →DocsDolphin / Fbtool
Recevoir les coûts Facebook de Dolphin et Fbtool.pro sur l'endpoint compatible Keitaro : clé API, matching par adset/ad et répartition de la dépense sur les clics.
Lire le guide →DocsNettoyage des commentaires FB
Modération planifiée des commentaires spam sous vos pubs Facebook : dry-run, stop words, regexes admin, whitelist, journal et restauration en un clic.
Lire le guide →DocsSources de trafic et réseaux d'affiliation
Les deux annuaires du funnel : templates de sources avec paramètres et macros, postback vers la source, réseaux d'affiliation et paramètres d'offre.
Lire le guide →DocsRapports, logs et métriques
Dashboard, liste des campagnes, rapport à dimensions, tendances et cohortes, journal du trafic, carte du clic et le détail du calcul de chaque métrique.
Lire le guide →DocsDomaines et SSL
Ajouter des domaines, réglages par domaine, certificats Let's Encrypt et Cloudflare, registrars connectés et surveillance Backorder.
Lire le guide →DocsCloudflare
Connecter Cloudflare via l'API : parking DNS automatique, proxy orange, modes SSL de zone, import des zones et réécriture des enregistrements A.
Lire le guide →DocsAdministration
Utilisateurs, rôles et permissions, clés API, réglages du tracker, bases geo, mises à jour et menu ⚙ : archive, statuts, logs et extension Ads Manager.
Lire le guide →DocsBot Telegram
Statistiques, conversions et digest quotidien dans Telegram : connexion par token, webhook ou polling, commandes, notifications et alertes vers les chaînes.
Lire le guide →DocsMCP : un assistant IA dans le tracker
Connecter Claude Desktop ou tout client MCP à Orbitra via le serveur MCP : clés API, options de connexion et les 41 tools disponibles.
Lire le guide →