QT
QualiTalk

QualiTalk

Como importar chats TXT no Monitor IA

Passo a passo para enviar conversas de chat em formato TXT para avaliacao automatizada, configurar extracao de metadados do nome do arquivo e importar CSV de metadados.

O Monitor IA agora aceita arquivos de chat em formato TXT alem de gravacoes de audio. Conversas de texto seguem o mesmo fluxo de avaliacao automatizada, mas sem a etapa de transcricao — o conteudo do arquivo e usado diretamente pela IA.

O que muda em relacao ao audio

AspectoAudio (MP3, WAV, etc.)Chat (TXT)
Transcricao automaticaSimNao (conteudo ja e texto)
Avaliacao IASimSim
Metadados do nomeOpcionalOpcional
CSV de metadadosOpcionalOpcional
Tempo de processamentoMaior (transcrever + avaliar)Menor (somente avaliar)

Antes de comecar

Confirme estes pre-requisitos:

  • Monitor IA (persona) ja criado com cliente e campanha;
  • formulario publicado e marcado como pronto para IA (sem cabecalhos + prompt geral preenchido);
  • usuario logado com permissao de administrador.

Passo 1: preparar os arquivos TXT

Cada arquivo deve conter a conversa completa de um atendimento. O formato recomendado e o de dialogo simples:

Agente: Bom dia, meu nome e Joao, em que posso ajudar?
Cliente: Oi, quero saber sobre o plano de internet.
Agente: Claro! Temos o plano de 500MB por R$99/mes...
Cliente: Parece bom, como faco para contratar?
Agente: Posso fazer a adesao agora mesmo. Preciso de seu CPF...

Formato flexivel

A IA consegue interpretar diversos formatos de conversa. O importante e que fique claro quem e o agente e quem e o cliente em cada fala.

Passo 2: nomear os arquivos (opcional mas recomendado)

Se os nomes seguirem um padrao consistente, o sistema pode extrair metadados automaticamente. Exemplo de convencao:

joao_vendas_13-04-2026.txt
maria_sac_14-04-2026.txt

Neste caso, o padrao seria {agente}_{campanha}_{data}.txt, e os campos agente, campanha e data seriam extraidos de cada arquivo.

Passo 3: acessar a pagina de upload

Entre em Dashboard > Monitor IA > Upload. A pagina agora aceita tanto arquivos de audio quanto arquivos de texto.

  1. Selecione o Monitor IA (persona).
  2. Selecione o Formulario de avaliacao.
  3. Opcionalmente, de um nome ao lote.

Passo 4: configurar extracao de metadados do nome

Se seus arquivos seguem um padrao de nomenclatura:

  1. Ative o toggle "Extrair metadados do nome do arquivo".
  2. Preencha o padrao usando {campo} para cada dado. Exemplo:
    • {agente}_{campanha}_{data}.txt
    • {agente}_{campanha}_{data}-{hora}.txt
    • {matricula}_{operacao}.txt
  3. O sistema mostra uma pre-visualizacao ao lado, aplicando o padrao ao primeiro arquivo selecionado para que voce confirme se a extracao esta correta.

Padrao e separadores

Os separadores entre campos (underscore, hifen, ponto) precisam corresponder exatamente ao nome do arquivo. Se o nome usa hifen e o padrao usa underscore, a extracao nao vai funcionar.

Passo 5: adicionar os arquivos

Arraste os arquivos TXT para a zona de upload ou clique para selecionar. Arquivos de texto aparecem com um icone diferente dos de audio para facilitar a identificacao.

Formatos aceitos: .txt, .chat, .log

Passo 6: importar CSV de metadados (opcional)

Se voce tem informacoes complementares sobre cada conversa (nome do agente, equipe, campanha, tabulacao, etc.), pode importa-las via CSV:

  1. Na secao "Metadados (CSV)", arraste o arquivo CSV.
  2. O CSV deve usar ponto e virgula (;) como separador.
  3. A primeira coluna deve conter o nome do arquivo (para associar ao arquivo correto).

Exemplo de CSV

file_name;Data_contato;Agente;Equipe;Cliente;Campanha;Matricula;Tabulacao_contato
joao_vendas_13-04-2026.txt;13/04/2026;JOAO SILVA;EQUIPE A;N/A;VENDAS;12345;VENDA
maria_sac_14-04-2026.txt;14/04/2026;MARIA SOUZA;EQUIPE B;N/A;SAC;67890;INFORMACAO

Apos o upload do CSV, o sistema mostra:

  • preview das primeiras linhas;
  • quantos arquivos foram encontrados no CSV (ex: "2 de 3 arquivos associados").

Alternativa: metadados por arquivo

Em vez do CSV, voce pode incluir um pequeno arquivo .meta.json ao lado de cada conversa (ex: joao_vendas.txt + joao_vendas.meta.json). O sistema detecta e associa automaticamente.

Passo 7: iniciar o upload

Clique em "Iniciar Upload". O painel flutuante mostra o progresso. Como arquivos de texto nao precisam de transcricao, o processamento e significativamente mais rapido que para audios.

Passo 8: verificar resultados

Apos o processamento:

  1. Acesse Monitor IA > Avaliacoes.
  2. As avaliacoes dos chats aparecem normalmente, como qualquer outra.
  3. Clique em uma avaliacao para ver o formulario preenchido pela IA.
  4. Na aba de detalhes, o texto completo da conversa esta disponivel (no campo que normalmente mostra a transcricao).
  5. Os metadados extraidos (do nome e/ou CSV) ficam visiveis nos detalhes do arquivo.

Resumo do fluxo

  1. Preparar arquivos TXT com as conversas.
  2. Opcionalmente, padronizar os nomes e/ou preparar CSV de metadados.
  3. Fazer upload em Monitor IA > Upload.
  4. Configurar extracao de nome e/ou importar CSV.
  5. Iniciar o upload e acompanhar pelo painel flutuante.
  6. Revisar as avaliacoes geradas pela IA.

Erros mais comuns

A IA nao identificou agente e cliente

Revise o formato do TXT. Cada fala deve indicar claramente o papel (ex: "Agente:", "Cliente:", "Operador:", "Atendente:").

O padrao do nome nao extrai os campos

Verifique se os separadores no padrao (_, -, .) correspondem exatamente aos usados no nome do arquivo.

O CSV nao associou os arquivos

Confirme que a coluna file_name do CSV contem o nome exato do arquivo, incluindo a extensao (.txt).

Proximo passo

Depois de importar as conversas, acompanhe os resultados em Como aplicar feedback para transformar as avaliacoes em plano de acao.