{"v":{"area":"admin","slug":"chat-interno","path":"/home/tiixcom/public_html/sistema/docs/readme/admin/chat-interno.md","relative_path":"docs/readme/admin/chat-interno.md","title":"Chat Interno","html":"<h1>Chat Interno</h1><h2>Rota</h2><ul><li><code>/adm/chat</code></li></ul><h2>O que e</h2><p>Pagina de conversas internas do admin para colaboradores, devs e times operacionais. A tela centraliza conversas diretas e grupos, anexos, ativos relacionados, contexto operacional e sinais de presenca.</p><h2>Para que serve</h2><ul><li>iniciar conversas diretas com colaboradores do contrato;</li><li>criar e gerenciar grupos de conversa;</li><li>anexar ativos operacionais, como tarefas, tickets, documentos, mailbox, base de conhecimento, runbooks e decisoes;</li><li>manter contexto rastreavel entre conversa e objetos do sistema;</li><li>facilitar contato com membros das equipes do usuario logado;</li><li>mostrar sinais de disponibilidade, como online e &quot;digitando...&quot;.</li></ul><h2>Blocos principais</h2><ul><li>lista lateral de conversas, com busca, filtro por tipo e filtro de arquivadas;</li><li>tela inicial com atalhos para nova conversa, novo grupo e membros das minhas equipes;</li><li>area central de mensagens, anexos, respostas, reacoes e composer;</li><li>painel lateral da conversa com contextos vinculados, midias, arquivos, participantes e equipes relacionadas;</li><li>modais de nova conversa, novo grupo, gestao de grupo e anexo de ativos.</li></ul><h2>Tela inicial</h2><ul><li>quando nenhuma conversa esta aberta, a pagina mostra o bloco &quot;Minhas equipes&quot;;</li><li>o bloco busca as equipes em que o usuario logado participa;</li><li>cada equipe lista membros com cargo interno, tipo de colaborador, papel na equipe e nivel;</li><li>a bolinha no avatar indica presenca online conforme <code>chat_presence</code>;</li><li>clicar em um membro abre ou cria a conversa direta com ele;</li><li>os botoes &quot;Nova conversa&quot; e &quot;Novo grupo&quot; continuam disponiveis para fluxos manuais.</li></ul><h2>Conversas e participantes</h2><ul><li>conversas diretas sao abertas por <code>thread_open_direct</code>;</li><li>grupos sao criados por <code>thread_create_group</code>;</li><li>em grupos, administradores ou donos podem editar dados, adicionar membros e remover participantes;</li><li>no painel lateral da conversa, membros das minhas equipes que ainda nao estao no grupo podem ser adicionados diretamente pelo botao de usuario;</li><li>conversas diretas nao exibem gestao de participantes.</li></ul><h2>Contextos e ativos</h2><ul><li>a secao &quot;Contextos&quot; mostra objetos vinculados a conversa;</li><li>o modal &quot;Anexar ativo&quot; permite procurar e vincular ativos sem sair do chat;</li><li>a busca de ativos operacionais usa os participantes da conversa para reduzir ruido;</li><li>o chat aceita entrada por URL com <code>context_type</code>, <code>context_id</code>, <code>context_title</code>, <code>context_ref</code> e <code>context_url</code>;</li><li>quando a conversa e aberta com contexto pendente, o vinculo e criado automaticamente.</li></ul><h2>Presenca e digitacao</h2><ul><li>a presenca online usa a tabela <code>chat_presence</code>;</li><li>o heartbeat global do admin mantem o usuario atual visivel como online;</li><li>em conversas diretas, o status online aparece no avatar e no subtitulo;</li><li>o composer envia <code>typing_ping</code> enquanto o usuario digita;</li><li>o indicador &quot;digitando...&quot; consulta <code>typing_status</code> periodicamente e aparece acima do campo de mensagem;</li><li>ao enviar mensagem, o status de digitacao e limpo.</li></ul><h2>Observacoes</h2><ul><li>o bloco &quot;Minhas equipes&quot; da tela inicial nao depende de uma conversa aberta;</li><li>o bloco de equipes do painel lateral usa a conversa aberta para destacar quem ja participa;</li><li>a lista de ativos de base de conhecimento continua institucional por contrato, enquanto tarefas, tickets, documentos, mailbox, runbooks e decisoes respeitam escopo dos participantes quando a conversa esta aberta;</li><li>a migration de contextos fica em <code>sql/2026-04-21-create-chat-context-links.sql</code>;</li><li>a migration de presenca fica em <code>sql/2026-04-21-create-chat-presence.sql</code>.</li></ul>"},"exp":1780849783}