Estes guias fazem corresponder os conceitos de um setor aos objetos que a plataforma tem hoje (bouquets, linhas, pacotes, contas de parceiro, nós, a API). São correspondências conceptuais, não funcionalidades específicas de um setor, e uma conta de parceiro é uma conta delegada, não um inquilino isolado.
Correspondência conceptual
Nada no painel se chama quarto ou estadia. A tabela indica que objeto desempenha que papel; os capítulos seguintes configuram-nos por essa ordem.
| No seu setor | Na plataforma | Onde no painel |
|---|---|---|
| Operador hoteleiro ou parceiro autorizado | Conta de revendedor (reseller): um painel delegado com créditos, permissões e as suas próprias linhas | Users → adicionar um revendedor; Groups para as suas permissões |
| Pacote de canais | Bouquet: um conjunto nomeado de canais, filmes ou séries que um pacote concede | Bouquets, a partir de Streams e Movies / Series |
| Quarto ou dispositivo | Linha: um acesso com o seu pacote, bouquets, validade, limite de ligações e saídas | Lines → adicionar, ou códigos de ativação, ou a Reseller API |
| Vídeos de informação do hotel | Catálogo VOD: filmes e séries com temporadas e episódios, categorias e metadados | Movies e Series, ou a tarefa de ingestão VOD |
| Canais de televisão licenciados | Canal em direto: um stream com as suas fontes, EPG e formatos de saída | Streams → adicionar um stream em direto (URL de origem ou envio RTMP) |
| Duração da estadia | Data de validade da linha, renovada por um pacote, um crédito ou pela API | A data de validade da linha e a duração do pacote |
| Um nó por edifício ou ala | Nós de streaming: servidores edge registados a partir do painel, um por local ou edifício | Servers → adicionar um nó, instalado por SSH |
Pré-requisitos
O que ter antes de instalar.
- Um servidor na rede da unidade (Ubuntu 22.04 ou 24.04), o instalador e um endereço que os dispositivos dos quartos consigam alcançar.
- Os feeds de canais de que a unidade detém os direitos (URLs de obtenção ou RTMP), os vídeos de informação do hotel e os dispositivos dos quartos (boxes Android TV, boxes MAG ou Enigma2, smart TVs com uma aplicação de leitor ou um navegador).
- A capacidade do PMS de chamar uma API HTTP no check-in e no check-out, ou um procedimento da receção para o fazer no painel.
Implementação da infraestrutura
O servidor central e um nó por edifício.
- Execute o instalador no servidor central; defina a base de reprodução para o endereço interno da unidade para que os quartos fiquem na rede local.
- Adicione os feeds de canais em Streams e os vídeos de informação em Movies; verifique-os no leitor web.
- Registe um nó por ala ou edifício em Servers; o painel instala-o por SSH e encaminha os quartos desse edifício para ele.
- Defina a chave de licença no servidor; a ativação faz-se no local e o serviço funciona sem a ligação ao exterior.
Organização do conteúdo
Pacotes de canais e vídeos do hotel.
- Crie um bouquet por pacote de canais (quartos standard, suites, conferências) a partir dos canais da unidade.
- Crie um bouquet de vídeos do hotel (boas-vindas, instalações, segurança) e adicione-o a todos os pacotes.
- Crie um pacote por categoria de quarto com os bouquets que concede e uma duração de um dia: no check-in, a linha do quarto é renovada uma vez por noite de estadia (cada renovação acrescenta a duração do pacote) e, no check-out, é desativada (capítulo 8).
- Ordene os canais e atribua-lhes logótipos para que o menu na televisão se leia bem.
Configuração de parceiros (revendedores)
A unidade, ou um operador que gere várias unidades, como conta delegada.
- Crie um grupo com permissões limitadas a linhas (quartos) e sem alterações ao catálogo.
- Adicione a receção da unidade, ou o operador, como revendedor com esse grupo e os pacotes dos quartos.
- Um operador de várias unidades recebe um revendedor por unidade, cada um com os seus quartos e créditos.
Configuração dos quartos (linhas)
Uma linha por quarto, com o número como nome.
- Crie uma linha por quarto em Lines com o número do quarto como nome e o pacote da categoria do quarto.
- Defina o máximo de ligações como 1 (uma televisão) ou como o número de ecrãs do quarto.
- Associe a linha ao endereço do dispositivo do quarto quando a rede atribui endereços fixos aos dispositivos.
- Configure o dispositivo uma só vez (API Xtream Codes ou M3U com as credenciais da linha, ou o portal MAG / Enigma2); as credenciais ficam com o quarto.
Vídeos de informação do hotel
Os vídeos da própria unidade a pedido.
- Carregue os vídeos de boas-vindas e de informação como filmes, com as versões nas várias línguas da unidade como entradas separadas ou faixas de áudio.
- Coloque-os no bouquet de vídeos do hotel para que todas as categorias de quarto os recebam.
- Atualize-os a partir do painel sempre que a informação mudar; os quartos veem logo a nova versão.
Canais de televisão licenciados
Os canais da unidade como streams em direto.
- Adicione cada canal licenciado em Streams com o seu feed; ative o timeshift ou o catch-up apenas onde a licença o permite.
- Adicione uma fonte de EPG para que o guia na televisão mostre os programas.
- Mantenha os canais limitados a um território em bouquets que só os pacotes certos concedem.
Check-in, check-out e validade
A estadia como validade da linha.
- No check-in, ative a linha do quarto e renove-a pela duração da estadia (o PMS através da API, ou a receção no painel).
- No check-out, desative a linha; uma nova estadia ativa-a de novo, pelo que as credenciais nunca saem do quarto.
- Subscreva os webhooks no PMS ou na receção para ver as linhas ativadas, desativadas e expiradas.
Integração com o PMS
O check-in e o check-out comandam os quartos.
- Crie uma chave da Reseller API para o PMS e guarde-a na configuração do PMS.
- No check-in, o PMS chama action=enable_line e action=renew_line para a linha do quarto com um identificador de pedido; no check-out, action=disable_line.
- A aplicação de serviços ao hóspede (chamar o pessoal, limpeza, check-out expresso, serviço de quartos) e a sua ligação ao back-office fazem parte do plano Enterprise e são definidas com a unidade.
Considerações de segurança
Mantenha os canais dentro da unidade.
- Mantenha a base de reprodução e os nós na rede da unidade; não exponha à internet nada de que os quartos não precisem.
- Uma ligação por quarto, associada ao dispositivo; as ligações assinadas expiram, pelo que uma ligação copiada deixa de funcionar.
- Início de sessão com dois fatores no painel; a receção recebe um grupo de permissões limitado.
- Ative a cópia de segurança cifrada da base de dados; as credenciais dos quartos estão nela.
Resolução de problemas
As primeiras verificações habituais.
- Um quarto está sem televisão: verifique se a linha está ativada e não expirou, depois as credenciais e o endereço do dispositivo.
- Falta um canal num quarto: verifique o bouquet do pacote da categoria do quarto.
- A televisão para durante uma falha de internet: verifique se a base de reprodução e as fontes são endereços internos; os feeds externos dependem da ligação ao exterior.
- A chamada do PMS falha: verifique a chave da API, se as escritas são POST e o identificador de pedido nas repetições.