Bot de Telegram
El bot envía notificaciones de conversiones y un resumen diario, y responde comandos con estadísticas. Habla los mismos siete idiomas que el panel.
Conexión
- En Telegram, abre
@BotFather, ejecuta/newboty consigue un token como1111:AAABBB…. - ⚙ → Integrations → Telegram Bot — pega el token y pulsa Connect.
- En la misma página, Connect chat → Get code y envía
/start CODEal bot (o abre el enlace "Open bot"). El código es de un solo uso y vale 15 minutos. El bot no acepta chats sin código; un chat se puede desconectar en la misma página. - Activa las notificaciones que necesites.
Tras /start el bot fija un menú de teclado: Stats, Top, Campaigns, Conversions, Notifications, Digest, Language, Help — no hace falta escribir los comandos.
Cómo llegan las actualizaciones al bot
El panel elige el modo él mismo y lo muestra en la tarjeta de estado; también puedes fijarlo a mano.
- Webhook — Telegram llama a
https://<domain>/telegram_bot.php. Funciona solo por HTTPS, en un nombre de dominio, con un certificado en el que Telegram confía. La petición se verifica por el secret token de Telegram. - Polling — el cron
telegram_poll_cron.phptrae las actualizaciones una vez por minuto. No hace falta conexión entrante: el bot funciona en una IP desnuda, porhttp://y detrás de un proxy. El instalador añade el cron:
* * * * * php /var/www/orbitra/telegram_poll_cron.php --quiet >> /var/www/orbitra/var/logs/telegram_poll.log 2>&1
Cuando hay un webhook activo, el job sale de inmediato sin hacer nada.
Si el bot calla, la tarjeta de estado mostrará el modo, el error que devolvió el propio Telegram (getWebhookInfo) y la hora de la última corrida del poller. Una hora vacía en modo "polling" significa que no hay entrada en el crontab. Comprobación manual:
sudo -u www-data php /var/www/orbitra/telegram_poll_cron.php --once
Comandos
| Comando | Qué hace | ||||||
|---|---|---|---|---|---|---|---|
/stats | Las estadísticas de hoy; /stats yesterday, /stats 1d, /stats 7d, /stats 30d | ||||||
/campaigns | Las campañas activas, con un botón para cada una | ||||||
/campaign ID | Detalles de la campaña | ||||||
/top | Las top 5 campañas por revenue hoy | ||||||
/conversions | Las últimas 10 conversiones | ||||||
| `/notify on\ | off` | Notificaciones de conversiones; sin argumento — el estado actual y un botón | |||||
| `/daily on\ | off` | El resumen diario | |||||
| `/lang en\ | ru\ | uk\ | es\ | zh\ | fr\ | de` | El idioma del bot; sin argumento — elegir con botones |
/sources | Las fuentes de tráfico y el estado de su comprobación de URL | ||||||
/checksources | Comprobar las URLs de todas las fuentes | ||||||
/allow ID | Permitir un chat más por su ID | ||||||
/help | Ayuda y volver a fijar el menú |
Los comandos sin argumento no cambian nada: /notify muestra el estado actual en vez de apagar las notificaciones.
Notificaciones
- En una conversión — campaña, estado, importe y moneda, país con bandera, hora.
- Resumen diario — clics, conversiones, revenue, costos, ganancia y las top 3 campañas. La hora de envío es
telegram_daily_timeen los ajustes de la integración. El resumen lo envía el poller (también en modo webhook), como mucho una vez al día.
Canales de Telegram como ofertas — bots de embudo aparte
El bot de admin nunca es el destino de una oferta de canal de Telegram. Los visitantes de los anuncios hablan con bots de embudo aparte (Admin → Telegram funnel bots), atendidos por su propio worker; el bot de admin sigue respondiendo solo a los chats que admitiste. Ver PWA externas y canales de Telegram.
Alertas de conversiones a canales
Notifications → Telegram → Conversion alerts to channels (la conexión del bot queda en Integrations → Telegram) envía conversiones elegidas a un canal o grupo a través del bot de admin: eliges el chat (el bot debe ser admin del canal o miembro del grupo, pulsa Check), los estados (deposit, registration, sale, tg_join…), las campañas y una plantilla HTML con macros — {campaign}, {offer}, {status}, {payout}, {currency}, {country}, {flag}, {source}, {ad_campaign_name}, {adset_name}, {ad_name} (nombres del lado de la plataforma de anuncios, de la sincronización de costos), {sub1}–{sub3}, {click_id}, {time}, {date}. Send test publica valores de muestra; el log guarda los últimos 200 envíos por alerta. El interruptor /notify por chat sigue funcionando como antes.
Inicio rápido: tu primera campaña
El camino corto: instala el tracker, crea la red, la oferta y la campaña, y consigue tus primeros clics y conversiones en menos de una hora.
Leer la guía →DocsInstalación y actualizaciones
Instala Orbitra en un servidor Ubuntu o Debian recién creado con un solo comando, actualiza PHP y las versiones nuevas de forma segura.
Leer la guía →DocsMigrar desde Keitaro
Mueve campañas, ofertas, fuentes y dominios de Keitaro a Orbitra con un dump SQL — qué se transfiere y qué revisar después.
Leer la guía →DocsMigrar desde Binom
Mueve campañas y flujos de Binom v2 a Orbitra vía su Public API — qué se transfiere automáticamente y qué se ajusta a mano.
Leer la guía →DocsResumen de funciones
Todo lo que Orbitra puede hacer: campañas y flujos, cloaking, landings, PWA, postbacks, costos, informes e integraciones.
Leer la guía →DocsCampañas y flujos
La referencia completa: ajustes de campaña, tipos de flujo, esquemas, rotación, filtros, test links y cada opción explicada.
Leer la guía →DocsCloaking: referencia completa
Referencia completa del cloaking: capas de detección, sensibilidad, ajustes globales, veredictos, motivos e informes.
Leer la guía →DocsBrowser check
Cómo el check JS atrapa bots, VMs y emuladores por contradicciones del navegador: modos Off / Observe / Soft / Strict y sus signos.
Leer la guía →DocsLanding pages (referencia)
Tipos de landing, la macro {offer}, el adaptador JS, LeadForge y landings multi-oferta — la referencia completa.
Leer la guía →DocsPWA y Web Push
Crea apps PWA instalables y tu propia base de suscriptores push: constructor, claves VAPID, mensajes, atribución y solución de problemas.
Leer la guía →DocsEmbudo de PWA
Cómo funciona el embudo configurable de una PWA: pasos y tipos de pantalla, tracking por pantalla, estadísticas del embudo y vista previa en el editor.
Leer la guía →DocsPopups de conversión
Muestra conversiones reales como popups en tus landings: activación por campaña, plantillas por vertical, disparadores y ubicación.
Leer la guía →DocsGrabaciones de sesión y mapas de calor
Reproduce visitas reales y consulta el mapa de calor de clics y de scroll. Límites de almacenamiento y notas de privacidad.
Leer la guía →DocsContent Gallery (referencia)
Almacenamiento central de iconos, capturas y creativos usados en PWAs y landings: carpetas, límites y el MediaPicker en los editores.
Leer la guía →DocsBiblioteca de creativos
Almacena creativos con tracking de subid y pruébalos en distintas campañas: métricas por creativo sincronizadas con Facebook y TikTok.
Leer la guía →DocsPWA externas y canales de Telegram
Publica PWAs en dominios externos y usa canales de Telegram como fuente de tráfico con suscriptores atribuidos.
Leer la guía →DocsPostbacks y conversiones
Postbacks entrantes, estados y tipos de conversión, y postbacks S2S salientes hacia tu fuente de tráfico.
Leer la guía →DocsCostos
Importa el gasto de Facebook, TikTok y Google Ads, o actualízalo por API y cron — y cómo funciona el agregador de ingresos.
Leer la guía →DocsRedes push y pop
Trabajo con fuentes de tráfico push y pop: importación de gasto por campaña y zona, optimización de zonas y el Zone Killer.
Leer la guía →DocsFacebook / Meta
Importación de costos desde Meta Ads y Conversions API: eventos del lado del servidor con deduplicación.
Leer la guía →DocsDolphin / Fbtool
Recibe los costos de Facebook vía la API de Dolphin (Fbtool) en tiempo real: clave de API, configuración de cada servicio y cómo se reparte el gasto entre los clics.
Leer la guía →DocsFB Comment Cleaner
Modera en bloque los comentarios bajo tus anuncios de Meta: ocultar, borrar y filtrar por palabras clave, con dry run, journal y auto-pausa.
Leer la guía →DocsFuentes de tráfico y redes de afiliados
Los dos directorios que configuran los bordes del embudo: plantillas y parámetros de fuentes y redes, postback global, macros de oferta y LeadForge.
Leer la guía →DocsInformes, logs y métricas
El constructor de informes, tendencias y cohortes, el log de tráfico y la tarjeta del clic, más la definición de cada métrica.
Leer la guía →DocsDominios y SSL
Añade dominios, apunta el DNS y emite certificados Let's Encrypt gratis: ajustes del dominio, modos SSL, registrars conectados y Backorder.
Leer la guía →DocsCloudflare
Cómo pasar los dominios de campaña por Cloudflare vía API: token, parking automático del registro A, modos SSL de zona y proxy.
Leer la guía →DocsAdministración
Usuarios, roles y permisos, ajustes de seguridad y privacidad, bases de datos geo, actualizaciones y estado del sistema.
Leer la guía →DocsBot de Telegram
Gestiona el tracker desde Telegram: estadísticas, conversiones y alertas en el chat, con webhook o polling.
Leer la guía →DocsMCP: un asistente de IA en el tracker
Conecta Claude o cualquier cliente MCP a Orbitra y maneja campañas con comandos en lenguaje natural: claves de API, conexión y seguridad.
Leer la guía →