Ir direto para o conteúdo

Prompt · Claude Code

Construir um agente de qualificação de leads no Claude Code

Objetivo

Gerar o arquivo completo de um agente do Claude Code que classifica leads segundo os seus critérios e devolve sempre no mesmo formato.

Quando usar

Quando a qualificação de leads já tem critério claro, acontece toda semana e você está cansado de reexplicar o critério a cada vez.

Tempo que costuma economizar

Cerca de 4 horas no primeiro mês e depois cerca de 2 horas por semana

Estimativa a partir do trabalho que ele substitui, não medição.

Copie, troque as variáveis, cole no modelo

Resultado esperado

O conteúdo completo do arquivo do agente, com cabeçalho declarando name, description e tools, tabela de pontuação somando o máximo declarado, faixas sem buraco, regras contra suposição e formato de saída fixo; mais as instruções de onde salvar, a frase de teste e um caso de lead incompleto para conferir a obediência à regra.

O que não faz

Não instala o Claude Code nem conecta no seu CRM: o agente lê o que você colar ou os arquivos da pasta. Não decide o critério por você, e critério vago gera pontuação vaga. E agente que classifica não substitui ligação: ele ordena a fila, quem vende é o time.

Você é engenheiro de agentes e vai escrever, para a empresa brasileira de
pequeno ou médio porte {{nome_da_empresa}}, o arquivo de um subagente do
Claude Code que qualifica leads. Sua entrega é o conteúdo completo do arquivo,
pronto para ser salvo em .claude/agents/qualificador-de-leads.md, e mais nada
além das instruções de instalação e do teste.

CONTEXTO DO NEGÓCIO

1. O que a empresa vende, com faixa de preço: {{o_que_voce_vende}}
2. Critérios de qualificação, do jeito que o dono explica hoje:
   {{criterios_de_qualificacao}}
3. Como os leads chegam e quais campos existem em cada um:
   {{formato_dos_leads}}
4. O que deve acontecer com cada faixa de classificação:
   {{acao_para_cada_faixa}}

A TAREFA, NESTA ORDEM

Passo 1. Escreva o cabeçalho do arquivo, entre duas linhas de três hífens, com
três campos: name, com um identificador curto em minúsculas e hífens;
description, escrita de forma que o Claude Code saiba quando acionar o agente
sozinho, incluindo exemplos de pedido do usuário; e tools, listando apenas as
ferramentas necessárias, sem dar acesso de escrita ao que não precisa.

Passo 2. No corpo do arquivo, escreva o papel do agente e o contexto do
negócio em até dez linhas.

Passo 3. Transforme os critérios informados em uma tabela de pontuação
explícita: cada critério, quanto vale, e como se verifica no dado disponível.
A soma máxima precisa ser declarada.

Passo 4. Defina as faixas de classificação a partir da pontuação, com a ação
correspondente a cada faixa.

Passo 5. Escreva as regras duras do agente: não inventar dado que não está na
linha do lead; marcar como "sem informação" o campo ausente em vez de supor;
nunca reprovar lead por falta de dado, e sim sinalizar o que perguntar;
português do Brasil.

Passo 6. Defina o formato de saída fixo: uma tabela com as colunas Lead,
Pontuação, Faixa, Motivo em uma linha, O que perguntar antes de avançar, mais
um resumo com a contagem por faixa.

Passo 7. Escreva, fora do arquivo, três coisas: como salvar e onde, uma frase
de teste para acionar o agente e um caso de lead incompleto para verificar se
ele obedece à regra de não supor.

REGRAS DURAS DESTA TAREFA

Não invente critério que o dono não informou. Não conceda ferramentas de
escrita ou de rede sem necessidade explícita. Não use termo técnico sem
explicar entre parênteses. Entregue o arquivo inteiro, sem trecho omitido.

CRITÉRIO DE QUALIDADE, CONFIRA ANTES DE RESPONDER

A soma dos pesos bate com o máximo declarado. As faixas cobrem toda a escala,
sem sobreposição nem buraco. Todo critério é verificável nos campos que
existem de verdade nos leads. A description permite acionamento automático.

Variáveis a substituir

  • nome_da_empresaNome da sua empresa.Ex.: Norte Sistemas
  • o_que_voce_vendeSua oferta em uma linha, com faixa de preço.Ex.: sistema de gestão para transportadoras, mensalidade de R$ 900 a R$ 3.000
  • criterios_de_qualificacaoO que faz um lead ser bom, do jeito que você explicaria para um funcionário novo.Ex.: empresa de transporte com mais de 20 caminhões, no Sul, que já usa algum sistema e tem quem decide na conversa
  • formato_dos_leadsComo os leads chegam e quais campos cada um traz.Ex.: linhas de planilha com nome, empresa, cidade, frota, sistema atual e mensagem
  • acao_para_cada_faixaO que o time faz com cada faixa de classificação.Ex.: quente vai para ligação no mesmo dia; morno entra na cadência de e-mail; frio recebe conteúdo e volta em 90 dias

Peça ao Claude Code que escreva o arquivo do agente: um Markdown em .claude/agents/ com nome, descrição e ferramentas permitidas no cabeçalho, e as suas regras de qualificação no corpo. Depois disso, ao pedir para qualificar a lista, o agente costuma entrar sozinho quando o pedido combina com a descrição. Se não entrar, chame-o pelo nome.

Para quem é: Dono que já usa o Claude Code na máquina e quer parar de repetir as mesmas instruções de qualificação toda semana.

Quando este prompt serve

Serve quando a qualificação já tem critério e virou repetição. Antes de tudo, o que é um agente do Claude Code em linguagem de dono: é um arquivo de texto, em formato Markdown, salvo numa pasta chamada .claude/agents/ dentro do seu projeto. Esse arquivo tem um cabeçalho curto que declara o nome do agente, a descrição do que ele faz e quais ferramentas ele pode usar; abaixo do cabeçalho vem a instrução completa, escrita em português mesmo. Quando você pede algo que combina com a descrição, o Claude Code costuma acionar esse agente sozinho, com aquelas instruções carregadas — o acionamento automático depende do texto da descrição, e não é garantido; chamar o agente pelo nome funciona sempre. Na prática, é um funcionário de tarefa única que nunca esquece o combinado.

O que preparar antes de colar

Quatro informações. A oferta com faixa de preço. Os critérios de qualificação do jeito que você explicaria a um funcionário novo, sem economizar detalhe: porte, região, situação atual, quem decide. Os campos que os seus leads realmente trazem — abra a planilha ou o formulário e copie os nomes das colunas, porque critério que depende de campo inexistente não funciona. E o que o time faz com cada faixa. Tenha o Claude Code instalado e uma pasta de trabalho, mesmo que seja uma pasta só com planilhas.

Como usar

Rode o prompt no Claude Code, dentro da pasta do projeto. Ele devolve o arquivo inteiro; salve como .claude/agents/qualificador-de-leads.md. O esqueleto tem esta cara:

---
name: qualificador-de-leads
description: Qualifica leads de transportadoras segundo os critérios da Norte Sistemas. Use quando o pedido for "qualifica esses leads", "classifica a lista da semana" ou "quais leads valem ligação".
tools: Read, Grep, Glob
---

Você qualifica leads da Norte Sistemas, que vende sistema de gestão para
transportadoras (mensalidade de R$ 900 a R$ 3.000).

Pontuação (máximo 100):
frota acima de 20 caminhões vale 40; região Sul vale 20; já usa algum sistema
vale 20; quem decide participa da conversa vale 20.

Faixas: 80 a 100 quente; 50 a 79 morno; 0 a 49 frio.

Regras: não suponha campo ausente, marque "sem informação" e diga o que
perguntar. Nunca reprove lead por falta de dado.

Saída: tabela com Lead, Pontuação, Faixa, Motivo em uma linha, O que perguntar.

Depois é só pedir "qualifica os leads da semana" com a lista colada ou o arquivo na pasta. Teste com um lead incompleto de propósito e confira se ele marcou "sem informação" em vez de chutar.

O que esperar de volta

O arquivo completo, com pesos que somam o máximo declarado, faixas que cobrem toda a escala, regras contra suposição e um formato de saída fixo — o formato fixo é o que permite comparar semanas diferentes. Junto vêm as instruções de instalação, uma frase de teste e um caso de conferência.

O que este prompt não faz

Não instala nada nem se conecta ao seu CRM. Não melhora critério ruim: se você disser "lead bom é lead interessado", a pontuação vai ser inútil. Não substitui o vendedor, apenas ordena a fila. E, se você der ferramentas de escrita ao agente sem necessidade, ele pode alterar arquivos — conceda só leitura enquanto estiver testando.

Como melhorar a resposta

Peça que o agente registre, ao final de cada rodada, os campos que mais faltaram, para você corrigir o formulário. Rode a mesma lista duas vezes e confira se a pontuação bate; se variar, os critérios ainda estão vagos. E peça uma segunda versão do cabeçalho com uma descrição mais específica, para o agente ser acionado nas frases que você realmente digita.

Leia a seguir

Perguntas que costumam vir junto

Como criar um agente no Claude Code?

Um agente no Claude Code é um arquivo de texto com instruções, salvo em `.claude/agents/` dentro da pasta do projeto. Ele tem um cabeçalho com nome, descrição e ferramentas permitidas, e abaixo o manual de como agir. Quando a tarefa bate com a descrição, esse agente é chamado.

Ver a resposta completa a «Como criar um agente no Claude Code?»

Como qualificar um lead?

Qualificar é decidir, em até cinco minutos, se vale investir uma reunião naquele contato. Use quatro perguntas: ele tem o perfil do seu cliente ideal, tem uma dor que você resolve, quem decide está na conversa e existe prazo. Três respostas boas de quatro já autorizam a reunião.

Ver a resposta completa a «Como qualificar um lead?»

Continue por aqui

FerramentaGargalos

Diagnóstico do funil

Esta calculadora recebe os números de cada etapa da sua venda e mostra onde o dinheiro está vazando. Ela devolve a taxa de passagem de cada…

PromptDocumentação

Criar um SOP a partir de uma gravação de tela

Grave a tela narrando o que você faz, cole a transcrição e peça o procedimento escrito. A resposta devolve os passos numerados com tempo estimado, responsável,…