CRM de Leads

O que faz

O CRM de Leads transforma o Claude Code num assistente de vendas leve, capaz de

capturar, qualificar e organizar contatos dentro de um funil simples, sem que você

precise abrir uma planilha gigante ou uma ferramenta cara. A ideia é que todo o seu

pipeline viva num arquivo versionado (leads.json ou um CSV) dentro do próprio

projeto, fácil de auditar, fácil de versionar no Git e fácil de migrar depois para um

CRM "de verdade" quando o volume justificar.

O plugin entende o vocabulário comercial brasileiro: lead frio, morno e quente; etapas

como "novo", "contato feito", "proposta enviada", "ganho" e "perdido"; e critérios de

qualificação no estilo BANT (orçamento, autoridade, necessidade e prazo). Ele ajuda

você a registrar um novo contato em segundos, a decidir quem merece atenção agora e a

escrever o próximo follow-up sem partir do zero.

Casos de uso típicos:

• Solo founders e freelancers que recebem leads por WhatsApp, Instagram e e-mail e

precisam de um lugar único para organizá-los.

• Pequenas agências que querem padronizar a qualificação antes de passar o lead para

um closer.

• Times de cursos e infoprodutos (como a Aulas de IA) que captam interessados e

precisam priorizar quem está mais perto da compra.

Instalação

1. Copie a pasta crm-leads/ para o diretório de plugins do seu projeto ou do seu

perfil do Claude Code (por exemplo ~/.claude/plugins/).

1. Reinicie a sessão do Claude Code para que o manifesto .claude-plugin/plugin.json

seja carregado.

1. Na primeira execução, peça /lead-novo para que o arquivo de pipeline seja criado

automaticamente caso ainda não exista.

Nenhuma dependência externa é obrigatória. Se quiser sincronizar com uma planilha,

combine este plugin com o sheets-connector.

Comandos disponíveis

• /lead-novo — registra um novo lead no pipeline a partir de uma frase livre

(nome, empresa, canal, interesse) e já sugere a etapa inicial.

• /lead-qualificar — aplica uma checagem BANT ao lead informado, atribui uma

temperatura (frio/morno/quente) e recomenda a próxima ação.

• /lead-followup — escreve uma mensagem de acompanhamento personalizada para o

lead, no tom e no canal corretos.

Configuração

O plugin funciona 100% offline por padrão. As variáveis abaixo são opcionais e só

servem se você quiser integrar com serviços externos. Sempre referencie pelo nome

da variável de ambiente — nunca cole valores reais no projeto.

• CRM_PIPELINE_PATH — caminho do arquivo de pipeline (padrão: ./leads.json).
• CRM_OWNER_NAME — seu nome, usado para assinar follow-ups.
• CRM_TIMEZONE — fuso horário para cálculo de prazos (padrão: America/Sao_Paulo).
• SLACK_WEBHOOK_URL — se definido, permite notificar o time quando um lead vira

"quente" (requer o plugin slack-notificador).

Exemplo de uso

/lead-novo Mariana Costa, gerente de marketing da Padaria Pão Quente,
veio pelo Instagram pedindo orçamento de gestão de redes sociais.

O Claude registra o lead, define a etapa "novo", marca o canal "Instagram" e pergunta

se você quer já qualificar. Em seguida:

/lead-qualificar Mariana Costa

Ele faz as perguntas BANT que faltam, conclui que é um lead morno (necessidade

clara, mas orçamento ainda indefinido) e sugere enviar um caso de sucesso antes da

proposta. Por fim:

/lead-followup Mariana Costa

gera uma mensagem curta e cordial para WhatsApp, pronta para copiar e colar.

Segurança e limites

• Dados sensíveis: o pipeline pode conter nomes, telefones e e-mails. Trate o

arquivo como dado pessoal sob a LGPD — não comite leads reais em repositórios

públicos. Adicione leads.json ao .gitignore quando o repositório for aberto.

• Sem disparo automático: o plugin nunca envia mensagens sozinho; ele apenas

redige. O envio é sempre uma ação manual sua, evitando spam e protegendo a

reputação dos seus canais.

• Limites de volume: para pipelines acima de alguns milhares de leads, prefira um

CRM dedicado; este plugin é otimizado para times pequenos e arquivos legíveis.

• Privacidade: consentimento de contato (opt-in) é responsabilidade sua. Registre

no campo de notas a origem e a base legal do contato.