Histórico de Conversas

O Histórico exibe todas as sessões de conversa do assistente. Cada sessão agrupa as mensagens de um usuário em uma interação contínua. Use-o para monitorar qualidade de respostas, depurar comportamentos inesperados e extrair insights sobre os atendimentos.

Lista de sessões

Acesse Assistente → Histórico para ver a lista de sessões com:

Identificador: ID da sessão ou número de telefone formatado (quando disponível)
Data e hora: Primeira mensagem da sessão
Total de mensagens: Quantidade de interações na sessão

Busca

Pesquise pelo ID da sessão ou pelo número de telefone do usuário. A busca é aplicada automaticamente após 500ms sem digitação.

Modo ao vivo

Ative o Modo ao vivo para que a lista se atualize automaticamente a cada 5 segundos — ideal para monitorar atendimentos em andamento sem precisar recarregar a página. A preferência é salva entre sessões.

Detalhes da conversa

Clique em uma sessão para ver o histórico completo. Cada interação do assistente pode conter múltiplos tipos de resposta:

Tipo	Descrição
`text`	Texto da resposta gerada pelo LLM
`think`	Raciocínio interno do modelo, exibido de forma colapsável
`trigger`	Gatilho executado durante a resposta, com os parâmetros utilizados em JSON
`reference`	Trecho da base de conhecimento consultado, com score de relevância
`image`	Imagem enviada pelo usuário ou gerada como resposta

Além das mensagens, cada interação exibe:

Tempo de resposta em milissegundos
Dados do cliente (clientData) passados via API

Ações por sessão

Resetar sessão

Limpa o histórico e o contexto da conversa para aquele usuário. Na próxima mensagem, o assistente começa do zero, sem memória das interações anteriores.

Esta ação é irreversível. Use apenas quando necessário, como ao encerrar um atendimento ou corrigir um estado inconsistente.

Usar no teste

Carrega a sessão como contexto inicial no painel Testar assistente. Útil para reproduzir exatamente o estado de uma conversa real e depurar o comportamento do assistente em condições específicas.

Insight de IA

Disponível apenas para administradores.

Analisa um conjunto de sessões usando IA e retorna um relatório com:

Campo	Descrição
`insight`	Padrão ou problema identificado nas conversas analisadas
`bad_examples`	IDs das sessões que exemplificam o problema
`suggestion`	Melhoria sugerida para o prompt atual
`updated_prompt`	Versão otimizada do prompt, pronta para uso

Configuração:

Parâmetro	Descrição
Prompt de análise	O que você quer investigar (mínimo 10 caracteres)
Número de registros	Quantas sessões recentes analisar (10–300)

Exemplo de prompt de análise: "O assistente está respondendo perguntas fora do escopo? Identifique os casos e sugira como restringir melhor o comportamento."