Diagnósticos (Triagem, Pré-proposta e Detalhamento)

Objetivo

Dar ao visitante do site uma estimativa concreta em poucos minutos, sem cadastro antes da hora, e entregar ao Consultor um lead já entendido. O diagnóstico tem duas etapas (ADR-0006): a Triagem no chat, conduzida pelo Agente SDR, que termina numa Pré-proposta; e o Detalhamento, uma página guiada em /d/<código> onde o lead refina o escopo com o catálogo inteiro. A Leitura do site complementa o que o lead disse. Regra que atravessa tudo (ADR-0004): o modelo escolhe itens do Catálogo; o código valida e precifica. O modelo nunca inventa valor.

Fluxo

1. Abertura. O visitante abre o chat; a saudação é fixa e não chama o modelo. Na Witbiz, "Sou a IA da Witbiz…"; em outra organização, a mesma frase com "Sou a assistente de <organização>".
2. Triagem (etapa 1). A cada mensagem, o Agente SDR responde em streaming e registra o estado da conversa por ferramenta (atualizar_estado): nome, e-mail, empresa, site, setor, ferramentas, porte e classe de porte, dor, Vertical, Momento, orçamento, urgência, cargo, Origem, telefone e consentimento. O lead é criado quando aparece o nome. O agente se apresenta como a organização e lê o perfil de IA dela (negócio, cliente ideal, produtos, playbook, objeções, tom, vocabulário, instruções).
3. Qualificação. Com dor, porte e urgência conhecidos e aderência ao portfólio, o lead passa de em_triagem a qualificado.
4. Pré-proposta. Na mensagem de recomendação, o agente indica os itens do catálogo com o porquê de cada um. O código monta a Pré-proposta, grava com código único, anexa ao texto o bloco de investimento com o link /p/<código> e o link da etapa 2 /d/<código>, e envia por e-mail se houver e-mail e consentimento. A Pré-proposta vira também a versão 0 da Proposta do lead (ver funcional/propostas).
5. Perguntas para o Consultor. Depois da Pré-proposta, o agente pergunta Origem, cargo e WhatsApp (o visitante pode pular).
6. Handoff. Fim natural ou caso sensível leva o lead a handoff com dono pela Vertical. Na Witbiz, o agente indica Alberto ou Carolina com o link de agenda; em outra organização, diz que um consultor dela continua a conversa e pede dia e horário, sem citar nomes nem links. No Handoff ou no encerramento, roda a cadeia: leitura do site → vetor → resumo → Próxima ação.
7. **Página da Pré-proposta (/p/<código>).** O lead vê momento, itens com faixa, o que inclui, entregáveis e o que não inclui, condições e os Consultores com link de agenda. Cada abertura vira sinal.
8. **Detalhamento (etapa 2, /d/<código>).** O lead responde 9 perguntas de múltipla escolha; as respostas viram sinais; a IA (ou a regra) recomenda itens de todo o catálogo com o porquê; o lead liga e desliga itens, vê o total mudar e fecha. Nasce uma nova Pré-proposta, com e-mail e sinal na Radhr AI.
9. Na Radhr AI. O Consultor confirma ou ajusta a estimativa na aba Diagnóstico do Lead Workspace.

Regras de negócio

• Precificação determinística. Valor de referência = mínimo + (máximo − mínimo) × posição do porte (pequeno 0,3; médio 0,5; grande 0,7), arredondado a R$ 500. Porte desconhecido conta como médio. Ids fora do catálogo são descartados. — src/catalogo.ts (montarPreProposta)
• Agrupamentos automáticos. 4 ou mais módulos do Foundation viram a implantação completa; 2 ou mais agentes da mesma máquina (vendas, retenção, operação) viram a suíte. — src/catalogo.ts
• Condições comerciais. Padrão do código: até 10x sem juros no cartão ou 5% de desconto à vista, sobre os itens não mensais (itens mensais, como a sustentação, ficam fora do total), e validade de 15 dias. Quando o perfil de IA da organização define regras de preço e de proposta, valem as dela: parcelas e desconto à vista no texto do Agente SDR e na soma da página da etapa 2; validade na data de vencimento das Pré-propostas do chat e da etapa 2. O total gravado na Pré-proposta (parcela e valor à vista) e o texto "válida por N dias" do bloco de investimento do chat ainda usam o padrão do código. — src/catalogo.ts (CONDICOES_COMERCIAIS, montarPreProposta), src/perfil/condicoes.ts, src/agente.ts, src/detalhar.ts
• Uma Pré-proposta vigente por vez no chat. O agente só gera outra se não houver uma válida que não esteja ajustada. Vencida ou ajustada pelo Consultor libera uma nova. — src/agente.ts
• O agente não cita números. O bloco de investimento é anexado pelo código; o prompt proíbe valores, descontos além do publicado, promessas de resultado e buzzwords. — src/agente.ts (montarSistema)
• O que a organização não faz. Na Witbiz, o prompt diz que ela não faz postagem, community management, conteúdo/criativos nem operação diária de mídia. Em outra organização, a lista vem dos itens "não incluir" das regras de proposta do perfil; sem lista, a regra não entra. Se a dor for só isso, o agente diz com honestidade e encaminha. — src/agente.ts (montarSistema)
• Handoff obrigatório em pedido de desconto/negociação, reclamação, assunto jurídico, imprensa, pedido explícito de humano e quando o modelo recusa responder. — src/agente.ts
• E-mail da Pré-proposta só com consentimento. Sem e-mail ou sem consentimento, nada é enviado. — src/agente.ts, src/detalhar.ts
• Limites de abuso. 20 requisições por minuto e 200 por dia por IP no chat e nas ações da etapa 2; a conversa encerra em 30 mensagens do visitante. — src/limite.ts, src/agente.ts
• Abertura é sinal. Cada abertura de /p/<código> soma em aberturas, registra pre_proposta_aberta e pede a Próxima ação (respeitando o intervalo mínimo). A página continua abrindo depois de vencida, com o selo "expirada". — src/proposta.ts
• Etapa 2: respostas fechadas. Só perguntas e opções que existem são aceitas; cada opção acende sinais. — src/detalhar.ts (validarRespostas, PERGUNTAS)
• Etapa 2: IA com rede de segurança. A regra calcula a recomendação primeiro; o modelo lê conversa, sinais, site e catálogo e devolve JSON; o código aceita só ids válidos (agente válido quando é ai.agente). Se o modelo falhar, vale a regra e fica o evento detalhamento_ia_falhou. A leitura é guardada por hash (mesmas respostas não chamam o modelo de novo). O prompt se apresenta como consultor sênior da organização e recebe o perfil dela (negócio, produtos, serviços, cliente ideal, tom, instruções). — src/detalhar.ts
• Etapa 2 com a marca da organização. A página /d/<código> mostra logo, nome curto, rodapé e cores da organização dona do link (sem configuração, Witbiz), e o e-mail do escopo detalhado sai com o assunto "Seu escopo detalhado <organização> — <empresa>". — src/detalhar.ts, src/identidade.ts
• Etapa 2: fechar sempre cria. Cada "fechar" cria uma nova Pré-proposta (até 20 itens), marcada com as respostas e a origem, registra pre_proposta_detalhada, vira nova versão da Proposta (origem etapa2) e força uma nova Próxima ação. O link /d/ não verifica a validade da Pré-proposta de origem. — src/detalhar.ts
• Leitura do site. Lê a página inicial (até 10 s e 400 KB); sinais técnicos por regex (GA4, GTM, pixel da Meta, CRM de mercado, plataforma, WhatsApp, chat, formulário); o modelo resume em 3 a 5 fatos para os consultores da organização, com o resumo do negócio e o cliente ideal do perfil dela. Uma leitura por URL, salvo quando o Consultor pede de novo. Falha fica registrada com o motivo. — src/site.ts
• Resumo da IA em 4 linhas (Quem, Dor, Recomendado, Situação), gerado ao fim da triagem e sob demanda; idempotente por hash, que inclui a versão do perfil da organização (perfil novo, resumo refeito). — src/resumo.ts
• Confirmar ou ajustar. O Consultor marca a Pré-proposta como confirmada ou ajustada (motivo obrigatório, que entra no rascunho da proposta legado e libera nova Pré-proposta no chat). — src/radar/lead.ts
• Ações só em lead da organização. Confirmar, ajustar, reler o site ou o resumo (POST /radar/lead/:id) exigem que o lead exista na organização da sessão; senão, 404 sem gravar nada. — src/radar/lead.ts

Casos de uso

• Visitante com dor de CRM desatualizado e leads sem resposta. O agente recomenda Foundation · CRM e o Agente SDR; o código precifica pelo porte e mostra o total com parcelas.
• Lead quer ir mais fundo. Abre /d/<código>, marca "planilhas paralelas" e "propostas paradas"; a recomendação inclui Automação & Integrações e o Agente de Recuperação; ele fecha e recebe o escopo detalhado por e-mail.
• Consultor discorda da estimativa. Marca como ajustada com o motivo ("tier Completo, não Enterprise"); o motivo orienta o rascunho legado e a próxima conversa no chat pode gerar outra.
• Site não carregou. O cartão "Sobre a empresa" mostra "não lido" com o motivo (ex.: tempo esgotado); o botão "Tentar de novo" relê.
• Pré-proposta vencendo sem abertura. A Home mostra o risco "Pré-proposta vence em N d e nunca foi aberta" a partir de 3 dias do vencimento.

Telas

• Widget do chat (site público). Triagem com o Agente SDR, bloco de investimento e links da etapa 1 e 2.
• **/p/<código> — Pré-proposta (pública).** Momento, itens por fase com Valor de referência e faixa, inclui/entregáveis/não inclui, condições, validade e Consultores com agenda.
• **/d/<código> — Detalhamento (público).** Com a marca da organização. Perguntas passo a passo, recomendação com o porquê, itens para ligar e desligar com o total ao vivo, botão de fechar o escopo.
• **/radar/lead/:id, aba Diagnóstico.** Pré-propostas (itens, aberturas, respostas da etapa 2, confirmar/ajustar, link da página), "Sobre a empresa" (fatos e sinais do site, reler) e Reunião → CRM. A aba Conversa mostra a transcrição da triagem; o Resumo da IA fica na coluna lateral.
• **/radar/conversa/:id.** Triagem de quem não se identificou, com "Criar lead a partir desta conversa".

Permissões

• Visitante / lead anônimo: usa o chat; abre /p/<código> e /d/<código> sem login. O código (12 caracteres hexadecimais) é a chave: quem tem o link vê a Pré-proposta e pode fechar um escopo detalhado.
• Consultor e admin: veem Pré-propostas, transcrições, site e resumo; confirmam ou ajustam a estimativa; releem o site e o resumo.
• Financeiro e leitura: consultam as triagens e as pré-propostas; ajustar ou reenviar uma pré-proposta é recusado com 403 (src/radar/permissoes.ts).
• Plano: nenhum recurso desta área depende de plano; todos têm "agente SDR no site e diagnóstico em duas etapas". O resumo, a leitura do site, a etapa 2 e o turno do chat respeitam o Limite de IA. Atingido o limite, a etapa 2 usa a regra, e o chat oferece o formulário de contato e passa o lead ao consultor (Handoff com motivo limite_ia).

Perguntas frequentes

O valor da Pré-proposta é o preço da proposta? Não. É o Valor de referência, estimativa sujeita à confirmação do Consultor e não vinculante. Quem fecha preço é o Consultor, no editor de Proposta.

Por que o chat não gerou uma segunda Pré-proposta? Porque ainda há uma válida e não ajustada. Marque a atual como ajustada ou espere o vencimento (15 dias no padrão, ou a validade definida no perfil da organização).

O lead fechou o escopo na etapa 2 duas vezes. Qual vale? As duas ficam registradas; cada uma vira nova versão da Proposta. A mais recente aparece primeiro na aba Diagnóstico e é a base do Score.

A etapa 2 usou IA ou regra? A resposta da página indica; se o modelo falhou, a linha do tempo tem detalhamento_ia_falhou com o motivo.

O que a leitura do site faz com o que o lead disse? Nada substitui: os fatos do site complementam a ficha e entram nos prompts do resumo, da Próxima ação, do rascunho e da etapa 2.

O chat de outra organização cita a Witbiz? Quase nunca. Saudação, identidade, handoff, página da etapa 2 e assunto do e-mail do escopo usam o nome e a marca da organização dona do site. Ainda são fixos da Witbiz: o assunto do e-mail da Pré-proposta do chat ("Sua pré-proposta Witbiz"), o rodapé do corpo desse e-mail (usado também no e-mail da etapa 2) e a frase "A proposta formal sai da conversa com um dos nossos sócios".

Onde vejo a conversa inteira? Na aba Conversa do Lead Workspace. Conversas sem nome aparecem em "Triagens sem identificação" na lista de leads.