Compartilhar Conversa

O menu de uma conversa com agente no Hub oferece duas formas de retirar o conteúdo da tela: Compartilhar, que prepara uma página somente leitura, e Exportar, que gera um arquivo local. O compartilhamento público tem uma limitação crítica no produto atual e não deve ser tratado como uma publicação concluída.

Link público indisponível para visitantes

O modal afirma que qualquer pessoa com o link poderá visualizar a conversa, mas hoje um visitante sem login não consegue carregá-la. A rota consulta tabelas protegidas e o token criado ao ativar o compartilhamento não participa da URL nem da leitura. O destinatário externo normalmente verá Conversa não disponível.

Onde encontrar a ação

1. Abra o Hub em /hub.
2. Se a navegação colaborativa estiver habilitada para sua organização, selecione Agentes no rail esquerdo.
3. Localize a conversa. A lista pode agrupá-la em Fixadas, Hoje, Esta semana ou Anteriores.
4. Abra o menu de ações no item e escolha Compartilhar.

A ação pertence à lista de conversas com agentes no Hub. Salas, mensagens diretas e conversas externas administradas em /admin/conversations usam superfícies diferentes.

O que o modal faz

O modal Compartilhar conversa contém o switch Compartilhamento público. Ao ativá-lo, o cliente:

1. define is_shared como ativo;
2. gera um novo share_token interno;
3. mostra um link com o formato <origem-atual>/share-chat/<id-da-conversa>;
4. oferece dois botões apenas por ícone: copiar o link e abri-lo em outra aba.

O link usa o ID da conversa, e não o share_token. A origem é a mesma em que o SquadOS está aberto; não presuma um domínio fixo.

Acessibilidade dos botões

Os botões de copiar e abrir não têm nome textual ou rótulo acessível no produto atual. Visualmente, o botão de copiar vem primeiro e o de abrir em outra aba vem depois.

Estado atual do acesso

A página /share-chat/<id-da-conversa> fica fora da proteção de rota de login, mas consulta conversations e messages diretamente. As políticas atuais dessas tabelas concedem leitura por autenticação, organização ou participação — não pelo token de compartilhamento e não ao papel anônimo.

Na prática:

• um visitante externo sem sessão não consegue ler a conversa;
• um membro autenticado que já tenha acesso à conversa pode conseguir abrir a página;
• is_shared ainda é verificado pela página depois que a conversa é lida;
• o share_token é gravado, mas não autoriza nem identifica a leitura;
• não existe validade, senha ou acesso limitado a uma quantidade de aberturas.

Não envie o link como evidência pública e não considere a conversa entregue até testar o acesso no mesmo contexto do destinatário.

O que a página somente leitura renderiza

Quando a leitura é autorizada e is_shared está ativo, a página mostra:

• o título da conversa e, quando disponível, nome e avatar do agente;
• mensagens de usuário e assistente em ordem cronológica;
• Markdown nas respostas do assistente;
• ícone do provedor quando a mensagem registra um modelo;
• data e hora, além de ações por ícone para copiar ou baixar cada mensagem.

A página não tem compositor. Ela também não consulta anexos, passos do agente, detalhes técnicos, créditos ou anotações. Para entender as diferenças entre Hub, página pública, widget e atendimento, consulte Interface de Chat.

Desativar o compartilhamento

Abra novamente Compartilhar conversa e desligue Compartilhamento público. O cliente define is_shared como inativo e limpa o token.

A URL não muda porque contém o ID da conversa. Se o compartilhamento for reativado, um novo token interno será criado, mas a mesma URL será exibida. Como o token não é usado para leitura hoje, essa rotação não cria um link independente.

Se a operação falhar, o switch volta ao estado anterior e uma notificação apresenta o erro. Não presuma que o acesso foi revogado: reabra o modal e confirme que o switch está desligado.

Alternativa para enviar o conteúdo

No mesmo menu da conversa, Exportar oferece Texto (.txt) e PDF:

• Texto (.txt) baixa todas as mensagens textuais em ordem, com horário, papel e modelo quando disponível;
• PDF abre uma nova janela e chama o diálogo de impressão do navegador; ele não baixa um PDF diretamente.

Prefira o TXT depois de revisar o conteúdo e compartilhe o arquivo pelo canal aprovado pela sua organização. O exportador ainda fixa datas e papéis em PT-BR mesmo na interface EN.

Título não confiável e exportação em PDF

Não use a opção PDF se o título da conversa veio de uma fonte não confiável. O título é inserido sem escape no documento de impressão atual. Renomeie e revise a conversa antes de exportar, ou use TXT.

Checklist antes de enviar

• Revise todas as mensagens: o compartilhamento não permite escolher somente um trecho.
• Não gere nem envie o arquivo se alguma mensagem contiver credenciais, dados pessoais ou informações confidenciais.
• Use o TXT como alternativa enquanto o acesso anônimo do link não for corrigido.
• Confirme o arquivo final e o canal de envio; gerar ou copiar algo não prova que o destinatário consegue acessá-lo.