Interface de Chat

O SquadOS apresenta mensagens em quatro contextos. Eles compartilham a leitura em bolhas, mas têm identidades, controles e permissões diferentes.

Contexto	Entrada	Quem usa	Escrita
Hub	`/hub`	Membro autenticado com acesso ao Hub	Conversa interna com agente de IA.
Página pública	`/a/<slug-da-caixa>`	Visitante sem login	Conversa pela caixa pública.
Widget	`/embed/<slug-da-caixa>` dentro de um site	Visitante sem login	Conversa pela caixa do widget.
Atendimento	`/admin/conversations`	Membro com acesso a Conversas	Resposta humana ou nota interna sobre um canal externo.

Existe ainda a página somente leitura /share-chat/<id-da-conversa>, gerada pelo menu de uma conversa do Hub. Consulte a limitação conhecida em Conversa compartilhada.

Conversas com agentes no Hub

Abra o Hub por /hub; não use /hub/chat como ponto de entrada. A organização pode estar no Hub colaborativo ou na experiência de compatibilidade, mas as conversas individuais com agentes usam o mesmo histórico e compositor.

No Hub colaborativo, o trilho separa Salas, Agentes, Diretas, Reuniões e o painel administrativo conforme suas permissões. Na área Agentes:

Nova conversa abre um rascunho; a conversa só é criada ao enviar a primeira mensagem;
a coluna mostra conversas agrupadas em Fixadas, Hoje, Esta semana e Antes;
cada item traz título, agente, trecho da última mensagem e horário relativo;
o menu do item oferece Renomear, Compartilhar, Exportar, Fixar no topo ou Desafixar e Excluir;
a busca geral do Hub abre pelo campo da coluna ou por Ctrl+K e alcança salas, agentes e sessões.

Não há pastas de conversas. Para manter um atendimento visível no topo, use Fixar no topo.

Como ler uma mensagem

As suas mensagens ficam de um lado e as mensagens recebidas do outro. No atendimento, a perspectiva é invertida: cliente fica do lado recebido, enquanto agente ou atendente representa a organização.

Cada bolha pode mostrar autor, horário, anexos e conteúdo em Markdown. No Hub e no atendimento, o menu Detalhes da mensagem permite copiar o texto e consultar os dados que existirem, como agente, modelo solicitado, provedor, tokens, ferramentas e horário. Custo e créditos só aparecem para quem pode ver dados financeiros.

Quando o agente trabalha com ferramentas, o caminho aparece no Hub e no atendimento:

durante a execução, Pensando… ou Trabalhando… mostra o progresso e o tempo decorrido;
depois da resposta, o resumo informa a quantidade de passos e, quando disponível, a duração;
o caminho nasce aberto e pode ser recolhido com Ocultar o caminho;
Ver detalhes expõe entrada e resultado técnicos de cada passo.

Página pública e widget ocultam os passos e detalhes técnicos de cada mensagem — incluindo modelo e créditos — do visitante.

Transferências entre agentes aparecem como um indicador próprio. Imagens geradas são exibidas na conversa e podem ser ampliadas ou baixadas.

Escreva, escolha o agente e envie

No Hub, o compositor usa o campo Digite sua mensagem…. Você pode:

enviar com Enter e usar Shift+Enter para quebrar a linha;
escolher um agente; em uma conversa nova, Sem agente também pode estar disponível;
trocar o modelo somente quando sua função ou equipe permite essa escolha;
alternar para geração de imagem quando sua conta pode gerar imagens;
anexar pelo clipe, colar com Ctrl+V ou arrastar arquivos para a caixa;
gravar áudio quando o agente aceita áudio.

A seleção de agente não significa que todos os modelos ficam disponíveis. Ao escolher um agente, o compositor volta ao modelo configurado para ele; o seletor de modelo só aparece para usuários autorizados.

Limites de anexos

Cada mensagem aceita até cinco anexos. São aceitos JPEG, PNG, GIF, WebP, PDF, TXT, Markdown, CSV, Word e Excel; vídeo não é aceito.

O arquivo final precisa ter no máximo 4 MB.
Imagens recomprimíveis podem entrar com até 10 MB.
PDFs podem entrar com até 25 MB e são comprimidos antes do envio.
GIFs e demais documentos não recebem essa folga e precisam ter até 4 MB.

O produto informa quando está comprimindo, enviando ou recusando um arquivo. Veja também Áudio e Transcrição.

A página pública e o widget são resolvidos pela caixa de entrada, não diretamente pelo agente:

caixa com agente mostra a identidade do agente e envia o turno para a IA;
caixa de atendimento humano mostra a identidade da organização e avisa que uma pessoa responderá;
uma regra de horário também pode encaminhar o turno para atendimento humano e exibir esse aviso.

A página pública tem um controle para iniciar outra conversa depois que a conversa atual já existe e a resposta terminou. O widget usa o nome e o logo configurados na caixa, pode mostrar uma mensagem de boas-vindas, respeita a cor e a posição configuradas e tem um botão para fechar.

Visitantes não veem gravador de áudio. O clipe de anexos aparece somente quando Permitir anexos está habilitado na caixa; essa permissão não habilita vídeo.

Atendimento no painel

Em /admin/conversations, a conversa selecionada usa o mesmo formato de mensagens, mas acrescenta os controles operacionais. A aba Responder envia ao cliente pelo canal original; Nota interna fica apenas para a equipe.

Responder depende da permissão, do estado da conversa, da IA estar desabilitada e, no WhatsApp, da janela de 24 horas ou de um modelo aprovado. O cabeçalho concentra assumir, transferir, adiar, concluir, reabrir e arquivar conforme o estado e a autorização. Veja Gerenciando Conversas e Intervenção Humana.

Conversa compartilhada

O menu de uma conversa do Hub contém Compartilhar e gera uma página somente leitura com título, agente e mensagens. A página não tem compositor nem expõe o caminho do agente.

Limitação conhecida: o produto gera o link, mas a leitura anônima está bloqueada pelas regras atuais de acesso e o token criado não participa da URL nem da consulta. Um destinatário externo pode ver Esta conversa não está disponível. Não use esse link como evidência externa até o produto corrigir o acesso; prefira uma exportação revisada e autorizada.

Quando algo dá errado

A conversa antiga não aparece? Limpe a busca; ela procura por título ou nome do agente. Conversas de agentes arquivados não aparecem na lista.
O modelo não aparece? O seletor é condicionado à permissão da sua função ou equipe. O agente ainda usa o modelo configurado para ele.
O anexo foi recusado? Confira tipo, quantidade e tamanho final. Reduza o arquivo ou envie somente as páginas necessárias do PDF.
A resposta parou? Aguarde a mensagem de conexão ou timeout. Se o produto indicar interrupção, envie a mensagem novamente; não presuma que uma ferramenta terminou sem conferir o caminho persistido.
Precisa continuar sem a IA? No atendimento, assuma a conversa ou desabilite a IA conforme sua permissão.