Docs

PWA externas y canales de Telegram

Dos maneras de ensanchar el embudo más allá del constructor de PWA propio de Orbitra: servicios de PWA de terceros como objetivos de flujo, y canales de Telegram como destinos de oferta con suscriptores atribuidos.

Constructores de PWA externos

Un servicio de terceros (PWA.Group, TSL.app, o cualquier otro) puede ser un objetivo de flujo exactamente igual que una landing:

  1. Crea el builder — ⚙ → Integrations → External PWA. Elige un servicio del catálogo (data/external_pwa_services.json: plantilla de URL de redirección, plantilla de postback, mapa de estados) o rellena el tuyo; tus valores ganan a los del catálogo. Las entradas del catálogo que vienen de fábrica son plantillas — verifica cada parámetro contra la documentación actual del servicio antes de enviar tráfico real.
  2. Apunta el servicio de vuelta: en sus ajustes, pon la redirección post-instalación a

https://<tracker-domain>/eflow/<campaign-alias>?subid={subid}&eid={eid} (la página muestra la forma exacta para copiar y pegar).

  1. Añádelo a un flujo — en el bloque de landings del editor de campaña, Add external PWA. Los builders externos van en el mismo pool ponderado que las landings, así que el reparto te da un A/B "PWA propia vs la suya" en un solo embudo.

Qué pasa con el tráfico: el clic sale hacia el servicio con subid = click id (clicks.external_pwa_id recuerda qué servicio). Cuando el visitante vuelve a /eflow/<alias>, el tracker estampa la instalación (external_install_at), guarda el eid del servicio (se conserva 7 días) y continúa hacia la oferta con la selección propia de la campaña — exactamente igual que una PWA "propia" tras la instalación.

Las conversiones de esos clics se devuelven al servicio por la misma cola s2s confiable que los postbacks de socios, con subid + eid + la palabra de estado del servicio (mapeada por servicio) + payout. Los informes de campaña ganan instalaciones externas.

Canales de Telegram como ofertas

Una oferta de tipo canal de Telegram manda a los visitantes del anuncio a un canal de Telegram a través de un funnel bot y acredita la unión como conversión. Los funnel bots están separados del bot de administración (Integrations → Telegram): el bot de administración solo responde a los chats que conectaste y lee tus estadísticas, así que desconocidos llegados de un anuncio no deben alcanzarlo jamás. El panel rechaza el token del bot de administración como funnel bot.

Configuración:

  1. Crea un bot nuevo en @BotFather y añade su token en ⚙ → Integrations → Telegram funnel bots.
  2. Añade ese bot a tu canal como administrador con el permiso Invite users via link. El canal aparece solo en la tarjeta del bot (o añádelo ahí por @name, t.me/… o -100…).
  3. Crea una oferta de tipo Telegram, elige el bot y el canal, fija la ventana de unión (1–7 días) y, opcionalmente, un texto de bienvenida.
  4. Mete la oferta en un flujo de campaña y corre tráfico por el enlace de la campaña. Nunca repartas un enlace directo del canal — esas uniones no se pueden atribuir.

El embudo:

  1. Clic → https://t.me/<funnel bot>?start=<subid> — /start vincula al usuario de Telegram con el clic (tg_start).
  2. El bot responde con el texto de bienvenida y una invitación de solicitud de ingreso (creates_join_request=true, que expira con la ventana de la oferta).
  3. chat_join_request → el bot aprueba solo a los usuarios que él invitó dentro de la ventana y escribe una conversión tg_join (con campaña y oferta) sobre el clic vinculado. Las solicitudes de cualquier otro se dejan a los moderadores del canal.
  4. Una red que solo conoce al suscriptor hace post al postback URL regular con tg_user_id y channel_id en lugar de subid:

https://<domain>/<postback key>/postback?tg_user_id={tg_user_id}&channel_id=-100…&status=deposit&payout=50 — se resuelve al clic de la última unión de ese usuario al canal dentro de 30 días. La pestaña Integration del editor de oferta muestra la URL exacta.

Los funnel bots se consultan por cli/tg_funnel_poll_cron.php (cada minuto, todos los bots en paralelo, sin webhook — funciona sin dominio). install.sh lo programa; la página de bots muestra la línea de crontab cuando el poller no está corriendo.

← Anterior
Biblioteca de creativos
Siguiente →
Postbacks y conversiones
Ver el código en GitHub: github.com/fenjo26/Orbitra.link/wiki
Todas las guías
Docs

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 →
Docs

Instalació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 →
Docs

Migrar 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 →
Docs

Migrar 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 →
Docs

Resumen de funciones

Todo lo que Orbitra puede hacer: campañas y flujos, cloaking, landings, PWA, postbacks, costos, informes e integraciones.

Leer la guía →
Docs

Campañ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 →
Docs

Cloaking: referencia completa

Referencia completa del cloaking: capas de detección, sensibilidad, ajustes globales, veredictos, motivos e informes.

Leer la guía →
Docs

Browser 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 →
Docs

Landing pages (referencia)

Tipos de landing, la macro {offer}, el adaptador JS, LeadForge y landings multi-oferta — la referencia completa.

Leer la guía →
Docs

PWA 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 →
Docs

Embudo 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 →
Docs

Popups 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 →
Docs

Grabaciones 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 →
Docs

Content 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 →
Docs

Biblioteca 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 →
Docs

PWA 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 →
Docs

Postbacks y conversiones

Postbacks entrantes, estados y tipos de conversión, y postbacks S2S salientes hacia tu fuente de tráfico.

Leer la guía →
Docs

Costos

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 →
Docs

Redes 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 →
Docs

Facebook / Meta

Importación de costos desde Meta Ads y Conversions API: eventos del lado del servidor con deduplicación.

Leer la guía →
Docs

Dolphin / 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 →
Docs

FB 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 →
Docs

Fuentes 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 →
Docs

Informes, 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 →
Docs

Dominios 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 →
Docs

Cloudflare

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 →
Docs

Administración

Usuarios, roles y permisos, ajustes de seguridad y privacidad, bases de datos geo, actualizaciones y estado del sistema.

Leer la guía →
Docs

Bot de Telegram

Gestiona el tracker desde Telegram: estadísticas, conversiones y alertas en el chat, con webhook o polling.

Leer la guía →
Docs

MCP: 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 →