Instalar Pré-requisitos
Antes de começar, você precisa ter alguns programas instalados. Não se preocupe — o Claude vai verificar tudo automaticamente e te avisar se estiver faltando algo.
Claude Code — o assistente de setup
Abra o terminal e cole o comando abaixo:
npm install -g @anthropic-ai/claude-code
Python, Node.js, Git e Docker Desktop
Escolha seu sistema operacional e siga as instruções:
brew install python@3.11 node git && brew install --cask docker. Depois abra o Docker Desktop e aguarde iniciar.Primeiro Acesso — Clonar e Abrir
Com os pré-requisitos instalados, você vai clonar o repositório e abrir o Claude. A partir daí, o Claude conduz tudo sozinho — você não precisa digitar mais nenhum comando.
git clone https://github.com/zxmarketingdigital/zx-control-semana1.git && \ cd zx-control-semana1 && \ claude
O que acontece quando você rodar esse comando
O Git baixa o repositório, entra na pasta e abre o Claude Code. O Claude vai se apresentar e aguardar você dar o sinal para começar.
Na primeira vez, o Claude vai se autenticar
Se for seu primeiro uso do Claude Code, ele vai pedir para você fazer login com sua conta Anthropic. Siga as instruções na tela (é só abrir um link no navegador).
Digite INICIAR SETUP para começar
Quando o Claude aparecer e se apresentar, você escreve exatamente isso e pressiona Enter:
INICIAR SETUPA partir daí o Claude conduz tudo — você não precisa mais digitar nenhum comando técnico.
Configurar o Ambiente
O Claude vai coletar algumas informações sobre você e seu negócio, e criar toda a estrutura de pastas da sua operação IA no computador.
Seu nome
Para personalizar o agente e os relatórios com seu nome.
Nome do seu negócio
Usado nas mensagens do agente e nos relatórios de status.
O Claude vai perguntar qual provedor de WhatsApp você quer usar
Você tem duas opções — escolha a que melhor se encaixa no seu cenário:
~/.operacao-ia/ ├── config/ │ └── config.json # suas configurações ├── scripts/ # scripts de automação ├── data/ # banco de contatos └── logs/ # relatórios e logs
Conectar o WhatsApp
O Claude vai instalar e configurar o provedor de WhatsApp escolhido. Você vai escanear um QR Code com seu celular para conectar o número.
Evolution API — roda no seu computador
O Claude instala e configura tudo automaticamente. Ele vai exibir um QR Code para você escanear com o WhatsApp do celular.
Z-API — roda na nuvem (R$97/mês)
O Claude vai pedir seu Instance ID e Token. Você encontra esses dados no painel em app.z-api.io após criar sua conta.
Escaneie o QR Code (apenas Evolution API)
O QR Code vai aparecer direto na janela do Claude. Abra o WhatsApp no celular → Dispositivos Conectados → Adicionar Dispositivo → escaneie o código.
Configurar o Email
Vamos conectar o email para envio de notificações e comunicações. Usamos a Resend, uma plataforma confiável com plano gratuito generoso.
Crie uma conta gratuita em resend.com
O plano gratuito inclui 3.000 emails/mês e 100/dia — mais do que suficiente para começar.
Acesse API Keys no painel da Resend
No menu lateral: API Keys → Add API Key. Dê um nome como "ZX Control" e copie a chave gerada.
Cole a API Key quando o Claude pedir
O Claude vai pedir a chave e enviar um email de teste para confirmar que tudo está funcionando.
Ativar o Agente IA
Aqui você configura o agente IA que vai responder seus leads no WhatsApp usando metodologia BANT — qualificando e encaminhando para o fechamento automaticamente.
API Key do provedor escolhido
O Claude vai pedir sua chave e testar com uma mensagem simples para garantir que está funcionando.
Nome e tom do agente
Como o agente vai se apresentar para seus leads: nome, se é mais formal ou informal, foco em vendas ou suporte.
O agente é instalado em ~/.operacao-ia/scripts/
Com um script de inicialização pronto para rodar quando você quiser ativar.
Importar seus Contatos
Importe a lista de contatos para quem você quer enviar mensagens. O sistema aceita CSV ou colagem direta — sem precisar de planilha online.
Colar diretamente no terminal
O Claude vai pedir que você cole seus contatos no formato abaixo, um por linha. Quando terminar, deixe uma linha em branco e pressione Enter.
# nome,telefone (com DDD, sem espaços) João Silva,11999990001 Maria Santos,21988880002 Carlos Oliveira,31977770003
Informar o caminho de um arquivo CSV
Se tiver um arquivo CSV, informe o caminho completo (ex: ~/Downloads/contatos.csv). O Claude detecta o separador automaticamente.
O que acontece automaticamente
Telefones são validados e normalizados (DDI +55 adicionado automaticamente). Uma lista é salva em ~/.operacao-ia/data/contacts.db.
Configurar Disparos
O sistema de disparo envia mensagens para sua lista com proteção automática contra bloqueio. Você sempre revisa antes de enviar qualquer coisa.
Peça ao Claude para montar o disparo
Dentro do Claude, você diz a mensagem que quer enviar e para quem. O Claude monta tudo e mostra um preview com os primeiros contatos antes de enviar qualquer coisa.
"Claude, quero enviar para minha lista: Oi {nome}, tudo bem? Tenho uma novidade para te contar. Mostra o preview antes de enviar."
Revise o preview e confirme
O Claude mostra como ficará cada mensagem com o nome real de cada contato. Só depois de você confirmar ele começa a enviar — nunca sem sua aprovação.
Filtre por grupo ou tag quando quiser
Você pode pedir ao Claude para enviar só para um grupo específico de contatos. Exemplo: "Envia só para os contatos com a tag 'clientes ativos'."
Ativar o Monitor Diário
O monitor verifica automaticamente se todos os serviços estão funcionando e te envia um relatório no próprio WhatsApp todo dia às 8h da manhã.
O Claude instala o monitor automaticamente
O monitor é registrado como um serviço do sistema e começa a rodar todo dia às 8h — sem você precisar fazer nada.
Primeiro health check imediato
O Claude vai perguntar se você quer rodar o monitor agora para ver o status de tudo que foi configurado.
Teste Final e Operação Pronta
Último passo! O Claude vai guiar você pelo primeiro teste de disparo e confirmar que a Operação IA está completamente funcional.
Resumo de tudo que foi configurado
O Claude mostra um painel completo com status de cada componente: WhatsApp, Email, Agente IA, Contatos, Dispatcher e Monitor.
Primeiro disparo guiado — dentro do Claude
O Claude conduz você pelo primeiro teste de envio. Ele mostra como ficará a mensagem para cada contato antes de qualquer coisa ser enviada. Você aprova e ele dispara.
"Faz o teste do primeiro disparo para minha lista."
Ele cuida do resto.
Operação IA pronta
A partir de agora, sua operação funciona de forma autônoma. O agente responde leads, o monitor avisa se algo der errado, e você dispara quando quiser.