JEV Chatwoot: a IA que dá nota e classifica cada conversa

O JEV no Chatwoot é um modelo de IA de classificação que lê a conversa e devolve uma resposta curta e estruturada, como a nota do atendimento, a temperatura do lead ou se o cliente precisa de um humano.

Numa conversa com 200 ou 300 mensagens, ninguém da equipe tem tempo de ler tudo para saber se o cliente está perto de comprar, se está insatisfeito ou se precisa de alguém humano agora. O JEV no Chatwoot faz essa leitura por você.

No vídeo eu mostro duas formas de usar. A primeira é um script que coloca um box de análise na lateral da conversa. A segunda é o nó do JEV dentro dos Flows do AstraChat, onde o agente de IA chama o JEV para classificar o atendimento e decidir o próximo passo. Abaixo eu explico o que é a ferramenta, como configurar e onde ela faz mais sentido.

O que é o JEV

O JEV é um modelo de IA voltado para classificação. Ele não foi feito para bater papo. Você manda um conjunto de dados, normalmente um JSON com o texto e os critérios, e ele devolve a análise no formato que você pediu:

• uma nota;
• uma categoria escolhida numa lista (frio, morno ou quente);
• um verdadeiro ou falso (precisa de humano: sim ou não);
• um resumo curto.

No vídeo eu uso o modelo pelo OpenRouter, onde ele aparece como typesafe/jev-router. Também dá para contratar direto com a Typesafe. Pelo que testei, a resposta direta traz dados um pouco diferentes e um pouco melhores, mas pelo OpenRouter resolve bem e os créditos servem para outros modelos também.

Por que usar o JEV em vez de um modelo de chat

Um modelo de chat tradicional, como o ChatGPT, cobra por token e tende a responder mais do que você precisa. Para tirar uma nota de uma conversa, você gasta tokens com texto que vai jogar fora, e ainda depende de um prompt bem ajustado para ele não inventar.

O JEV já vem pronto para esse tipo de tarefa. Na explicação do vídeo, a cobrança é pela resposta da análise, e não por todo o processamento por trás. A resposta é direta e no formato pedido, o que facilita usar o resultado numa automação. Antes de colocar em produção, confira o preço atual na página do modelo, porque isso muda.

Quando o vídeo foi gravado, em setembro de 2026, o modelo não tinha uso gratuito. Você precisa colocar créditos no OpenRouter (ou na Typesafe) antes de testar.

O box de análise na conversa

O script que deixei na página de apoio cria um box novo na lateral da conversa, chamado "Análise JEV". Você clica, ele lê as últimas mensagens e mostra:

No teste, usei uma conversa de robô sem nada relevante. O resultado foi coerente com isso: nota 2 de 10, lead frio, chance baixa, categoria comercial e "precisa de humano: sim". A análise levou alguns segundos.

O ganho para o atendente é ter um panorama antes mesmo de rolar a conversa inteira ou de ligar para o cliente.

Ajustando o script para o seu negócio

O script é documentado e tem poucos pontos para mexer:

1. Chave: cole a sua chave do OpenRouter no lugar indicado. Não precisa mexer em mais nada para funcionar.
2. Modelo: já vem com o modelo do JEV.
3. Nome do box: troque se quiser outro título na lateral.
4. Quantidade de mensagens: o padrão é ler as últimas 30. Dá para aumentar, por exemplo para 300.
5. Tentativas: ele tenta até três vezes. Se falhar, mostra um erro, que costuma ser falta de crédito ou modelo indisponível.
6. Critérios: ficam numa lista dentro do código. Para acrescentar um critério, como "precisa de suporte técnico", basta incluir o item com o formato de resposta que você quer. Se não quiser mexer no código, cole o script no ChatGPT e peça para ele trocar os critérios.

Instalando no AstraChat

No AstraChat existe um módulo de scripts no super admin. O caminho é este:

1. Entre no super admin e abra Scripts.
2. Clique para adicionar um novo script e dê um nome, por exemplo "JEV análise".
3. Cole o código com a sua chave já trocada.
4. Marque como ativo. A posição pode ficar no padrão.
5. Salve, limpe o cache do navegador e abra uma conversa.

O box aparece na lateral da conversa. O script entra pela página, sem alterar o código do Chatwoot.

No Chatwoot oficial essa tela de scripts não aparece. No vídeo eu mostro um caminho alternativo, mas ele depende de recursos Enterprise e eu não vou tratar disso aqui.

O JEV dentro dos Flows

Para quem usa o AstraChat, o JEV também virou um nó nos Flows. Ele funciona de dois jeitos:

• Num workflow: classifica a conversa quando acontece um gatilho e segue o caminho conforme a resposta.
• Como ferramenta do agente de IA: o agente decide quando precisa classificar, chama o JEV e recebe o resultado de volta.

No nó você escolhe a integração (direto com a Typesafe ou pelo OpenRouter), escreve um prompt curto do que analisar e define o tipo de resposta: categoria, sim ou não, ou nota. Se deixar a entrada vazia, ele usa o histórico da conversa. O resultado pode ser salvo numa variável, com um prefixo, para os próximos nós usarem.

No exemplo do vídeo, o agente recebe a mensagem "quero falar com o suporte", chama o JEV para classificar entre Financeiro, Suporte e Comercial e, com a resposta, aplica a etiqueta certa. A partir daí dá para atribuir a um time, mover no Kanban ou seguir outro fluxo. Se quiser ver como etiquetas e etapas ajudam na organização, leia sobre Kanban e funis de venda no Chatwoot.

Onde o JEV ajuda mais

• Triagem: separar financeiro, suporte e comercial sem menu de números.
• Prioridade de vendas: destacar os leads quentes para o vendedor ligar primeiro.
• Alerta de intervenção: avisar quando a conversa precisa de alguém humano.
• Qualidade do atendimento: acompanhar nota e satisfação sem ler cada conversa.

Se você quer um agente que converse com o cliente, o JEV não é a peça certa. Para isso, veja o artigo sobre chatbot com IA no WhatsApp. O JEV entra como apoio, classificando o que o agente ou a equipe precisa saber.

O lado honesto

• A chave fica no navegador. O script roda na página do Chatwoot, então a chave vai junto. Eu cancelei a minha depois de gravar. Use uma chave só para isso e acompanhe o consumo.
• Precisa de crédito. Sem saldo, o box mostra erro.
• A nota depende do critério. Critério mal descrito gera nota que ninguém confia. Teste com conversas reais da sua operação e ajuste.
• Ler mais mensagens custa mais. Comece com 30 e só aumente se a análise estiver perdendo contexto.

Checklist para começar

• Créditos no OpenRouter ou na Typesafe
• Chave criada só para o JEV
• Critérios ajustados para o seu tipo de atendimento
• Teste em cinco ou seis conversas reais antes de mostrar para a equipe
• Combinado com a equipe o que fazer quando aparecer "precisa de humano: sim"

Perguntas frequentes

O que é o JEV?

O JEV é um modelo de IA voltado para classificação, e não para bater papo. Você manda um conjunto de dados, normalmente um JSON com o texto e os critérios, e ele devolve uma nota, uma categoria, um sim ou não ou um resumo curto, no formato que você pediu.

Como usar o JEV no Chatwoot?

Um script cria o box "Análise JEV" na lateral da conversa, que mostra nota do atendimento, satisfação do cliente, temperatura do lead, chance de fechar a venda, categoria, se precisa de humano e um resumo. No AstraChat, o JEV também aparece como um nó dentro dos Flows.

O JEV é gratuito?

Não. Quando o vídeo foi gravado, em setembro de 2026, o modelo não tinha uso gratuito, e era preciso colocar créditos no OpenRouter ou na Typesafe antes de testar.

Qual a diferença entre o JEV e o ChatGPT para analisar conversas?

Um modelo de chat como o ChatGPT cobra por token e tende a responder mais do que você precisa. O JEV devolve uma resposta direta no formato pedido, o que facilita usar o resultado numa automação.

Quantas mensagens o JEV lê de cada conversa?

O script lê as últimas 30 mensagens por padrão, e dá para aumentar, por exemplo para 300. Ler mais mensagens custa mais, então o ideal é começar com 30 e só aumentar se a análise estiver perdendo contexto.

Quer o JEV ligado às suas automações?

O nó do JEV já vem nos Flows do AstraChat, junto com agentes de IA, Kanban, disparador, ligações pelo WhatsApp e chat interno, no seu servidor e com a sua marca.

Ele vem na Comunidade Astra Online, com código-fonte, atualizações, grupo VIP e a primeira instalação feita pelo especialista em Chatwoot Raphael Popiolek. Se quiser ajuda para definir os critérios de análise da sua operação, mande uma mensagem no WhatsApp com dois ou três exemplos de conversa que você gostaria de classificar.