Estas guías asignan los conceptos de un sector a los objetos que la plataforma tiene hoy (bouquets, líneas, paquetes, cuentas de socio, nodos, la API). Son correspondencias conceptuales, no funciones específicas de un sector, y una cuenta de socio es una cuenta delegada, no un inquilino aislado.
Correspondencia conceptual
Nada en el panel se llama suscripción ni punto de presencia. La tabla indica qué objeto cumple cada papel; los capítulos siguientes los configuran en ese orden.
| En tu sector | En la plataforma | Dónde en el panel |
|---|---|---|
| Cuenta de revendedor o de socio regional | Cuenta de revendedor (reseller): un panel delegado con créditos, permisos y sus propias líneas | Users → añadir un revendedor; Groups para sus permisos |
| Nivel de canales o pack adicional | Bouquet: un conjunto con nombre de canales, películas o series que concede un paquete | Bouquets, a partir de Streams y Movies / Series |
| Canal de televisión | Canal en directo: un stream con sus fuentes, EPG y formatos de salida | Streams → añadir un stream en directo (URL de origen o envío RTMP) |
| Biblioteca VOD | Catálogo VOD: películas y series con temporadas y episodios, categorías y metadatos | Movies y Series, o la tarea de ingesta VOD |
| Acceso de televisión del suscriptor | Línea: un acceso con su paquete, bouquets, caducidad, límite de conexiones y salidas | Lines → añadir, o códigos de activación, o la Reseller API |
| Fin del periodo de facturación | Fecha de caducidad de la línea, renovada mediante un paquete, un crédito o la API | La fecha de caducidad de la línea y la duración del paquete |
| Pantallas por suscripción | Conexiones máximas de la línea: cuántos dispositivos pueden ver a la vez | Las conexiones máximas de la línea |
| Integración de facturación y aprovisionamiento | Reseller API y webhooks: las operaciones del panel desde tu propio sistema | Claves de la Reseller API y webhooks en el panel del revendedor |
| Nodo del punto de presencia | Nodos de streaming: servidores de borde registrados desde el panel, uno por sede o edificio | Servers → añadir un nodo, instalado por SSH |
Requisitos previos
Lo que debes tener antes de instalar.
- Un servidor en la sede central (Ubuntu 22.04 o 24.04), el instalador, un dominio o dirección a la que puedan acceder los suscriptores y un servidor en cada punto de presencia para los nodos.
- Las señales de canales con licencia, la biblioteca VOD y el sistema de facturación en el que viven las suscripciones.
- Una decisión sobre los niveles, cuánto dura un periodo de facturación y qué revendedores reciben una cuenta de socio.
Despliegue de la infraestructura
La sede central, después los puntos de presencia.
- Ejecuta el instalador en el servidor central; coloca el panel detrás de tu proxy inverso y define TRUSTED_PROXIES para que los registros y las reglas de IP vean la dirección real del suscriptor.
- Define la base de reproducción como la dirección pública a la que acceden los suscriptores, y la clave de licencia en el servidor.
- Registra un nodo por punto de presencia desde Servidores; el panel lo instala por SSH, o el nodo se registra con un código de un solo uso, y dirige a él a los suscriptores cercanos.
- Crea una cuenta de socio (revendedor) para soporte o para el equipo de facturación con permisos solo para líneas.
Organización del contenido
Niveles y packs como bouquets.
- Añade los canales en Emisiones y la biblioteca VOD en Películas y Series, con categorías y una fuente EPG.
- Crea bouquets para la parrilla básica, los canales premium y la biblioteca VOD.
- Crea un paquete por nivel de suscripción con los bouquets que concede, el periodo de facturación como duración y un precio en créditos.
- Crea un paquete de prueba corto para una promoción o un cliente nuevo.
Configuración de socios (revendedores)
Revendedores con créditos.
- Crea un grupo para revendedores con permisos para sus propias líneas y sin acceso al catálogo ni a los ajustes.
- Añade a cada revendedor regional como cuenta de socio con ese grupo, los paquetes que puede vender y un saldo de créditos; un revendedor puede tener subrevendedores hasta cinco niveles de profundidad.
- El webhook credits.low y el aviso de créditos bajos indican a un revendedor que recargue antes de que se detengan las ventas.
Configuración de las líneas de suscriptores
Una línea por suscripción.
- La facturación crea una línea cuando empieza una suscripción, mediante un conector o action=create_line de la Reseller API con el paquete del nivel y un identificador de petición.
- Define el máximo de conexiones por nivel, el número de pantallas que un hogar puede usar a la vez.
- Vincula una línea a la dirección, el país o el ISP del suscriptor cuando la oferta sea solo para tu red.
- Para un piloto o un caso de soporte, añade líneas desde Líneas → añadir y entrega las credenciales.
Biblioteca VOD
El catálogo a la carta.
- Añade películas y series con temporadas y episodios, ingeridas con la tarea de ingesta VOD o subidas, con metadatos de TMDB para carteles y descripciones.
- Agrupa los títulos en bouquets por nivel o complemento, para que un paquete conceda exactamente lo que incluye la suscripción.
- Los nodos guardan en caché los archivos VOD, de modo que los títulos populares se sirven desde el punto de presencia cercano al suscriptor.
Canales en directo
La parrilla.
- Añade cada canal con licencia en Emisiones con su señal y activa catch-up o timeshift solo donde los derechos lo permitan.
- Añade una fuente EPG para que las aplicaciones y los receptores muestren la guía de programación.
- Cada nodo toma un canal en directo una sola vez del origen y lo reparte a sus suscriptores.
Caducidad, renovación y cancelación
El periodo de facturación como validez de la línea.
- Una línea dura el periodo de su paquete; la facturación la renueva cada periodo con action=renew_line o mediante el conector.
- Cuando una suscripción caduca o se cancela, la facturación llama a action=disable_line, y vuelve a activar la línea al reactivarse.
- Suscribe la facturación a los webhooks para conciliar con sus registros las líneas que van a caducar y las caducadas.
Integración con la facturación
La facturación gestiona el acceso; el reproductor reproduce.
- Instala en su lado el conector de tu sistema de facturación (WHMCS, Blesta, Odoo y otros), o llama a la Reseller API con una clave y un identificador de petición desde tu propio sistema.
- No hay inicio de sesión único para los espectadores: un suscriptor entra en una aplicación o un receptor con las credenciales de la línea, que la facturación puede mostrar en el área de cliente.
- Usa claves de la Admin API con indicador de solo lectura, lista de IP permitidas y fecha de caducidad para las herramientas de informes.
Consideraciones de seguridad
Mantén el servicio para los suscriptores.
- Coloca el panel detrás del proxy inverso con TLS y define TRUSTED_PROXIES; mantén el tráfico de gestión de los nodos en una red privada.
- Inicio de sesión en dos pasos para cada cuenta del panel y grupos de permisos para soporte y revendedores; reCAPTCHA o Turnstile en el inicio de sesión.
- Enlaces de reproducción firmados y con caducidad, un límite de conexiones por suscripción y vinculación a una dirección, un país o un ISP donde convenga.
- Copias de seguridad cifradas de la base de datos con una copia externa, y el registro de auditoría de cada cambio de líneas y créditos.
Resolución de problemas
Las primeras comprobaciones habituales.
- Un suscriptor no tiene televisión: comprueba que la línea esté activada y no caducada, y después la llamada de la facturación en el registro de llamadas de la Reseller API.
- Falta un canal en un nivel: comprueba los bouquets del paquete de ese nivel.
- Un punto de presencia se entrecorta: comprueba el latido de su nodo y que sus suscriptores se dirigen a él.
- Un revendedor no puede crear una línea: comprueba sus créditos y que el paquete sea uno que puede vender.