Estes guias mapeiam os conceitos de um setor para os objetos que a plataforma tem hoje (bouquets, lines, pacotes, contas de parceiro, nodes, a API). São mapeamentos conceituais, não recursos específicos de um setor, e uma conta de parceiro é uma conta delegada, não um tenant isolado.
Mapeamento conceitual
Nada no painel se chama quarto ou estadia. A tabela diz qual objeto faz qual papel; os capítulos abaixo os configuram nessa ordem.
| No seu setor | Na plataforma | Onde no painel |
|---|---|---|
| Operador do hotel ou parceiro autorizado | Conta de parceiro (revendedor): um painel delegado com créditos, permissões e suas próprias lines | Users → adicionar um revendedor; Groups para 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 | Line: um acesso com seu pacote, bouquets, expiração, limite de conexões e saídas | Lines → adicionar, ou códigos de ativação, ou a Reseller API |
| Vídeos informativos do hotel | Catálogo de VOD: filmes e séries com temporadas e episódios, categorias e metadados | Movies e Series, ou a tarefa de ingestão de VOD |
| Canais de televisão licenciados | Canal ao vivo: um stream com suas fontes, EPG e formatos de saída | Streams → adicionar um stream ao vivo (URL de origem ou envio por RTMP) |
| Duração da estadia | Data de expiração da line, renovada por um pacote, um crédito ou a API | A data de expiração da line e a duração do pacote |
| Um node por prédio ou ala | Nodes de streaming: servidores de borda registrados pelo painel, um por local ou prédio | Servers → adicionar um node, instalado por SSH |
Pré-requisitos
O que ter antes de instalar.
- Um servidor na rede do estabelecimento (Ubuntu 22.04 ou 24.04), o instalador e um endereço que os dispositivos dos quartos consigam alcançar.
- Os feeds de canais dos quais o estabelecimento detém os direitos (URLs de pull ou RTMP), os vídeos informativos do hotel e os dispositivos dos quartos (aparelhos Android TV, aparelhos MAG ou Enigma2, smart TVs com um aplicativo de player ou um navegador).
- A capacidade do PMS de chamar uma API HTTP no check-in e no check-out, ou um procedimento da recepção para fazer isso no painel.
Implantação da infraestrutura
O servidor central e um node por prédio.
- Execute o instalador no servidor central; defina a base de reprodução como o endereço interno do estabelecimento para que os quartos permaneçam na rede local.
- Adicione os feeds de canais em Streams e os vídeos informativos em Movies; confira-os no player web.
- Registre um node por ala ou prédio em Servers; o painel o instala por SSH e direciona a ele os quartos desse prédio.
- Defina a chave de licença no servidor; a ativação acontece no local e o serviço funciona sem o link externo.
Organização do conteúdo
Pacotes de canais e vídeos do hotel.
- Crie um bouquet por pacote de canais (quartos padrão, suítes, conferências) a partir dos canais do estabelecimento.
- 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 ele concede e duração de um dia: no check-in a line do quarto é renovada uma vez por noite da estadia (cada renovação soma a duração do pacote) e no check-out ela é desativada (capítulo 8).
- Ordene os canais e dê logotipos a eles para que o menu na televisão fique legível.
Configuração de parceiros (revendedores)
O estabelecimento, ou um operador que gerencia vários estabelecimentos, como conta delegada.
- Crie um grupo com permissões limitadas a lines (quartos) e sem alterações no catálogo.
- Adicione a recepção do estabelecimento, ou o operador, como revendedor com esse grupo e os pacotes dos quartos.
- Um operador de vários estabelecimentos recebe um revendedor por estabelecimento, cada um com seus próprios quartos e créditos.
Configuração do quarto (line)
Uma line por quarto, nomeada pelo seu número.
- Crie uma line por quarto em Lines com o número do quarto como nome e o pacote da categoria do quarto.
- Defina o máximo de conexões como 1 (uma televisão) ou como o número de telas do quarto.
- Vincule a line ao endereço do dispositivo do quarto quando a rede der endereços fixos aos dispositivos.
- Configure o dispositivo uma vez (API Xtream Codes ou M3U com as credenciais da line, ou o portal MAG / Enigma2); as credenciais ficam com o quarto.
Vídeos informativos do hotel
Os vídeos do próprio estabelecimento sob demanda.
- Envie os vídeos de boas-vindas e informativos como filmes, com as versões em outros idiomas do estabelecimento como itens separados ou faixas de áudio.
- Coloque-os no bouquet de vídeos do hotel para que todas as categorias de quarto os recebam.
- Atualize-os pelo painel sempre que as informações mudarem; os quartos veem a nova versão de imediato.
Canais de televisão licenciados
Os canais do estabelecimento como streams ao vivo.
- Adicione cada canal licenciado em Streams com seu feed; ative timeshift ou catch-up somente onde a licença permitir.
- Adicione uma fonte de EPG para que o guia na televisão mostre a programação.
- Mantenha os canais restritos por território em bouquets que só os pacotes certos concedem.
Check-in, check-out e expiração
A estadia como validade da line.
- No check-in, ative a line do quarto e renove-a pela duração da estadia (o PMS pela API, ou a recepção no painel).
- No check-out, desative a line; uma nova estadia a ativa de novo, então as credenciais nunca saem do quarto.
- Inscreva o PMS ou a recepção nos webhooks para ver lines ativadas, desativadas e expiradas.
Integração com o PMS
O check-in e o check-out conduzem 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 line do quarto com um ID de requisição; no check-out, action=disable_line.
- O aplicativo de serviços ao hóspede (chamar a equipe, governança, check-out expresso, serviço de quarto) e sua conexão com o back-office fazem parte do plano Enterprise e são dimensionados junto com o estabelecimento.
Considerações de segurança
Mantenha os canais dentro do estabelecimento.
- Mantenha a base de reprodução e os nodes na rede do estabelecimento; não exponha à internet nada que os quartos não precisem.
- Uma conexão por quarto, vinculada ao dispositivo; os links assinados expiram, então um link copiado deixa de funcionar.
- Login em duas etapas para o painel; a recepção recebe um grupo de permissões limitado.
- Ative o backup criptografado do banco de dados; as credenciais dos quartos estão nele.
Solução de problemas
As primeiras verificações habituais.
- Um quarto está sem televisão: verifique se a line está ativada e não expirada, depois as credenciais e o endereço do dispositivo.
- Falta um canal em um quarto: verifique o bouquet do pacote da categoria do quarto.
- A televisão para durante uma queda de internet: verifique se a base de reprodução e as fontes são endereços internos; feeds externos dependem do link.
- A chamada do PMS falha: verifique a chave da API, se as escritas são POST e o ID de requisição nas novas tentativas.