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 habitación o estancia. La tabla indica qué objeto desempeña qué papel; los capítulos siguientes los configuran en ese orden.
| En tu sector | En la plataforma | Dónde en el panel |
|---|---|---|
| Operador del hotel o socio autorizado | 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 |
| Paquete de canales | Bouquet: un conjunto con nombre de canales, películas o series que concede un paquete | Bouquets, a partir de Streams y Movies / Series |
| Habitación o dispositivo | 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 |
| Vídeos informativos del hotel | Catálogo VOD: películas y series con temporadas y episodios, categorías y metadatos | Movies y Series, o la tarea de ingesta VOD |
| Canales de televisión con licencia | 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) |
| Duración de la estancia | 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 |
| Un nodo por edificio o ala | 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
Qué tener antes de instalar.
- Un servidor en la red del establecimiento (Ubuntu 22.04 o 24.04), el instalador y una dirección a la que puedan llegar los dispositivos de las habitaciones.
- Las señales de canales cuyos derechos posee el establecimiento (URL de descarga o RTMP), los vídeos informativos del hotel y los dispositivos de las habitaciones (cajas Android TV, receptores MAG o Enigma2, smart TV con una aplicación de reproducción o un navegador).
- La capacidad del PMS de llamar a una API HTTP en el check-in y el check-out, o un procedimiento en recepción para hacerlo en el panel.
Despliegue de la infraestructura
El servidor central y un nodo por edificio.
- Ejecuta el instalador en el servidor central; define la base de reproducción con la dirección interna del establecimiento para que las habitaciones se queden en la red local.
- Añade las señales de los canales en Streams y los vídeos informativos en Movies; compruébalos en el reproductor web.
- Registra un nodo por ala o edificio desde Servers; el panel lo instala por SSH y dirige a él las habitaciones de ese edificio.
- Introduce la clave de licencia en el servidor; la activación se hace en el sitio y el servicio funciona sin la conexión externa.
Organización del contenido
Paquetes de canales y vídeos del hotel.
- Crea un bouquet por paquete de canales (habitaciones estándar, suites, conferencias) a partir de los canales del establecimiento.
- Crea un bouquet de vídeos del hotel (bienvenida, instalaciones, seguridad) y añádelo a todos los paquetes.
- Crea un paquete por categoría de habitación con los bouquets que concede y una duración de un día: en el check-in la línea de la habitación se renueva una vez por noche de estancia (cada renovación suma la duración del paquete) y en el check-out se desactiva (capítulo 8).
- Ordena los canales y ponles logotipos para que el menú de la televisión se lea bien.
Configuración de socios (revendedores)
El establecimiento, o un operador que gestiona varios establecimientos, como cuenta delegada.
- Crea un grupo con permisos limitados a las líneas (habitaciones) y sin cambios en el catálogo.
- Añade la recepción del establecimiento, o al operador, como revendedor con ese grupo y los paquetes de habitación.
- Un operador de varios establecimientos recibe un revendedor por establecimiento, cada uno con sus propias habitaciones y créditos.
Configuración de habitaciones (líneas)
Una línea por habitación, con su número como nombre.
- Crea una línea por habitación en Lines con el número de habitación como nombre y el paquete de la categoría de la habitación.
- Define las conexiones máximas en 1 (un televisor) o en el número de pantallas de la habitación.
- Vincula la línea a la dirección del dispositivo de la habitación cuando la red asigne direcciones fijas a los dispositivos.
- Configura el dispositivo una sola vez (API de Xtream Codes o M3U con las credenciales de la línea, o el portal MAG / Enigma2); las credenciales se quedan en la habitación.
Vídeos informativos del hotel
Los vídeos propios del establecimiento bajo demanda.
- Sube los vídeos de bienvenida e información como películas, con las versiones en cada idioma del establecimiento como entradas separadas o pistas de audio.
- Ponlos en el bouquet de vídeos del hotel para que todas las categorías de habitación los reciban.
- Actualízalos desde el panel cada vez que cambie la información; las habitaciones ven la nueva versión de inmediato.
Canales de televisión con licencia
Los canales del establecimiento como streams en directo.
- Añade cada canal con licencia en Streams con su señal; activa timeshift o catch-up solo donde la licencia lo permita.
- Añade una fuente de EPG para que la guía de la televisión muestre los programas.
- Mantén los canales limitados por territorio en bouquets que solo concedan los paquetes adecuados.
Check-in, check-out y caducidad
La estancia como validez de la línea.
- En el check-in activa la línea de la habitación y renuévala por la duración de la estancia (el PMS mediante la API, o recepción en el panel).
- En el check-out desactiva la línea; una nueva estancia la activa de nuevo, de modo que las credenciales nunca salen de la habitación.
- Suscribe el PMS o recepción a los webhooks para ver las líneas activadas, desactivadas y caducadas.
Integración con el PMS
El check-in y el check-out gestionan las habitaciones.
- Crea una clave de la Reseller API para el PMS y guárdala en la configuración del PMS.
- En el check-in el PMS llama a action=enable_line y action=renew_line para la línea de la habitación con un identificador de solicitud; en el check-out, a action=disable_line.
- La aplicación de servicios al huésped (llamar al personal, limpieza, check-out exprés, servicio de habitaciones) y su conexión con el back-office forman parte del plan Enterprise y se definen con el establecimiento.
Consideraciones de seguridad
Mantén los canales dentro del establecimiento.
- Mantén la base de reproducción y los nodos en la red del establecimiento; no expongas a internet nada que las habitaciones no necesiten.
- Una conexión por habitación, vinculada al dispositivo; los enlaces firmados caducan, así que un enlace copiado deja de funcionar.
- Inicio de sesión en dos pasos para el panel; recepción recibe un grupo de permisos limitado.
- Activa la copia de seguridad cifrada de la base de datos; las credenciales de las habitaciones están en ella.
Resolución de problemas
Las primeras comprobaciones habituales.
- Una habitación no tiene televisión: comprueba que su línea esté activada y no haya caducado, y después las credenciales y la dirección del dispositivo.
- Falta un canal en una habitación: comprueba el bouquet del paquete de la categoría de la habitación.
- La televisión se detiene durante una caída de internet: comprueba que la base de reproducción y las fuentes sean direcciones internas; las señales externas dependen de la conexión externa.
- Falla la llamada del PMS: comprueba la clave de API, que las escrituras sean POST y el identificador de solicitud en los reintentos.