Publicar na TV corporativa

As TVs da recepção, da fábrica e do refeitório exibem uma playlist de slides. Outro sistema pode alimentá-las: o painel de vendas publica a meta batida, o sistema de segurança toma todas as telas com um aviso de evacuação, o monitoramento confere se cada TV está no ar.

Quando usar	Um fato de outro sistema precisa aparecer nas TVs, na hora ou na próxima volta da playlist
Porta	REST · Agente (MCP, só slides e consulta)
Você vai precisar	Módulo TV_CORPORATIVA; permissão TV com nível de edição; token JWT

Como funciona

seu sistema ── GET  /tv/tela/status ─────────────────────▶ TAI  (TVs, grupos, online/offline)

aviso urgente
            ── POST /tv/grupo/{id}/publicar-urgente ─────▶ TVs do grupo trocam em ~2 s
            ── POST /tv/grupo/{id}/encerrar-urgente ─────▶ voltam à playlist

slide na playlist
            ── GET  /tv/conteudo/modelos ────────────────▶ TAI  (modelos prontos)
            ── POST /tv/conteudo/criar-de-modelo ────────▶ TAI  (cria o slide)
            ── POST /tv/item ────────────────────────────▶ entra na playlist, com vigência

Cada TV exibe a programação de um grupo; TVs que compartilham a programação mostram o mesmo slide no mesmo instante. Toda TV nasce com programação própria, então para falar com uma TV só basta o grupoId dela.

Passo a passo

1. Descubra as TVs e os grupos.

   GET /tv/tela/status
   Authorization: Bearer $TAI_TOKEN

   Cada TV traz id, nome, grupoId, grupoNome, online e ultimoSinalEm. Guarde os grupoId das telas que o seu sistema vai usar.

2. Escolha o caminho.

   Aviso urgente

   O aviso toma a tela de todas as TVs do grupo em cerca de 2 segundos e fica no ar até ser encerrado ou até duracaoMin:

   POST /tv/grupo/5/publicar-urgente
   Content-Type: application/json
   
   {
     "template": "AVISO",
     "titulo": "Simulado de evacuação",
     "texto": "Dirija-se ao ponto de encontro do estacionamento B.",
     "corFundo": "#B91C1C",
     "corTexto": "#FFFFFF",
     "duracaoMin": 20
   }

   template aceita AVISO, NOTICIA e BOAS_VINDAS; título ou texto é obrigatório. Em vez dos campos, conteudoId usa um slide da biblioteca (os campos são copiados no momento). Para tirar do ar antes do prazo:

   POST /tv/grupo/5/encerrar-urgente

   Para uma TV só, as mesmas ações existem em /tv/tela/{id}/publicar-urgente e /tv/tela/{id}/encerrar-urgente (valem para as TVs que compartilham a programação dela).

   Slide na playlist

   Os modelos prontos trazem o design; você entrega só os textos. A lista diz para que serve cada um (quandoUsar) e quais chaves preencher (placeholders):

   GET /tv/conteudo/modelos

   POST /tv/conteudo/criar-de-modelo
   Content-Type: application/json
   
   {
     "modeloId": "conquista",
     "titulo": "Meta de vendas — setembro",
     "corDestaque": "#2883C5",
     "valores": {
       "CHAPEU": "RESULTADO DE SETEMBRO",
       "DESTAQUE": "128%",
       "TITULO": "da meta de vendas batida",
       "DESCRICAO": "Parabéns a todos os times."
     }
   }

   A logomarca da empresa entra sozinha quando cadastrada. Guarde o id do conteúdo e ponha-o na playlist do grupo, com vigência:

   POST /tv/item
   Content-Type: application/json
   
   {
     "grupoId": 5,
     "tipo": "CONTEUDO",
     "conteudoId": 640,
     "duracaoSeg": 15,
     "dataInicio": "2026-10-03 08:00:00",
     "dataFim": "2026-10-10 18:00:00"
   }

   O item entra no fim da rotação e sai do ar sozinho no fim da vigência. duracaoSeg vai de 3 a 3.600; sem ele, vale a duração padrão do grupo.

3. Confira o que está passando.

   GET /tv/grupo/5/playlist

   A playlist na ordem de exibição, com cada conteúdo resolvido — inclusive itens inativos e fora de vigência. Para reordenar, POST /tv/item/reordenar com grupoId e a lista completa de itemIds na nova ordem.

Comandos

POST /tv/grupo/{id}/enviar-comando com {"tipo": "PULAR"} avança o slide; PAUSAR, RETOMAR e RECARREGAR completam a lista. telaId restringe a uma TV. O comando vale por 60 segundos: TV desligada não executa ordem velha.

Monitorar as telas

Uma ferramenta de monitoramento pode consultar GET /tv/tela/status a cada poucos minutos e alertar quando uma TV fica online: false — ultimoSinalEm diz desde quando ela não fala com a TAI.

Saber quando um aviso urgente vai ao ar

Todo aviso urgente — pela API, pela tela ou pela Tali — publica o evento Um aviso urgente vai ao ar nas TVs (TV_AVISO_URGENTE_PUBLICADO), com grupoId, grupoNome, titulo, conteudoId e duracaoMin. Um webhook assinando esse evento leva o registro ao seu sistema; para repetir o aviso num canal de mensagens, use um fluxo automatizado com o bloco Chamar outro sistema e um Corpo (JSON) próprio:

{
  "text": "Aviso nas TVs de {{gatilho.grupoNome}}: {{gatilho.titulo}}"
}

Veja Da TAI para o seu sistema.

Pelo seu agente de IA

“Crie um slide de conquista com 128% da meta de vendas batida e ponha na playlist da recepção até sexta.”

Com escopo de escrita, o agente escolhe o modelo, cria o slide e o põe na playlist, com sua aprovação no cliente de IA. Aviso urgente usa o verbo publicar, de confirmação forte: não roda por agente externo — faça-o pela API, pela tela ou pela Tali. Somente leitura: “a TV da recepção está funcionando?”. Veja Escrita e segurança.

Cuidados

• Aviso urgente toma a tela inteira de todas as TVs do grupo. Use duracaoMin para que ele saia sozinho se o seu sistema não chamar o encerramento.
• Slide de modelo guarda o texto da criação. Para mostrar um número novo, crie outro slide e troque o item da playlist; a vigência do item tira o antigo do ar.
• Imagens e vídeos entram por upload (POST /tv/conteudo/upload?titulo=, multipart/form-data com o campo arquivo): JPG, PNG, WebP ou GIF até 15 MB, MP4 ou WebM até 150 MB. O conteúdo nasce pronto para entrar na playlist com POST /tv/item. A mídia de um slide só aceita arquivos enviados à própria plataforma, não URLs externas.
• Datas da vigência com hora, no horário de Brasília (yyyy-MM-dd HH:mm:ss). Veja Datas e formatos.