Qualificador de contatos

O que faz

Este pacote tem dois workflows:

• **[TN] Captação · Qualificador de contatos** (qualificador-contatos.json): a versão de verdade, que conversa pelo WhatsApp.
• **[TN] Captação · Qualificador · Demonstração** (qualificador-demonstracao.json): a mesma conversa num chat do próprio n8n, sem WhatsApp e sem nenhuma credencial. Serve para ver funcionando e para ajustar as perguntas antes de ligar de verdade.

Como a versão WhatsApp funciona:

1. Uma pessoa deixa nome e WhatsApp no formulário do n8n (o n8n já dá uma URL pronta) ou no formulário do seu site.
2. O fluxo confere os dados antes de gastar qualquer mensagem (segredo do site, robô, telefone válido, conversa já aberta).
3. A pessoa recebe boas-vindas e a pergunta 1 no WhatsApp.
4. Ela responde com o número da opção ou do jeito dela ("não tenho pressa"). O fluxo entende, soma pontos e manda a pergunta seguinte (até 3).
5. No fim, o contato é classificado:
   • Quente: o responsável recebe na hora um alerta no WhatsApp, com o resumo das respostas e um link para abrir a conversa. O contato recebe "vamos falar com você em até X".
   • Morno: fica anotado na ficha. O contato recebe um agradecimento.
   • Frio: o contato recebe um agradecimento e um link de conteúdo, sem insistência.
6. Se a resposta não for entendida, a pergunta é repetida. Na 3ª vez seguida sem entender, a conversa passa para uma pessoa (classe atendimento, com alerta ao responsável).
7. A cada 15 minutos o fluxo olha quem parou de responder: depois de um tempo manda 1 lembrete (só em horário de envio do Enviador). Se continuar sem resposta, a ficha fecha como sem_resposta.
8. Quem pede PARE sai da conversa e a ficha fecha como pediu_pare.

Toda conversa termina com exatamente 1 ficha na tabela tn_respostas (tipo qualificacao). O valor é a classe (quente, morno, frio, atendimento, sem_resposta ou pediu_pare) e o texto traz nome, pontos e resumo das respostas. Cada telefone tem uma conversa por vez: quem já está respondendo não recomeça.

O que você precisa

• n8n 2.x com Data Tables (testado no n8n 2.36.7).
• Núcleo TN instalado (obrigatório): [TN] Núcleo · Instalação já rodado uma vez, [TN] Núcleo · Enviar WhatsApp configurado e [TN] Núcleo · Roteador de entrada publicado e recebendo as mensagens do WhatsApp. Veja o manual do Núcleo.
• WhatsApp por Evolution API ou WhatsApp Cloud API (Meta), já ligado no Núcleo. (Só para a versão WhatsApp. A demonstração dispensa.)
• Nenhuma outra credencial: este template não usa Google nem e-mail.

Cuidados (LGPD)

• O que fica gravado: nome, WhatsApp e as respostas dadas. Ficam em tn_pendencias (enquanto a conversa está aberta) e em tn_respostas (a ficha final).
• Não faça perguntas sensíveis. Nada de saúde, diagnóstico, renda detalhada, religião, orientação sexual e similares. Uma clínica pergunta "para quando você precisa?", não "qual é a sua doença?". Pergunte só o necessário para saber se vale um contato agora.
• PARE é respeitado. Quem pedir PARE sai da conversa, não recebe mais nada e a ficha fecha como pediu_pare.
• Base legal e consentimento: deixe claro, perto do formulário, que a pessoa será contatada pelo WhatsApp e para quê. Para o formulário do n8n, use a descrição do formulário. No seu site, ponha o aviso ao lado do botão.
• Para apagar os dados de alguém: no n8n, abra Data tables e apague as linhas daquele telefone em tn_respostas e, se houver, em tn_pendencias. Quem quiser sair da lista de mensagens automáticas fica em tn_optout: não apague essa linha, ela é o que impede novos envios.
• Os alertas ao responsável trazem o nome e as respostas do contato. Trate como informação interna.

Limites conhecidos

• Uma conversa por telefone por vez. Se a pessoa preencher o formulário de novo enquanto está respondendo, o segundo contato é ignorado.
• Até 3 perguntas. Mais que isso não é suportado.
• Áudio, imagem e figurinha contam como "não entendi" e a pergunta é repetida.
• O alerta ao responsável pela Cloud API depende da janela de 24 horas aberta com aquele número. Se o responsável não falou com o número da empresa nas últimas 24 horas, a Meta pode não entregar. Pela Evolution API isso não acontece.
• O lembrete respeita a janela de horário do Enviador (janela_inicio e janela_fim do Núcleo). Fora dela, o lembrete espera o próximo ciclo de 15 minutos dentro do horário.
• A demonstração guarda a conversa por sessão do navegador. Recarregar a página começa um novo contato. Ela não envia WhatsApp, não manda lembrete de verdade e grava a ficha como qualificacao_demo.
• Depende do Roteador de entrada do Núcleo estar publicado. Sem ele, as respostas dos contatos não chegam.
• A conversa aberta expira em 7 dias; o lembrete e o encerramento normalmente fecham muito antes.