Aulas

Aulas — Setup 1

Assista as aulas gravadas do Setup 1 antes de começar o setup. Cada aula complementa as etapas práticas que você vai executar a seguir.

O que você vai construir nesta semana

📱

WhatsApp conectado — seu número respondendo leads via Evolution API (grátis) ou Z-API

📧

Email automatizado — integração Resend com plano gratuito 3.000 emails/mês

🤖

Agente IA BANT — qualifica leads automaticamente (OpenAI, Gemini ou Claude)

👥

Base de contatos — importa sua lista e organiza em banco local

🚀

Disparos seguros — rate limiter (30/h, 150/dia) e dry-run obrigatório

📊

Monitor diário — relatório de saúde às 8h, sem você precisar lembrar

Aula 1 — Instalação CLI

Aula 2 — Gerenciamento de Modelos de IA

Aula 3 — Setup 1 ZX Control

Etapa 1 de 8 Pendente

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.

O que você precisa ter instalado

Claude Code CLI — o assistente que vai conduzir seu setup

Python 3.11+ — linguagem dos scripts de automação

Node.js 18+ — necessário para algumas dependências

Git — para clonar o repositório do curso

Docker Desktop — para rodar a Evolution API (WhatsApp)

Como instalar cada programa

Claude Code — o assistente de setup

Abra o terminal e cole o comando abaixo:

terminal

npm install -g @anthropic-ai/claude-code

💡 Não tem conta Anthropic? Crie gratuitamente em claude.ai antes de continuar.

Python, Node.js, Git e Docker Desktop

Escolha seu sistema operacional e siga as instruções:

🍎

macOS — use Homebrew: brew install python@3.11 node git && brew install --cask docker. Depois abra o Docker Desktop e aguarde iniciar.

🪟

Windows — baixe e instale: Python (python.org), Node.js (nodejs.org), Git (git-scm.com) e Docker Desktop (docker.com). Reinicie o computador após instalar o Docker.

Etapa 2 de 8 Pendente

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.

O único comando que você precisa rodar

terminal — cole e pressione Enter
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).

💡 Não tem conta Anthropic? Crie gratuitamente em claude.ai antes de continuar.

Digite INICIAR SETUP para começar

Quando o Claude aparecer e se apresentar, você escreve exatamente isso e pressiona Enter:

escreva no Claude

INICIAR SETUP

A partir daí o Claude conduz tudo — você não precisa mais digitar nenhum comando técnico.

Etapa 3 de 8 Pendente

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.

O que o Claude vai perguntar

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:

🚀

Evolution API

Roda no seu computador via Docker. Open-source e sem custo adicional. Recomendado para quem quer começar sem gastar.

Gratuita

📱

Z-API

Roda na nuvem — mais estável e não depende do seu computador ficar ligado. Plano pago a partir de R$97/mês por instância.

R$97/mês

O que é criado na sua máquina

estrutura criada em ~/.operacao-ia/
~/.operacao-ia/
├── config/
│   └── config.json          # suas configurações
├── scripts/               # scripts de automação
├── data/                  # banco de contatos
└── logs/                  # relatórios e logs

Etapa 4 de 8 Pendente

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.

Como funciona a conexão

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.

⚠️ O Docker Desktop precisa estar aberto antes desta etapa. Se ainda não estiver, abra agora e aguarde o ícone estabilizar na barra de tarefas.

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.

💡 Vantagem da Z-API: funciona 24h mesmo com seu computador desligado.

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.

Etapa 5 de 8 Pendente

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.

Como obter sua API Key da Resend

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.

⚠️ Guarde a API Key em lugar seguro — ela aparece apenas uma vez na Resend.

Etapa 6 de 10 Pendente

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.

Escolha seu provedor de IA

⚡

OpenAI

GPT-5.4 mini. O mais rápido para respostas no WhatsApp. Recomendado para alto volume.

Pago por uso

✨

Google Gemini

Gemini Flash. Plano gratuito generoso — ideal para começar sem custo de IA.

Grátis para começar

🧠

Anthropic (Claude)

Claude Haiku. O mais inteligente e natural nas respostas. Pago por uso.

Melhor qualidade

O que o Claude vai configurar

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.

Etapa 7 de 10 Pendente

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.

Formas de importar

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.

formato de colagem
# 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.

Etapa 8 de 10 Pendente

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.

Proteção automática contra bloqueio

🛡️

Máximo 30 mensagens por hora — ritmo seguro para evitar banimento

🛡️

Máximo 150 mensagens por dia — limite diário para operação saudável

🛡️

90 segundos entre mensagens — intervalo mínimo entre envios

🛡️

Deduplicação automática — nunca envia a mesma mensagem duas vezes para o mesmo contato

Como usar o dispatcher

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.

💬 Exemplo do que falar ao Claude:
"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.

⚠️ O sistema tem proteção automática: máx. 30 mensagens/hora e 150/dia. Isso evita bloqueio do seu número.

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'."

Etapa 9 de 10 Pendente

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 que o monitor verifica

📡

WhatsApp conectado — verifica se a instância está ativa

📧

Email funcionando — teste silencioso de envio

🤖

Agente IA rodando — verifica se o processo está ativo

📊

Relatório HTML — salvo em ~/.operacao-ia/logs/ com histórico

Instalação automática

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.

Etapa 10 de 10 Pendente

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.

O que acontece nesta etapa

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.

💬 Basta dizer ao Claude:
"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.

✅ Checklist da Operação IA Completa

📱WhatsApp conectado✓

📧Email configurado (Resend)✓

🤖Agente IA BANT ativo✓

👥Contatos importados✓

🚀Sistema de disparos com rate limiter✓

📊Monitor diário às 8h✓

Aulas Setup 2

Aulas — Setup 2

Assista a gravação da Mentoria com o passo a passo completo do Setup 2 antes de começar.

Mentoria — Passo a Passo do Setup 2

O que você vai construir nesta semana

🎯

Mission Control — painel único com tudo da sua operação num HTML que você abre no browser

💰

RTK Token Killer — 60-90% menos tokens Claude Code em operações repetitivas

🛠

Pack de skills pro — /status, /healthcheck, /fix, /dedup, /preflight, /harvest, /encerrar

🛡

Agente Guardião + Heartbeat — detecta queda e te avisa no WhatsApp em minutos

☁️

Supabase + Auth — banco de dados na nuvem com login pronto, grátis

📦

Contatos na nuvem — migra sua base da Sem1 (ou cola CSV) direto pro Supabase

🌐

Mini-CRM publicado — deploy real no Cloudflare Pages com login, listagem e CRUD

✅

Checklist final — Mission Control populado com links e status de cada módulo

Etapa 1 de 8 Pendente

Primeiro Acesso — Setup 2

Clone o repositório do Setup 2 e abra o Claude. A partir daí, o Claude conduz todo o setup — você não precisa digitar mais nenhum comando técnico.

Pré-requisitos do Setup 2

✓

Claude Code CLI — instalado e autenticado (claude --version deve funcionar)

✓

GitHub CLI — para clonar o repositório (gh auth status deve mostrar "Logged in")

Setup 1 concluído — recomendado, mas não obrigatório. Se não fez, o Claude cria o ambiente mínimo automaticamente.

O único comando que você precisa rodar

terminal — cole e pressione Enter
gh repo clone zxmarketingdigital/zx-control-semana2 ~/zx-control-semana2 && \
cd ~/zx-control-semana2 && \
claude

O que acontece quando você rodar esse comando

O GitHub CLI 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.

💡 Não tem o GitHub CLI? Instale com brew install gh (macOS) ou acesse cli.github.com.

Digite INICIAR SETUP 2 para começar

Quando o Claude aparecer e se apresentar, você escreve exatamente isso:

escreva no Claude

INICIAR SETUP 2

O Claude faz tudo a partir daqui — você não precisa digitar mais nada.

Independente do Setup 1

Se você pulou o Setup 1, o setup do Setup 2 cria o ambiente mínimo necessário automaticamente. Nada vai quebrar.

O que o Claude faz automaticamente

Ao receber o comando de início, o Claude executa uma série de verificações sem você precisar digitar mais nada:

▶

Verifica quais módulos do Setup 1 já estão instalados

▶

Instala dependências faltantes automaticamente

▶

Cria a estrutura de pastas do Setup 2

▶

Pergunta suas credenciais uma vez e salva em ~/.operacao-ia/config/config.json

Etapa 2 de 8 Pendente

Mission Control

Um painel HTML gerado pelo Claude que centraliza tudo da sua operação — links, status, scripts e logs — num arquivo que você abre direto no browser.

O que o Mission Control inclui

🔗

Links dos serviços — WhatsApp, agente IA, email, Supabase — tudo com um clique

🟢

Status visual — cards verdes/amarelos/vermelhos indicam se cada serviço está rodando

📋

Últimas entradas de log — os últimos registros de cada script sem abrir o terminal

⚡

Atalhos rápidos — botões para iniciar, parar ou reiniciar cada serviço com um clique

Como o Claude gera o Mission Control

O Claude analisa os serviços que você instalou e gera automaticamente um arquivo HTML em:

caminho do arquivo
~/.zxlab-mission-control/dashboard.html

Cada módulo instalado (WhatsApp, agente IA, email, disparos) ganha um card próprio com status e links.

Como abrir no browser

Após o Claude confirmar a criação, abra o arquivo direto no browser:

terminal

open ~/.zxlab-mission-control/dashboard.html

💡 Adicione o arquivo como favorito no browser — assim você abre com um clique toda manhã sem precisar do terminal.

Como personalizar

O Mission Control é um HTML puro — você pode pedir ao Claude para adicionar novos cards, mudar cores ou incluir links de serviços externos. Basta dizer "adicione um card para X no Mission Control" em qualquer sessão Claude.

Uso no dia a dia

Toda manhã, antes de qualquer sessão Claude, abra o Mission Control para verificar se todos os serviços estão verdes. Se algum card estiver vermelho, acione /status dentro do Claude para diagnóstico detalhado.

Etapa 3 de 8 Pendente

RTK Token Killer

Uma ferramenta que filtra a saída de comandos antes de passar para o Claude, eliminando ruído e economizando 60-90% dos tokens em operações repetitivas.

Como o RTK funciona

fluxo sem RTK vs com RTK
# Sem RTK — Claude recebe tudo
git log --oneline -50  →  50 linhas para o Claude processar

# Com RTK — Claude recebe só o relevante
git log --oneline -50  →  RTK filtra  →  5 linhas relevantes
                              economia: ~90% dos tokens desta operação

O que é o RTK

O RTK (Rust Token Killer) é um proxy de linha de comando que intercepta a saída de git, ls, cat e outros antes de chegar ao Claude, removendo ruído e economizando 60-90% dos tokens em operações repetitivas.

Verificar instalação

Após o Claude instalar o RTK, confirme que está funcionando:

terminal
rtk --version   # deve mostrar: rtk X.Y.Z
rtk gain        # mostra economia acumulada de tokens

💡 Se aparecer "command not found", rode source ~/.zshrc para recarregar o PATH e tente novamente.

Uso no dia a dia — transparente

Você não muda nada no fluxo. O Claude Code usa o RTK automaticamente via hook. Para acompanhar as economias acumuladas ao longo do tempo:

ver histórico de economia

rtk gain --history

Etapa 4 de 8 Pendente

Pack de Skills Profissionais

Sete comandos prontos que automatizam as tarefas mais comuns do Claude Code — do diagnóstico ao encerramento de sessão.

As 7 skills incluídas no pack

⚡

/status — health check completo: verifica 10+ serviços (WhatsApp, agente, email, scripts) e gera relatório visual

🔍

/healthcheck — versão leve do /status, roda em ~30 segundos, ideal para verificações rápidas

🔧

/fix — analisa o último erro reportado e propõe correção automática

🧹

/dedup — remove contatos duplicados da base, preservando o registro mais recente

✅

/preflight — valida credenciais, conexões e dependências antes de rodar um script crítico

📚

/harvest — salva os aprendizados e decisões da sessão atual em memória persistente

🔐

/encerrar — encerramento limpo: faz commit, salva contexto e fecha a sessão com tudo registrado

Como usar as skills

Dentro de qualquer sessão Claude, digite o nome da skill diretamente no chat:

exemplos de uso
/status        # relatório completo de saúde
/preflight    # verificar antes de um disparo importante
/encerrar     # sempre ao final de cada sessão

Para que serve no dia a dia

As skills substituem tarefas que você faria manualmente ou simplesmente esqueceria. O /encerrar garante que cada sessão termine com o trabalho salvo e commitado. O /status evita surpresas ao verificar tudo de uma vez antes de começar o dia.

Expandir com mais skills

As skills ficam em ~/.claude/skills/. Você pode criar novas ou instalar pacotes adicionais — o Claude pode criar skills personalizadas para sua operação sob demanda.

Etapa 5 de 8 Pendente

Agente Guardião + Heartbeat

Um processo de monitoramento que verifica sua operação a cada 5 minutos e te avisa no WhatsApp se algo cair — antes de você perceber.

O que o Guardião monitora

📱

WhatsApp conectado — verifica se Evolution API / Z-API ainda tem sessão ativa

🤖

Agente IA respondendo — testa se o processo do agente está vivo e aceitando mensagens

⚙️

Scripts em execução — confirma que disparos, monitor diário e heartbeat estão rodando

💻

Recursos do sistema — CPU, memória e disco dentro dos limites normais

O que são o Guardião e o Heartbeat

O Guardião é um script que roda em background via LaunchAgent (macOS). O Heartbeat é o sinal de vida que ele envia regularmente — e que dispara um alerta no seu WhatsApp quando para de chegar.

O que fazer quando receber um alerta

Se chegar uma mensagem de alerta no WhatsApp, siga este passo-a-passo:

Abra o terminal e inicie uma sessão Claude na pasta da operação

Digite /status — o Claude identifica o que caiu e o que precisa ser reiniciado

Siga as instruções do Claude — geralmente é reiniciar um processo ou reconectar o WhatsApp

Verificar se o Guardião está ativo

Para confirmar que o LaunchAgent do Guardião está rodando:

terminal
launchctl list | grep zxlab

Se retornar alguma linha, o Guardião está registrado no sistema.

⚠️ O heartbeat é pausado automaticamente em feriados — comportamento intencional para evitar alertas falsos.

Etapa 6 de 8 Pendente

Supabase + Auth

Configure um banco de dados na nuvem com autenticação pronta — gratuitamente. É a base para o mini-CRM que você vai publicar na próxima etapa.

O que é configurado automaticamente

✓

Projeto Supabase criado — na região mais próxima de você, com nome da operação

✓

Tabela contacts configurada — com schema compatível com os dados do Setup 1

✓

Row Level Security ativada — cada usuário acessa apenas seus próprios dados

✓

Auth por email/senha habilitada — login pronto, sem implementar nada

✓

Credenciais salvas — em ~/.operacao-ia/config/config.json para uso pelos scripts

Criar conta Supabase antes desta etapa

O Claude vai precisar das suas credenciais de API. Crie sua conta gratuitamente antes de começar:

Acesse supabase.com e crie uma conta gratuita

Vá em Account → API Keys e copie sua service_role key

Tenha a key em mãos — o Claude vai pedir quando chegar nesta etapa

O que o banco habilita

Com o Supabase configurado, seus dados saem do computador local e ficam na nuvem — acessíveis de qualquer lugar, com backup automático e autenticação pronta. O mini-CRM da Etapa 8 usa exatamente este banco.

Plano gratuito e limites

O plano gratuito suporta até 500MB de dados e 50.000 usuários — mais que suficiente para começar.

💡 O Supabase pausa projetos inativos após 7 dias sem acesso. Se o CRM parar de responder, acesse o painel Supabase → seu projeto → clique em "Restore project".

Etapa 7 de 8 Pendente

Importar Contatos para a Nuvem

Migre seus contatos do banco local (Setup 1) para o Supabase — ou cole um CSV novo. A partir daqui, sua base fica acessível de qualquer lugar.

Formatos de entrada aceitos

🗄️

SQLite do Setup 1 — migrado automaticamente de ~/.operacao-ia/data/contacts.db

📄

CSV — com colunas: nome, telefone, email, tag, status

✏️

Entrada manual — cole os dados diretamente no chat com o Claude, que formata e importa

Formato do CSV (exemplo)

exemplo de linha do CSV
nome,telefone,email,tag,status
João Silva,5511999998888,joao@email.com,lead,ativo

O que acontece durante a migração

O Claude lê o banco local (ou CSV que você fornecer), normaliza os dados e insere na tabela contacts do Supabase criado na Etapa 6. Duplicatas são detectadas e ignoradas automaticamente.

Verificar a importação

Após o Claude confirmar o import, verifique diretamente no painel Supabase:

Acesse supabase.com → seu projeto

Clique em Table Editor → contacts

Confira se o número de linhas bate com os contatos importados

A partir de agora, tudo vai para a nuvem

Após a migração, novos contatos adicionados pelo agente BANT ou pelos disparos são registrados diretamente no Supabase — sem depender do banco local.

💡 Pulou o Setup 1? Sem problema — diga ao Claude "não tenho banco local" e ele vai pedir para você colar ou importar um CSV.

Etapa 8 de 8 Pendente

Mini-CRM Publicado

Deploy real no Cloudflare Pages — um CRM com login, listagem de contatos e CRUD básico, publicado online. Seu primeiro produto web funcional.

O que é criado no deploy

🔐

Página de login — com Supabase Auth, email/senha, sem código adicional

📋

Listagem de contatos — com paginação, ordenação e busca por nome/email/tag

✏️

Edição de contatos — modal para editar dados e alterar status de cada lead

🌐

URL pública no Cloudflare Pages — acessível de qualquer dispositivo, sem servidor para gerenciar

Como o deploy acontece

O Claude gera o código do mini-CRM e faz o deploy no Cloudflare Pages automaticamente. O processo completo leva menos de 2 minutos:

Claude gera os arquivos HTML/CSS/JS do CRM com suas credenciais Supabase embutidas

Deploy via Wrangler CLI para o Cloudflare Pages (gratuito)

URL pública gerada no formato seu-crm.pages.dev

⚠️ O primeiro deploy pode levar 1-2 minutos para propagar no Cloudflare. Se a URL não abrir imediatamente, aguarde e tente novamente.

Para que serve

O mini-CRM é seu primeiro produto web funcional — do banco de dados ao deploy em produção. Use-o para gerenciar seus leads de qualquer dispositivo e mostre como entregável para clientes da sua agência.

Após o deploy

O link do seu CRM é adicionado automaticamente ao Mission Control ao final desta etapa. Faça o login com as credenciais do Supabase Auth para confirmar que tudo está funcionando.

💡 Quer um domínio personalizado? No painel Cloudflare Pages → Custom Domains, você pode vincular um domínio próprio gratuitamente.

✅ Checklist da Operação Robusta

🎯Mission Control criado✓

💰RTK Token Killer instalado✓

🛠Pack de skills (/status, /fix, /encerrar…)✓

🛡Agente Guardião + Heartbeat ativo✓

☁️Supabase + Auth configurado✓

📦Contatos migrados para a nuvem✓

🌐Mini-CRM publicado no Cloudflare Pages✓

Aulas Setup 3

Aulas — Setup 3

Assista a gravação da Mentoria com o passo a passo completo do Setup 3 antes de começar. Cada aula complementa as etapas práticas que você vai executar a seguir.

Mentoria — Passo a Passo do Setup 3

O que você vai construir nesta semana

🔍

APIFY buscando leads — encontra empresas do seu nicho no Google Maps automaticamente

👤

Perfil de prospecção — define exatamente quem você quer como cliente (nicho, cidade, serviço)

📊

Dashboard de leads — vê score, temperatura e potencial de cada lead num painel dark

📱

Disparos WhatsApp seguros — 30/dia com rate limiter anti-bloqueio e delay randomizado

📧

Email em escala — 200/dia com sequência personalizada por segmento

📝

Copy de 7 dias — mensagens que parecem escritas a mão, geradas automaticamente por segmento

⚙️

Motor de campanhas — decide quando e para quem enviar, respeitando limites e priorizando por score

🕐

Automação diária — roda às 8h toda manhã sem você fazer nada — busca + disparo + dashboard

Etapa 1 de 8 Pendente

Boas-vindas + Diagnóstico

Clone o repositório do Setup 3 e abra o Claude. A partir daí, o Claude conduz todo o setup — você não precisa digitar mais nenhum comando técnico.

Pré-requisitos do Setup 3

✓

Claude Code CLI — instalado e autenticado (claude --version deve funcionar)

✓

GitHub CLI — para clonar o repositório (gh auth status deve mostrar "Logged in")

✓

Semanas 1 e 2 concluídas — o Setup 3 exige a base instalada nas semanas anteriores.

O único comando que você precisa rodar

terminal — cole e pressione Enter
gh repo clone zxmarketingdigital/zx-control-semana3 ~/zx-control-semana3 && \
cd ~/zx-control-semana3 && \
claude

O que acontece quando você rodar esse comando

O GitHub CLI 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.

Digite INICIAR SETUP SEMANA 3 para começar

Quando o Claude aparecer e se apresentar, você escreve exatamente isso:

escreva no Claude

INICIAR SETUP SEMANA 3

O Claude faz tudo a partir daqui — você não precisa digitar mais nada.

O que o Claude instala automaticamente

▶

Verifica se Semanas 1 e 2 estão presentes

▶

Cria subpastas de prospecção em ~/.operacao-ia/prospecting/

▶

Exibe o plano das 9 etapas com benefícios

▶

Detecta sistema operacional (macOS/Windows/Linux)

Etapa 2 de 8 Pendente

Perfil do Cliente Ideal

Uma entrevista guiada pelo Claude para definir exatamente quem você quer prospectar. Sem isso, a busca traz lixo. Com o perfil definido, o robô busca leads certeiros.

O que o Claude vai perguntar

Nome da sua agência ou negócio

Segmentos que quer prospectar (ex: restaurantes, clínicas, academias)

Cidade ou região alvo

Serviço que você oferece

Faixa de preço do seu serviço

Quantos leads por rodada de busca

Canais preferidos (WhatsApp, Email ou ambos)

Seus diferenciais competitivos

Quantas buscas por dia quer fazer

Horário preferido para automação rodar

💡 Pode rodar de novo a qualquer momento para mudar de nicho ou cidade — sem perder os leads já encontrados.

Etapa 3 de 8 Pendente

APIFY — Busca de Leads

Um robô que pesquisa na internet — entra no Google Maps e sites de busca para encontrar empresas do seu nicho com telefone e email. Em vez de horas pesquisando, o robô entrega uma lista pronta em minutos.

Antes de começar — Criar conta gratuita no APIFY

Acesse apify.com e crie sua conta

O plano gratuito inclui créditos suficientes para centenas de buscas por mês. Não precisa cartão.

Copie seu API Token

Em Settings → Integrations → API tokens. O Claude vai pedir esse token para configurar a busca automaticamente.

Busca de teste com 5 leads

O Claude faz uma busca de teste para confirmar que tudo está funcionando — você vê os primeiros leads com nome, telefone, email e rating.

Como o sistema pontua cada lead (Score 0–10)

Critério	Pontos	Por quê
Tem telefone	+2	Pode receber WhatsApp
Tem email	+1	Pode receber email
Sem site ou site simples	+2	Provavelmente precisa de ajuda digital
Rating < 4.5 no Google	+1	Dor visível — pode querer melhorar
Muitas avaliações	+1	Negócio ativo, investe em marketing
Aberto agora	+1	Maior chance de resposta imediata

🔥

Quente — Score 8–10: prioridade máxima, aborda primeiro

🌡

Morno — Score 5–7.9: bom potencial, segue sequência normal

❄️

Frio — Score 0–4.9: potencial baixo, entra no final da fila

Etapa 4 de 8 Pendente

Canais de Disparo

Verificação e configuração dos canais por onde as mensagens serão enviadas. O Claude checa WhatsApp e Email automaticamente — se já estiver configurado do Setup 1, não precisa fazer nada.

O que o Claude verifica e configura

📱

WhatsApp (Evolution API ou Z-API) — verifica se está conectado do Setup 1. Configura automaticamente se necessário.

📧

Email (Resend) — verifica API key e domínio. Configura se necessário.

🛡

Rate Limiter — instala proteção automática: 30 mensagens WhatsApp/dia e 200 emails/dia.

⏱

Delay randomizado — intervalo de 60–120s entre mensagens WhatsApp e 15–30s entre emails para evitar bloqueio.

⚠️ O Rate Limiter é obrigatório — protege sua conta de ser banida pelo WhatsApp. Não tem como desativar sem alterar o código.

Etapa 5 de 8 Pendente

Gerador de Copy

O sistema que cria as mensagens de prospecção automaticamente, personalizadas para cada lead e segmento. Cada lead recebe uma mensagem que parece escrita a mão — mencionando nome da empresa, segmento e um problema real.

Sequência de 7 dias gerada automaticamente

Dia	Tema	WhatsApp	Email
1	Primeiro Contato	Curto, emoji, pergunta direta	Formal, subject personalizado
2	O Problema	Aponta dor específica do segmento	Contexto + estatística
3	Prova Social	Resultado de cliente similar	Case study completo
4	Pergunta Rápida	Só uma pergunta simples	Pergunta + link agenda
5	Case Study	Antes/depois em 3 linhas	Case detalhado com números
6	Urgência	Motivo para agir agora	Proposta de valor + prazo
7	Última Mensagem	Encerra com elegância	Fecha a sequência, deixa porta aberta

💡 O Claude mostra preview do Dia 1 para você aprovar antes de salvar. Pode pedir ajustes no tom ou no foco.

Etapa 6 de 10 Pendente

Dashboard de Prospecção

Uma página HTML simples onde você vê seus leads, o potencial de cada um e marca o status manualmente. Dark theme, auto-refresh a cada 5 minutos, abre direto no browser.

Colunas do dashboard

Nome + Segmento — empresa e categoria do lead

📞

Telefone + Email — contatos encontrados pelo APIFY

📊

Score — pontuação 0–10 calculada automaticamente

🌡

Temperatura — Quente / Morno / Frio baseado no score

💰

Potencial — estimativa de oportunidade por segmento

📍

Step — dia atual na sequência (1–7)

🏷

Status — dropdown manual: Novo / Em Sequência / Respondeu / Sem Interesse / Convertido

💡 O status que você marca no browser é salvo localmente (localStorage). Não precisa de servidor — funciona offline.

Etapa 7 de 10 Pendente

Motor de Campanhas

O coração da prospecção — decide quando e para quem enviar cada mensagem, respeitando os limites. Todo dia de manhã, verifica quem precisa receber mensagem, prioriza por score e dispara sozinho.

Flags disponíveis no motor

Flag	O que faz
--search	Busca novos leads no APIFY agora
--send	Executa os disparos do dia
--dry-run	Simula sem enviar — mostra preview do que seria disparado
--dashboard	Regenera o dashboard HTML com leads atuais
--daily	Combo completo: busca + disparo + dashboard (usado pela automação)

Lógica de priorização

▶

Leads Quentes (score 8–10) são disparados primeiro

▶

Respeita intervalo de 24h desde o último envio para cada lead

▶

Para automaticamente ao atingir 30 WhatsApp ou 200 emails no dia

▶

Claude testa com --dry-run antes de ativar o envio real

Etapa 8 de 10 Pendente

Automação Diária

Um agendador que roda a prospecção automaticamente toda manhã. Às 8h, o sistema busca novos leads, atualiza a lista e dispara as mensagens do dia — sem você fazer nada.

O que o Claude instala

🍎

macOS — LaunchAgent registrado automaticamente. Roda às 8h mesmo com o computador em modo de economia.

🪟

Windows — Task Scheduler configurado automaticamente. Aparece em "Agendador de Tarefas".

4 skills instaladas no Claude Code

Skill	O que faz
/prospectar	Busca novos leads e dispara mensagens agora
/leads	Abre o dashboard de prospecção no browser
/pausar-prospeccao	Desliga a automação das 8h
/retomar-prospeccao	Religa a automação das 8h

Etapa 9 de 10 Pendente

Auditoria Técnica

Uma revisão automática que verifica tudo o que foi instalado, encontra problemas e corrige. Garante que tudo está funcionando de verdade antes de encerrar. Recomendado — leva menos de 1 minuto.

13 checks automáticos

Config.json com credenciais preenchidas

Perfil de prospecção salvo

APIFY API Token válido

WhatsApp conectado e respondendo

Email (Resend) configurado

Rate Limiter ativo com limites corretos

Templates de copy gerados para todos os segmentos

Dashboard HTML gerado e acessível

Scripts do motor de campanhas presentes

Automação das 8h registrada no sistema

Arquivo leads.json inicializado

Banco SQLite de histórico de envios

Checkpoint da Semana 3 no config.json

🔧 Problemas encontrados são corrigidos automaticamente pelo Claude. Você só vê o relatório final.

Etapa 10 de 10 Pendente

Finalização — Primeira Busca Real

O momento final — o APIFY busca os primeiros leads reais do seu nicho, o dashboard abre com eles listados e a operação de prospecção está no ar.

O que acontece na finalização

Primeira busca real de leads

O APIFY faz uma busca completa no nicho e cidade que você configurou. Os leads chegam com score e temperatura calculados.

Dashboard abre com leads reais

O browser abre automaticamente com o dashboard populado — você vê seus primeiros leads prontos para prospecção.

Semana 3 marcada como concluída

O checkpoint é salvo no config.json — a operação está no ar e rodará automaticamente às 8h toda manhã.

Comandos do dia a dia

Skill	Quando usar
/prospectar	Buscar e disparar fora do horário automático
/leads	Ver dashboard e marcar status dos leads
/pausar-prospeccao	Pausar quando estiver fora ou em viagem
/retomar-prospeccao	Reativar quando voltar

Aulas Setup 4

Aulas — Setup 4

Assista à gravação da Mentoria com o passo a passo completo do Setup 4 antes de começar. Cada aula complementa as etapas práticas que você vai executar a seguir.

Mentoria — Passo a Passo do Setup 4

O que você vai construir nesta semana

🤖

Codex Revisor — revisa projetos automaticamente, economiza 60-90% de tokens

🧠

Memória unificada — Claude Desktop e Terminal com a mesma memória via symlink

🔄

Skills em Sync — sincronizadas via git entre máquinas

🕸

Graphify — 60-90% menos tokens em perguntas sobre projetos

🚀

Claude mais rápido — contexto pré-indexado, sem precisar colar código

🎛

Mission Control 2.0 — dashboard completo com status de todas as 4 semanas

Etapa 1 de 8 Pendente

Boas-vindas + Base

Clone o repositório do Setup 4 e abra o Claude. A partir daí, o Claude conduz todo o setup — você não precisa digitar mais nenhum comando técnico.

Pré-requisitos do Setup 4

✓

Semanas 1, 2 e 3 concluídas — o Setup 4 exige phase_completed >= 3

✓

Node.js ≥ 20 — necessário para o plugin Codex (node --version)

✓

Claude Code CLI atualizado — claude --version

O único comando que você precisa rodar

terminal — cole e pressione Enter
gh repo clone zxmarketingdigital/zx-control-semana4 ~/zx-control-semana4 && \
cd ~/zx-control-semana4 && \
claude

Claude abre e se apresenta

Aguarde a mensagem de boas-vindas do Claude. Ele vai listar o que você vai construir nesta semana.

Digite INICIAR SETUP SEMANA 4

escreva no Claude

INICIAR SETUP SEMANA 4

Etapa 2 de 8 Pendente

Codex — Skill manual + Automação opcional

Instala o plugin Codex e a skill /codex-review para revisar projetos quando você quiser. Agendamento automático é opcional — você escolhe se quer ou não.

O que o Claude instala

▶

Plugin Codex via claude plugin install

▶

Skill /codex-review em ~/.claude/skills/codex-review/

▶

Projeto de revisão em ~/.codex/automations/project-review/

Como usar a skill

▶

Abra o Claude em qualquer projeto e digite /codex-review

▶

Relatório gerado em ~/.codex/reviews/YYYY-MM-DD-nome.md

▶

OPCIONAL: agendamento diário/semanal — o Claude pergunta se você quer ativar

Etapa 3 de 8 Pendente

Memória Desktop ↔ Terminal

Cria um symlink para que Claude Desktop e Terminal compartilhem exatamente a mesma memória. Sem isso, cada ambiente acumula contexto separado e você perde continuidade entre sessões.

💡 Apenas macOS. Linux: etapa ignorada automaticamente. Windows: Claude mostra o comando PowerShell de admin.

O que acontece

▶

Backup automático da memória Desktop em ~/.zxlab-backup/

▶

Arquivos exclusivos do Desktop migrados para o Terminal

▶

Symlink criado: Desktop memory → Terminal memory

▶

Sincronização em tempo real, zero cron

Etapa 4 de 8 Pendente

Skills e MCPs em Sync

Inicializa um repositório git em ~/.claude/skills/ e configura sync automático a cada 15 minutos. Troca de máquina sem perder skills.

O que o Claude configura

▶

Git init em ~/.claude/skills/

▶

Remote GitHub opcional (para sync entre máquinas)

▶

Agente de sync a cada 15 minutos (LaunchAgent/systemd)

Etapa 5 de 8 Pendente

Graphify — Economia de Tokens + Velocidade

Configura o Graphify para indexar seus projetos como knowledge graphs. Resultado: 60-90% menos tokens em perguntas sobre projetos e Claude mais rápido e inteligente.

Por que Graphify importa

▶

60-90% menos tokens em perguntas sobre seus projetos

▶

Claude mais rápido — contexto já indexado, sem reler arquivos

▶

Claude mais inteligente — entende dependências entre arquivos do projeto

Como funciona

▶

Escolha qual projeto mapear — o Claude executa /graphify

▶

Grafo salvo em ~/.operacao-ia/graphs/ — consultado automaticamente

▶

Para reindexar depois: /graphify no projeto

Etapa 6 de 8 Pendente

Mission Control 2.0

Atualiza o painel de controle com widgets de Codex e Graphify, registra os agentes S4 no Heartbeat e regenera o dashboard HTML com status de todas as 4 semanas.

Patches aplicados automaticamente

▶

zx_daily_dashboard.py — widgets S4: codex_reviews_24h, graphify_graphs

▶

heartbeat.py — 3 agentes Codex monitorados

▶

config-backup.py — ~/.codex/ adicionado ao backup

▶

mission-control/index.html — dashboard com Semanas 1-4

Etapa 7 de 8 Pendente

Auditoria Técnica

Verificação automática de 11 componentes instalados nas Semanas 1-4. Corrige automaticamente o que encontrar e exibe relatório final.

11 checks da auditoria

#	Check
1	Claude Code CLI disponível
2	Plugin Codex instalado
3	Memory symlink Desktop→Terminal
4	Skills git repo inicializado
5	Skills LaunchAgent/systemd ativo
6	Graphify dir com ao menos 1 projeto
7	Codex LaunchAgent diário ativo (se ativado)
8	Codex projects.json configurado
9	config.json phase_completed >= 3
10	Checkpoints S4 etapas 1-8 (done ou skipped)
11	Session logs dir existe

Etapa 8 de 8 Pendente

Finalização da Semana 4

Encerramento oficial da Semana 4. Log de sessão enviado automaticamente e revisão final opcional.

O que acontece na finalização

▶

Coleta dados da sessão e checkpoints concluídos

▶

Pergunta feedback: "O que você gostaria nos próximos Setups?"

▶

Salva log em ~/.operacao-ia/data/logs/session-s4-{timestamp}.json

▶

Envia log para Supabase automaticamente

▶

Revisão final opt-in: /encerrar → Codex → Claude Opus

▶

Atualiza config.json: phase_completed = 4

Aulas Setup 5

Aulas — Setup 5

Assista à gravação da Mentoria com o passo a passo completo do Setup 5 antes de começar. A aula mostra cada clique na criação do app Meta e a configuração das automações de Instagram.

Mentoria — Passo a Passo do Setup 5

O que você vai construir nesta semana

💬

Auto-resposta de comentários — palavras-chave disparam DM automático com link do seu produto

🤖

Agente de DM — treinado nos seus produtos, responde leads no inbox 24h sem você

🔄

Token com refresh automático — renovação silenciosa a cada 50 dias, sem interrupção

📲

Escalação para WhatsApp — lead pede humano → você recebe a conversa direto no seu número

🎛

Mission Control 5.0 — widgets de Instagram no painel de controle

Etapa 1 de 9 Pendente

Boas-vindas + Base

Clone o repositório do Setup 5 e abra o Claude. A partir daí, o Claude conduz todo o setup — você não precisa digitar mais nenhum comando técnico.

Pré-requisitos do Setup 5

✓

Semanas 1 a 4 concluídas — o Setup 5 exige phase_completed >= 4

✓

Conta Instagram Business ou Criador — necessário para acessar a API de comentários e DMs

✓

Claude Code CLI atualizado — claude --version

O único comando que você precisa rodar

terminal — cole e pressione Enter
gh repo clone zxmarketingdigital/ig-autoflow ~/ig-autoflow && \
cd ~/ig-autoflow && \
claude

Claude abre e se apresenta

Aguarde a mensagem de boas-vindas do assistente de Setup. Ele vai listar o que você vai construir nesta semana.

Digite INICIAR SETUP SEMANA 5

escreva no Claude

INICIAR SETUP SEMANA 5

Etapa 2 de 9 Pendente

Configurar App Meta — Instagram API

Cria o app no Meta, adiciona as permissões de mensagens, gera o token de acesso de longa duração (60 dias) e salva as credenciais no seu ambiente. Claude executa smoke tests automáticos para confirmar que a API está funcionando.

💡 Se travar nesta etapa: assista à gravação da aula acima — ela mostra cada clique no dashboard do Meta. Ou use a Meta AI dentro do próprio painel de developers — está treinada com a documentação oficial e responde em tempo real.

O que o Claude faz nesta etapa

Abre o dashboard Meta Developers

Claude abre developers.facebook.com/apps no seu navegador e exibe o passo a passo.

Você cria o app com o caso de uso certo

Na criação, selecione "Gerenciar mensagens e conteúdo no Instagram" — esse caminho pré-configura todas as permissões e o produto Instagram automaticamente.

Adicionar conta como testador

Em App Roles → Instagram Testers, adicione seu usuário e aceite o convite dentro do Instagram. Dispensa App Review — o token funciona mesmo com o app em modo Desenvolvimento.

Gerar token de acesso

Clique no botão "Gere tokens de acesso" → OAuth popup → autorize os 3 escopos → token de 60 dias retorna na tela. Cole no Claude quando pedido.

Claude valida a API automaticamente

Executa 2 smoke tests: verifica que o token está vivo e que consegue listar mídia recente. Qualquer falha → Claude instrui como regerar o token e re-rodar a etapa.

Credenciais salvas automaticamente

▶

~/.operacao-ia/config/instagram.env — App ID, App Secret, User ID, Access Token

▶

Arquivo gitignored — suas credenciais nunca vão para o repositório público

▶

Refresh automático configurado na Etapa 5 — token renova silenciosamente todo dia 03h

Etapa 3 de 9 Pendente

Auto-resposta de Comentários

Você define as palavras-chave que ativam a automação. Para cada uma, o Claude pergunta: qual link enviar, qual mensagem aparecer no comentário público e qual mensagem chegar por DM. Tudo preenchido por você — zero dados hardcoded.

O que você vai configurar

▶

Palavras-chave — você digita quantas quiser, sem limite mínimo ou máximo (ex: "quero", "link", "info")

▶

Para cada palavra-chave: URL/link de destino, resposta pública no comentário e texto da DM (Private Reply)

▶

Cadência configurável — padrão sugerido 30 min, você pode ajustar de 5 a 60 min

O que o Claude instala

▶

ig_auto_responder.py — script de monitoramento de comentários

▶

ig_triggers.json — suas palavras-chave e mensagens

▶

ig_state.json — rastreia IDs já processados para evitar duplicatas

▶

Dry-run automático ao final — processa os últimos 5 posts sem enviar nada, só para validar

Etapa 4 de 9 Pendente

Base de Conhecimento — Seus Produtos

Você cadastra os produtos que o agente vai usar para responder leads no DM. O agente não tem acesso a nenhum produto por padrão — ele só conhece o que você cadastrar aqui.

Loop interativo de cadastro

Quantos produtos quer cadastrar?

Claude pergunta a quantidade — você pode cadastrar 1 ou vários.

Para cada produto, você informa

Nome, URL/link de compra, descrição/diferencial (pode ser múltiplas linhas), preço e bônus opcionais. Se você passar a URL, Claude oferece extrair título e descrição automaticamente — você aprova ou edita.

Preview + confirmação

Claude mostra a base de conhecimento gerada. Você confirma e o arquivo ig_knowledge_base.py é instalado em ~/.operacao-ia/scripts/instagram/.

Etapa 5 de 9 Pendente

Agente de DM + Escalação

Configura o agente que responde DMs do Instagram usando OmniRoute (IA) + seus produtos cadastrados. Quando o lead pede para falar com humano, você recebe a conversa direto no seu WhatsApp via Evolution API.

O que acontece em cada sub-etapa

▶

5a — OmniRoute: Claude verifica se está instalado — se não, oferece instalar automaticamente (clone + pip install)

▶

5b — Modelos de IA: URL do OmniRoute (padrão localhost:8765), modelo principal e fallback — você pode customizar ou usar os padrões

▶

5c — Escalação: URL da Evolution API, nome da instância e o número do seu WhatsApp pessoal — quando o lead disser "quero falar com humano", você recebe

▶

5d — Cadência DM: padrão 2 min, ajustável de 1 a 10 min

▶

5e — LaunchAgents: instala ig-dm, ig-auto e ig-token (refresh diário às 03h)

Etapa 6 de 9 Pendente

Mission Control 5.0

Adiciona os widgets de Instagram ao seu painel de controle. A partir de agora, você monitora comentários processados, DMs respondidas, escalações e dias até o token expirar — tudo na tela principal.

Widgets adicionados ao painel

▶

IG Auto-Responder — último run, quantidade de comentários processados nas últimas 24h, falhas

▶

IG DM Agent — último run, DMs respondidas, escalações enviadas para o seu WhatsApp

▶

IG Token Age — dias restantes até o token expirar — fica vermelho quando chega a menos de 5 dias

▶

Dashboard HTML regenerado e título atualizado para "Mission Control 5.0"

Etapa 7 de 9 Pendente

Auditoria Técnica

Verificação automática de 11 componentes do Setup 5. Claude corrige automaticamente o que encontrar e exibe o relatório final. Se algum check falhar, o auto-fix entra em ação.

11 checks da auditoria

#	Check
1	Claude Code CLI disponível
2	config.json phase_completed >= 4
3	instagram.env presente e lível
4	IG_ACCESS_TOKEN válido (smoke test /me)
5	IG_USER_ID confere com o token
6	Scripts presentes em ~/.operacao-ia/scripts/instagram/
7	OmniRoute respondendo em localhost:8765
8	ig_knowledge_base.py carrega sem erro
9	ig_dm_sessions.sqlite existe
10	LaunchAgents ig-auto e ig-dm carregados
11	LaunchAgent ig-token (refresh diário) carregado

Etapa 8 de 9 Pendente

Teste Prático ao Vivo

Você vai ao seu Instagram, comenta em um post seu usando uma das palavras-chave que cadastrou, e valida que o ciclo completo funciona — reply público + DM chegando. Depois testa o agente de DM respondendo uma mensagem real.

Ciclo 1 — Auto-resposta de comentários

Claude mostra suas palavras-chave ativas

Ele vai listar todas que você cadastrou na Etapa 3 para você escolher qual usar no teste.

Comente em um post seu no Instagram

Vá ao seu Instagram e comente em qualquer post seu usando uma das palavras-chave listadas. Quando feito, volte e escreva OK no terminal.

Claude dispara o cron imediatamente

O script roda agora — não precisa esperar os 30 min do cron. Claude monitora o log até detectar o comentário processado.

Confirme que recebeu

Verifique no Instagram: o reply público no comentário chegou? A DM chegou? Claude pergunta e registra o resultado.

Ciclo 2 — Agente de DM

Responda a DM que chegou

Responda qualquer mensagem sobre um dos seus produtos. Claude dispara o agente imediatamente e você valida a resposta.

Teste a escalação

Envie uma mensagem com "quero falar com humano". O agente deve enviar a transição e você recebe a conversa no seu WhatsApp via Evolution.

Etapa 9 de 9 Pendente

Finalização + Próximos Passos

Encerramento oficial do Setup 5. Log da sessão enviado automaticamente para o Supabase, fase atualizada e convite para quem ainda não conhece o ZX Control completo.

O que acontece na finalização

▶

Coleta dados da sessão e checkpoints concluídos

▶

Pergunta feedback: "O que você gostaria nos próximos Setups?"

▶

Salva log em ~/.operacao-ia/data/logs/session-s5-{timestamp}.json

▶

Envia log para Supabase automaticamente

▶

Atualiza config.json: phase_completed = 5

ZX Control

Operação IA Completa

5 semanas de automações práticas — WhatsApp, prospecção, inteligência e Instagram. Do zero ao sistema rodando.

Conhecer o ZX Control →

Setup 6 Pendente

Aulas — Setup 6

Mentoria gravada com o passo a passo do Setup 6. Mostra a instalação do MCP oficial Meta, o questionário de perfil de campanhas e o uso das 5 skills no dia a dia. Este Setup assume que você já domina tráfego pago.

Mentoria — Passo a Passo do Setup 6

Etapa 1 de 10Pendente

Boas-vindas + Diagnóstico da Base

Verifica pré-requisitos (Setup 5 concluído, Python 3.9+, gh CLI) e cria a estrutura de pastas em ~/.operacao-ia/. Mostra o plano das 10 etapas que virão.

Pré-requisitos do Setup 6

✓

Setup 5 concluído — exige phase_completed >= 5

✓

Conta Meta Business + Ad Account — você precisa ter acesso a uma conta de anúncios ativa

✓

Domínio prévio de Meta ADS — este Setup não ensina tráfego pago, instala a operação técnica

Como começar

No terminal, dentro da pasta do repositório:

git clone https://github.com/zxmarketingdigital/zx-control-trafego-pago
cd zx-control-trafego-pago
claude

No Claude, digite: INICIAR SETUP SEMANA 6. O Claude conduz o resto.

Etapa 2 de 10Pendente

Conectar MCP Oficial do Meta (OAuth)

Autenticação OAuth com o servidor MCP oficial do Meta — única fonte de verdade para criar campanhas, ler insights e ajustar budget. Permissões: ads_management e business_management.

▶

Claude chama mcp__meta-official__authenticate

▶

Você abre a URL retornada e autoriza no Facebook

▶

Claude valida com ads_get_ad_accounts — lista suas contas

▶

Você escolhe a conta — gravada em ~/.operacao-ia/config/meta.env

Etapa 3 de 10Pendente

Questionário: Perfil de Campanhas

Esta é a peça-chave do Setup. Você define quais objetivos roda, quais KPIs usa, quais são suas metas numéricas e como quer que o decide() funcione. Tudo o que vem depois (fetcher, dashboard, analyzer, optimizer) lê esse perfil e se adapta.

O que o questionário pergunta

▶

Objetivos de campanha — Lead, WhatsApp, Mensagens, Vendas, Alcance, Tráfego, App

▶

KPIs-chave — CPL, CPA, ROAS, Custo/Msg, CPM, CTR, CPC, Frequência, Custo/Install

▶

Metas numéricas — para cada KPI selecionado (ex: CPL ≤ R$25, ROAS ≥ 2.0)

▶

Estratégia decide() — quando matar/manter/escalar (defaults inteligentes ou customizado)

▶

KPI primário — qual decide primeiro em caso de conflito

▶

Janelas de análise — default 4d/7d/14d/30d

Salva tudo em ~/.operacao-ia/config/meta_perfil.json

Etapa 4 de 10Pendente

Instalar Skills + Agente Orquestrador

6 skills copiadas para ~/.claude/skills/ — disponíveis a partir de qualquer chat do Claude Code.

Skills instaladas

🤖

/agente-trafego-pago — orquestrador com menu numérico

🚀

/meta-campaign-launcher — cria campanha em DRAFT (PAUSED)

🎨

/meta-creative-brief — gera briefing de criativo (3 hooks copy + 3 visuais + CTA + specs)

📡

/meta-metrics-fetcher — coleta métricas conforme perfil do aluno

📊

/meta-performance-analyzer — análise com decide() personalizado

💰

/meta-budget-optimizer — plano de realocação de budget

Etapa 5 de 10Pendente

Primeira Coleta de Métricas

Roda meta-metrics-fetcher pela primeira vez. Valida o MCP, lê seu perfil e gera os JSONs do dashboard para todas as janelas escolhidas.

O que é gerado

▶

Um JSON por janela (4d/7d/14d/30d) em ~/.operacao-ia/dashboards/

▶

Schema dinâmico — apenas os KPIs do seu perfil (sem campos hardcoded)

▶

Cada anúncio recebe veredito decide() (KEEP/KILL/SCALE) conforme seus limiares

▶

Cards de KPI agregados (verde/amarelo/vermelho vs metas)

Etapa 6 de 10Pendente

Dashboard Local em localhost:8888

Server HTTP local renderiza seu dashboard de tráfego pago — só com as métricas que você escolheu, comparadas com as metas que você definiu.

Recursos do dashboard

📊

Cards de KPI no topo (verde/amarelo/vermelho vs metas)

📅

Tabs por janela (4d/7d/14d/30d)

🔍

Drill-down conta → campanha → ad set → anúncio

🏷

Badge SCALE/KILL/KEEP em cada anúncio

Etapa 7 de 10Pendente

Criar Primeira Campanha (DRAFT) + Briefing

Validação prática: usar a skill /meta-campaign-launcher para criar uma campanha em DRAFT (PAUSED — não gasta nada) e a skill /meta-creative-brief para gerar um briefing de anúncio.

▶

Você descreve em linguagem natural: objetivo, orçamento, audiência, criativo

▶

Skill cria via ads_create_campaign + ads_create_ad_set + ads_create_ad

▶

Status PAUSED — você revisa no Ads Manager antes de publicar manualmente

▶

Briefing markdown com 3 hooks copy + 3 visuais + CTA + specs por placement

Etapa 8 de 10Pendente

Análise de Performance + Plano de Budget

Skills /meta-performance-analyzer e /meta-budget-optimizer rodam em sequência usando seu perfil.

📊

Análise: top 3 SCALE, top 3 KILL, top KEEP-monitorar — com diff vs metas

💰

Plano de budget: realocação por campanha + comandos prontos para colar

⚖️

Guard-rails: máximo +50% por campanha (evita choque), mínimo R$10/dia

Etapa 9 de 10Pendente

Automação (LaunchAgents) + Server Persistente

Instala 2 jobs do macOS: fetch automático 3x/dia (8h/13h/19h BRT) + dashboard server keep-alive em localhost:8888.

⏰

com.zxlab.meta-fetch — StartCalendarInterval 8h05/13h05/19h05

🌐

com.zxlab.meta-dashboard-server — KeepAlive=true em :8888

▶

launchctl load nos 2 plists — validar com launchctl list | grep zxlab.meta

Etapa 10 de 10Pendente

Auditoria Técnica + Finalização

12 checks automáticos validam tudo o que foi instalado. Após o OK, finalização marca phase_completed = 6 e exibe a mensagem final + CTA do ZX Control.

12 checks da auditoria

▶

Pré-requisito Setup 5 + Python 3.9+ + meta.env preenchido

▶

Perfil de campanhas + 6 skills instaladas

▶

Scripts core copiados (fetch_metrics + paid_traffic_dashboard)

▶

Dashboards JSON + HTML gerados

▶

LaunchAgents instalados e ativos

▶

Server localhost:8888 respondendo

ZX Control

Mentoria Completa

Você acabou de plugar tráfego pago direto no Claude Code. Conheça o ZX Control completo — 6 setups + mentoria semanal.

Conhecer o ZX Control →

▶ Aulas

Aulas — Setup 7

Assista à MasterClass completa apresentando o Social Media Agent antes de instalar.

MasterClass — Social Media Agent

🎬

Reels e Shorts animados em MP4

🖼️

Carrosséis Instagram e LinkedIn

🎯

Thumbnails YouTube em 3 variantes

♻️

Repurposing de live em 1 comando

🎨

Design System da sua marca

📊

Dashboard local com galeria

Etapa 1 de 8 Pendente

Diagnóstico + Estrutura

Valida tudo que o pipeline de criação de conteúdo precisa pra rodar 100% local e cria a árvore de pastas em ~/.operacao-ia/data/social-media/. Bloqueia em itens críticos, avisa nos opcionais.

🎥 Aula da Etapa 1 — Diagnóstico

Bloqueantes (sem isso o setup para)

▶

Python 3.10+ — base do setup e dos scripts auxiliares

▶

gh CLI autenticado — pra clonar o repo do video-use na Etapa 4

▶

Claude Code CLI — você está nele agora, mas o setup confirma o binário

Opcionais (geram aviso, não bloqueiam)

⚠️

ffmpeg — necessário pra repurpose (cortar lives) e criar reel (encodar MP4)

⚠️

Chrome / Chromium + Bun — render de Reels via puppeteer-core headless

⚠️

Codex CLI logado em ChatGPT — desbloqueia gpt-image-2 (melhor tipografia). Sem ele, cai automático em Gemini Nano Banana

ℹ️

Higgsfield MCP — só fallback opcional de imagens. Plano grátis cobre.

O único comando que você precisa rodar

terminal — cole e pressione Enter
gh repo clone zxmarketingdigital/social-media-agent ~/social-media-agent && \
cd ~/social-media-agent && \
claude

Claude abre e se apresenta

Aguarde a mensagem de boas-vindas do assistente do Setup 7 — ele vai listar o que você vai construir nesta semana.

Digite INICIAR SETUP SEMANA 7

escreva no Claude

INICIAR SETUP SEMANA 7

Estrutura criada

~/.operacao-ia/data/social-media/output/{reels,carrosseis,thumbs,stories,repurpose,demo}/ + pastas config/, tools/, logs/.

Etapa 2 de 8 Pendente

Identidade da Marca

Esta é a fundação de todas as skills do Setup. O Claude coleta os dados da sua marca em modo conversacional (você responde no chat) e grava em ~/.operacao-ia/config/marca.json. Cada skill — Reel, Carrossel, Thumb, Copy — lê esse arquivo antes de gerar qualquer coisa, garantindo voz consistente.

🎥 Aula da Etapa 2 — Identidade da Marca

🎥 Bônus — Como instalar pra múltiplos clientes

O que o Claude pergunta

▶

Nome da marca — ex: "Rafael Castro", "ZX LAB"

▶

Nicho em 3-5 palavras — ex: "IA aplicada a marketing"

▶

Persona em 3 frases — quem você é, o que ensina, pra quem

▶

Público-alvo — ex: "empreendedores digitais 25-45 que querem escalar"

▶

Tom de voz — 1 entre 5: profissional · acessível · provocador · inspirador · divertido

▶

Handles de Instagram, YouTube, TikTok, LinkedIn (opcionais)

Se já existe um marca.json de uma rodada anterior, cada campo aparece preenchido e Enter mantém o valor — você edita só o que mudou.

Etapa 3 de 8 Pendente

Design System

Define cores, tipografia, espaçamento e estilo visual da sua marca. Cada skill que renderiza algo visual (Reel, Carrossel, Thumb, Stories) lê o DESIGN.md antes de gerar — garante que tudo que sair tem a mesma identidade.

🎥 Aula da Etapa 3 — Design System

3 templates prontos + opção custom

🌑

dark-mono — minimalista escuro, mono-fonte (JetBrains Mono). Tech, finance, B2B sério

📖

light-editorial — claro com serif elegante (Playfair Display + Inter). Lifestyle, wellness, educação

🎨

vivid-pop — colorido vibrante, alto contraste. Entretenimento, food, fitness, criadores teen

✨

custom — descreve cor primária, estilo (brutalista, retrô, etc) e 2-3 referências; o Claude escreve um DESIGN.md sob medida

O que entra no DESIGN.md

Cores (paleta hex + tokens), Tipografia (família + pesos + tamanhos), Espaçamento (escala 4px), Estilo visual (bordas, cantos, hover), Componentes-padrão e prompts prontos pra gerar-imagem manter coerência.

📁 Salvo em ~/.operacao-ia/data/social-media/DESIGN.md — pode editar manualmente depois.

🆕 Design Showcase — aprovação visual

Antes de avançar, o Claude gera um HTML showcase da sua marca (paleta + tipografia + 4 slides de carrossel + 2 reels + thumb YouTube + componentes + do's & don'ts) e abre no browser. Você vê de verdade como a identidade visual vai se materializar antes de produzir conteúdo.

🎨

Mockups reais — carrossel 5/5, reel hook + pontos, thumb YouTube 1280×720 — todos com as cores e fontes do seu DESIGN.md

📐

Tokens visíveis — paleta com hex codes + hierarquia tipográfica (display, headline, body, label, metric)

✅

Aprovação em 3 opções — s avança · n volta ao menu · ajustar descreve mudanças e regenera

📁 Salvo em ~/.operacao-ia/data/social-media/design-showcase.html — pode reabrir depois pra conferir.

Etapa 4 de 8 Pendente

Transcrição — ElevenLabs + Whisper

Setup do motor de transcrição que a skill repurpose-conteudo usa pra transformar lives de 1h em pacotes multi-plataforma. Modelo híbrido: ElevenLabs Scribe quando disponível (rápido), Whisper local sempre como fallback (offline, grátis).

🎥 Aula da Etapa 4 — Transcrição

🎥 Bônus — Edição de vídeo via IA (video-use)

Estratégia híbrida

⚡

ElevenLabs Scribe — provedor preferencial, ~5-10x mais rápido. Cadastro grátis em elevenlabs.io/app/sign-up. Setup valida a chave online antes de salvar em ~/.operacao-ia/config/elevenlabs.env (chmod 600)

💾

Whisper local — fallback offline 100% grátis. O setup clona browser-use/video-use, cria venv e instala faster-whisper + dependências em ~/.operacao-ia/tools/video-use/

🧪

Smoke test — testa import faster_whisper ao final. Aborta a etapa se nenhum dos dois ficar pronto (evita descobrir o erro às 23h)

Comportamento em produção

A skill repurpose-conteudo tenta ElevenLabs primeiro; se a chave estiver inválida, sem internet ou cota esgotada, cai automaticamente no Whisper local — sem você precisar fazer nada. Primeira transcrição Whisper baixa o modelo (~500MB) e leva ~3-5x o tempo do áudio em Mac Intel.

Etapa 5 de 8 Pendente

Instalar 8 Skills

Copia as 8 skills do repo pra ~/.claude/skills/ — ficam disponíveis em qualquer sessão Claude Code, em qualquer pasta. 6 são especialistas em criação, 2 são helpers de baixo nível que as outras chamam internamente.

🎥 Aula da Etapa 5 — Instalar 8 Skills

🤖 agente-social-media — Orquestrador

O que faz: menu numérico que roteia entre todas as outras skills. Ponto de entrada quando você não sabe qual usar.

Quando usar: não sabe por onde começar, quer ver opções, prefere navegar por menu.

Exemplo: agente social

🎬 criar-reel — Especialista

O que faz: gera Reel/Short/TikTok 9:16 animado em MP4. Claude escreve hook+corpo+CTA lendo marca.json/DESIGN.md, renderiza local via gerar-video-mp4 (Chrome headless + ffmpeg). Sem plano pago.

Quando usar: quer publicar vídeo curto vertical (Instagram Reels, TikTok, YouTube Shorts).

Exemplo: criar reel sobre [tópico]

🖼️ gerar-carrossel — Especialista

O que faz: 5-10 slides para Instagram (PNG) ou LinkedIn (PDF). Claude escreve copy de cada slide, gerar-imagem produz a arte (gpt-image-2 → Gemini → Imagen).

Quando usar: quer post educativo, framework, antes/depois, ou conteúdo carrossel.

Exemplo: gerar carrossel 7 slides sobre [tema] para linkedin

🎯 criar-thumbnail — Especialista

O que faz: 3 variantes A/B/C de thumbnail YouTube 1280×720 (rosto+texto, conceitual, antes-depois) via gerar-imagem.

Quando usar: acabou de gravar um vídeo longo e precisa de thumb pra subir.

Exemplo: thumb yt: [título do vídeo]

♻️ repurpose-conteudo — Especialista (orquestra outras)

O que faz: pega 1 vídeo longo (live/podcast/masterclass) e devolve pacote multi-plataforma: 1 corte YouTube 8-15min + 3 Shorts/Reels + 1 carrossel + copys. Transcrição ElevenLabs (preferred) ou Whisper local (fallback).

Quando usar: tem uma live de 1h e quer extrair conteúdo pra semana inteira em 1 comando.

Exemplo: repurpose ~/Downloads/live.mp4

✍️ gerar-copy-post — Especialista

O que faz: legenda + hashtags + CTA prontos pra colar no app. Adapta tom/formato por plataforma (Instagram, TikTok, YouTube, LinkedIn). Lê marca.json pra manter voz.

Quando usar: já tem o conteúdo (foto/vídeo) e só precisa da legenda pra postar.

Exemplo: gerar copy post instagram sobre [tema]

— 2 helpers (chamadas pelas de cima, raramente uso direto) —

🎨 gerar-imagem — Helper

O que faz: gateway de geração de imagem com fallback automático: gpt-image-2 (Codex CLI logado em ChatGPT) → Gemini Nano Banana → Higgsfield (opcional) → Imagen 4. Carrossel/thumb chamam essa internamente.

Quando usar: quer 1 imagem solta pra qualquer uso (post avulso, banner, capa).

Exemplo: gerar imagem [descrição]

📹 gerar-video-mp4 — Helper

O que faz: pipeline HTML animado → Chrome headless (Bun/puppeteer-core) → ffmpeg → MP4 vertical/horizontal. Mesma engine dos anúncios ZX LAB. criar-reel chama internamente.

Quando usar: quer animação custom além do que criar-reel oferece (ex: hero animado pra LP).

Exemplo: gerar video mp4 de [descrição]

Modo idempotente

Skills idênticas são puladas. Versões customizadas localmente recebem backup em .s7-backup-{slug}-{timestamp}/ antes da atualização — você nunca perde edit local.

Etapa 6 de 8 Pendente

Dashboard Local

Gera ~/.operacao-ia/data/social-media/dashboard.html — sua central operacional offline com calendário editorial, comandos rápidos e galeria do que você produziu. Abre no browser direto via file://, sem servidor.

🎥 Aula da Etapa 6 — Dashboard Local

Calendário editorial cadência 3-2-1

📅

3 Reels/semana (Seg hook · Qua bastidor · Sex prova social)

📅

2 Carrosséis (Ter framework · Dom resumo)

📅

1 Longo (Sáb YouTube 8-15min ou live)

📅

+ Stories diários (Qui dedicada a enquete + dica + CTA)

Galeria automática

Cada skill faz append em gallery.json com tipo, título, plataforma e path. O dashboard carrega via fetch e mostra os itens mais recentes primeiro — você acompanha tudo que produziu num lugar só.

Comandos rápidos integrados

Cards prontos pra copiar com os 6 atalhos principais: criar reel, gerar carrossel, thumb yt, repurpose, gerar copy post, agente social.

Etapa 7 de 8 Pendente

Demo: Briefing → Carrossel + Reel MP4

Validação end-to-end com geração real, mas guiada pelo seu briefing — não é um "apresentando a marca" genérico. O Claude pergunta o objetivo, tema, produto, CTA e estilo de copy ANTES de gerar, e você aprova o briefing antes que qualquer coisa seja renderizada.

🎥 Aula da Etapa 7 — Demo: Carrossel + Reel

📋 Fase 1 — Briefing (7 perguntas)

Antes de invocar qualquer skill, o Claude faz UMA pergunta por vez:

Objetivo da demo — o que precisa provar/comunicar (lançamento, framework, autoridade, lead, prova social)

Tema/ângulo do carrossel — tópico, dor ou framework específico do seu nicho

Tema/hook do Reel — mesmo do carrossel (comprimido) ou ângulo diferente

Produto/serviço em foco — promove algo específico ou é topo de funil sem oferta?

CTA preferido — "salva e segue" · "comenta INFO" · "link na bio" · "agenda call" · "baixa material"

Estilo de copy — didático · storytelling · provocador · vendedor · case real (default = tom da marca em marca.json)

Referências (opcional) — 1-3 criadores que fazem conteúdo parecido pra calibrar ritmo

Se você disser "tanto faz" → o Claude propõe 2-3 ângulos plausíveis pro seu nicho e deixa você escolher 1. Ele nunca decide sozinho.

✅ Fase 2 — Aprovação do briefing

Antes de gerar, o Claude consolida e pergunta: Pode gerar? (s/n/ajustar).

aprova e dispara as 2 skills

refaz as perguntas do zero

ajustar

você descreve o que mudar, ele atualiza o briefing e repergunta

🎨 Fase 3 — Geração (só após "s")

🖼️

Carrossel 5 slides (capa · problema · 3 pontos · CTA) via gerar-carrossel → gerar-imagem (gpt-image-2 → Gemini → Imagen) respeitando o DESIGN.md. Output: output/demo/carrossel-<slug>/

🎬

Reel 30s 9:16 via criar-reel → gerar-video-mp4 (HTML animado → Chrome headless → ffmpeg → MP4). Output: output/demo/reel-<slug>.mp4

Ambos viram entrada no gallery.json automaticamente pra aparecer no dashboard.

Tratamento de erro

Se faltar Chrome/Bun/ffmpeg, a Etapa 1 já avisou — só rerodar após instalar. Carrossel falha em todos providers → codex login ou criar ~/.operacao-ia/config/gemini.env.

Etapa 8 de 8 Pendente

Finalização

Marca o Setup como concluído (phase_completed=7), abre o dashboard local no browser e mostra o playbook semanal — daqui em diante você só usa os comandos.

🎥 Aula da Etapa 8 — Finalização

Seus 6 comandos prontos

🎬

criar reel sobre [tópico] — Reel/Short 9:16 animado em MP4

🖼️

gerar carrossel 7 slides sobre [tema] para linkedin

🎯

thumb yt: [título] — 3 variantes 1280×720

✍️

gerar copy post [plataforma] sobre [tema]

♻️

repurpose [caminho do vídeo] — live → pacote multi-plataforma

🤖

agente social — menu com todas as opções

Outputs ficam em

~/.operacao-ia/data/social-media/output/{reels,carrosseis,thumbs,stories,repurpose}/

Pra ajustar visual depois

Edite ~/.operacao-ia/data/social-media/DESIGN.md e ~/.operacao-ia/config/marca.json a qualquer momento — todas as skills recarregam na próxima execução.

▶ Aulas

Aulas — Setup 8

Assista à MasterClass completa apresentando os agentes de vendas (ZX Growth) + ferramenta de captação (ZX Lead Machine) antes de instalar.

MasterClass — Agentes de Vendas + Captura de Leads (ZX Growth + ZX Lead Machine)

🩺

Diagnóstico Empreendedor

📞

Análise de Call

⚡

Prototipar Sistema

🎯

Simulador de Vendas

💰

Criar Orçamento

🎯

Lead Machine Lite

Etapa 1 de 5 Pendente

Instalar 5 Skills + Diagnóstico Empreendedor

Clona o repo do Setup 8, abre o Claude Code dentro dele e dispara bash install.sh --bloco-a que copia as 5 skills (/diagnostico-empreendedor, /analise-call, /prototipar-sistema, /simulador-vendas, /criar-orcamento) pra ~/.claude/skills/. Depois você faz o primeiro diagnóstico do seu negócio em 10 perguntas.

🎥 Aula da Etapa 1 — Instalação e primeiro diagnóstico

Bloqueantes (sem isso o setup para)

▶

Python 3.10+ — base do setup/check_prerequisites.py e do Lead Machine Lite (Etapa 5)

▶

gh CLI autenticado — pra clonar o repo público do Setup 8

▶

Claude Code CLI — você está nele agora, mas o check confirma o binário

▶

Setup 7 concluído (phase_completed ≥ 7 em ~/.operacao-ia/config/config.json)

Opcionais (Lead Machine — Etapa 5)

⚠️

cloudflared — tunnel pra LP pública do Lead Machine (install.sh instala via brew install cloudflare/cloudflare/cloudflared)

⚠️

ANTHROPIC_API_KEY — gere em console.anthropic.com antes da Etapa 5 (Lead Machine usa fora do Claude Code)

O único comando que você precisa rodar

terminal — cole e pressione Enter
gh repo clone zxmarketingdigital/zx-control-setup8-skills-agencia ~/zx-control-setup8 && \
cd ~/zx-control-setup8 && \
claude

Claude abre e se apresenta

Aguarde a mensagem de boas-vindas do Claude do Setup 8 — ele lista o que você vai instalar nesta semana.

Digite INICIAR SETUP SEMANA 8

escreva no Claude

INICIAR SETUP SEMANA 8

O Claude executa python3 setup/check_prerequisites.py + bash install.sh --bloco-a sequencialmente.

Rode o primeiro diagnóstico

Quando o Claude confirmar "5 skills instaladas", digite /diagnostico-empreendedor e responda as 10 perguntas — você recebe o perfil de agência + plano de ação 30 dias.

Estrutura criada

~/.claude/skills/{diagnostico-empreendedor,analise-call,prototipar-sistema,simulador-vendas,criar-orcamento}/ · clone do repo em ~/zx-control-setup8/ · base de dados em ~/.operacao-ia/{config,scripts,leads}/.

Etapa 2 de 5 Pendente

Analisar Sua Primeira Call de Vendas

Usa a skill /analise-call (já instalada na Etapa 1) pra analisar uma reunião comercial. Identifica objeções perdidas, gatilhos não usados, próximos passos sugeridos + script de follow-up — em segundos.

🎥 Aula da Etapa 2 — Análise de call

Como usar (no Claude já aberto em ~/zx-control-setup8)

Digite /analise-call — Claude pede a transcrição

Cole a transcrição da call (ou pra Zoom: ~/Library/Application Support/zoom.us/data/MEETING_ID/cc.transcript)

Receba relatório com objeções 🔴, gatilhos perdidos 🟡 e próximos passos 🟢

Use o script de follow-up sugerido pra mandar via WhatsApp/email

Exemplo de invocação

no Claude Code

/analise-call

Output esperado em

~/.operacao-ia/data/calls/<data>-analise.md — relatório estruturado por seções (objeções, gatilhos, follow-up).

Etapa 3 de 5 Pendente

Prototipar Sistema pro Seu Cliente

Usa /prototipar-sistema (já instalada) pra gerar brief estruturado de protótipo (problema → solução → stack → fluxos → entregáveis → cronograma) + protótipo HTML interativo via Huashu-Design. Mostra pro cliente antes de fechar.

🎥 Aula da Etapa 3 — Protótipo + HTML interativo

Como usar

Digite /prototipar-sistema — Claude pergunta tipo de sistema (LP, app, agente IA, dashboard)

Informe nicho do cliente + problema + budget + prazo

Claude gera brief MD + invoca Huashu-Design pra renderizar HTML hi-fi navegável

Abra o HTML no browser e mande pro cliente (ou hospede em CF Pages via /pages-deploy)

Exemplo

no Claude Code

/prototipar-sistema agente IA pra clínica de odontologia que responde WhatsApp 24/7

Output esperado em

~/.operacao-ia/data/prototipos/<slug>/ — pasta com brief.md, index.html e assets do mockup.

Etapa 4 de 5 Pendente

Treinar Objeções Antes da Call Real

Usa /simulador-vendas pra simular lead difícil no chat (perfil derivado de 6 campos: objetivo, segmento, persona, orçamento, urgência, decisor + nível de difficulty). Você pratica abordagem e fechamento, recebe feedback + plano de melhoria ao final.

🎥 Aula da Etapa 4 — Simulador de vendas

Como usar

Digite /simulador-vendas ou /simulador-vendas --focus orcamento (foco em objeção de preço)

Defina perfil do lead (objetivo + segmento + persona + orçamento + urgência + decisor + difficulty 1-5)

Pratique a call no chat — Claude simula respostas realistas do lead

Ao final, receba transcrição + análise + plano de melhoria estruturado

Flags úteis

no Claude Code
/simulador-vendas --focus orcamento   # foca em objeção de preço
/simulador-vendas --focus fechamento  # foca em quebrar urgência
/simulador-vendas --focus decisor     # foca em mapear comitê de compra

Output esperado em

~/.operacao-ia/data/simulador/<data>-<perfil>.md — transcrição + análise + plano de melhoria.

Etapa 5 de 5 Pendente

Criar Orçamento + Instalar Lead Machine Lite

Usa /criar-orcamento pra gerar proposta comercial (MD + PDF, recorrência no header, ROI por nicho) e instala o Lead Machine Lite — LP pública + dashboard + tunnel cloudflared, tudo no seu Mac.

🎥 Aula da Etapa 5 — Orçamento + Lead Machine

Parte 1 — Gerar orçamento

Digite /criar-orcamento — Claude pergunta cliente + escopo + valor + recorrência

Receba MD + PDF prontos pra enviar no WhatsApp/email do cliente

Parte 2 — Instalar Lead Machine Lite (no Claude aberto em ~/zx-control-setup8)

Diga ao Claude: "instala o Lead Machine Lite" — ele roda bash lead-machine-lite/launchagent/install.sh

Cole sua ANTHROPIC_API_KEY quando pedido (vai pra ~/zx-control-setup8/.env — local, nunca commit)

Aguarde tunnel cloudflared subir — você recebe URL pública (ex: https://leads-<random>.trycloudflare.com)

Compartilhe a URL nas suas redes — leads preenchem o diagnóstico e caem no dashboard local

Comandos pós-instalação

terminal
bash ~/zx-control-setup8/lead-machine-lite/launchagent/status.sh   # ver status
bash ~/zx-control-setup8/lead-machine-lite/launchagent/restart.sh  # reiniciar tunnel

Estrutura criada

Orçamentos em ~/.operacao-ia/data/orcamentos/<cliente>.{md,pdf} · Lead Machine em ~/.operacao-ia/leads/leads.db + dashboard local em http://localhost:8XXX · LaunchAgents com.zxlab.lead-machine-lite.plist + .tunnel.plist.

Módulo 1 · Aula 1 Pendente

Automatização com Claude Cowork

Como o Claude Cowork ajuda a paralelizar tarefas e organizar projetos sem fricção.

Aula em vídeo

Módulo 1 · Aula 2 Pendente

Sistema de Prospecção com Claude Code

Construa um pipeline de prospecção automatizado usando Claude Code do zero.

Aula em vídeo

Módulo 1 · Aula 3 Pendente

Boas práticas para sistemas e agentes de IA

Padrões fundamentais para criar sistemas e agentes confiáveis com Claude Code.

Aula em vídeo

Módulo 1 · Aula 4 Pendente

Cases de apps e dashboards

Cases reais de aplicativos e dashboards construídos com Claude Code.

Aula em vídeo

Módulo 1 · Aula 5 Pendente

Como usar Claude para criar dashboards e aplicativos

Passo a passo para construir dashboards funcionais e apps com Claude.

Aula em vídeo

Módulo 1 · Aula 6 Pendente

Reduza custos de tokens em até 90%

Estratégias práticas para diminuir consumo de tokens sem perder qualidade.

Aula em vídeo

Módulo 1 · Aula 7 Pendente

Sistema de proteção e otimização de memória

Como organizar memória do Claude Code para sessões longas e estáveis.

Aula em vídeo

Mapa Mental da Aula (Whimsical)

Módulo 2 · Aula 1 Pendente

Automação com Claude Code e novidades de IA

Visão geral de automações + atualizações recentes do ecossistema de IA.

Aula em vídeo

Módulo 2 · Aula 2 Pendente

Mission Control: sistema de automação na sua operação

Arquitetura do Mission Control e como rodar sua operação em modo automático.

Aula em vídeo

Módulo 2 · Aula 3 Pendente

Boas práticas (revisão masterclass)

Revisão das boas práticas em formato MasterClass — reforço dos fundamentos.

Aula em vídeo

Módulo 2 · Aula 4 Pendente

Sessão especial Semana Santa: novidades de IA

Sessão especial cobrindo novidades de modelos e ferramentas de IA.

Aula em vídeo

Módulo 2 · Aula 5 Pendente

Claude vs Codex e modelos chineses

Comparativo entre Claude Code, Codex e modelos abertos chineses; otimização de tokens.

Aula em vídeo

▶ Aulas

Aulas — Setup 9

MasterClass completa apresentando LP Builder Profissional + Mini CRM + Chat IA. 6 cortes pra você navegar conforme precisar — recomendo assistir o corte 1 (visão geral) antes de começar e os outros conforme avançar nas etapas.

📚 Repositório público do Setup 9

github.com/zxmarketingdigital/zx-control-setup9-lp-builder-cro ↗

🎬 Corte 1 — Hook + visão geral 9min

🎬 Corte 2 — Demo: briefing → DS → LP → Cloudflare 28min

🎬 Corte 3 — Chat IA + publicação 12min

🎬 Corte 4 — Skill revisão + dry run 21min

🎬 Corte 5 — Cota Gemini + fixes + Q&A 20min

🎬 Corte 6 — Performance + fechamento 12min

Etapa 1 de 8 Pendente

Briefing do cliente

Coleta nicho, oferta, persona, dores, objeções, CTA (modo rápido 5 nichos ou profundo 10 perguntas + autosave).

📚 Repositório público do Setup 9

github.com/zxmarketingdigital/zx-control-setup9-lp-builder-cro ↗

O único comando que você precisa rodar

terminal — cole e pressione Enter
gh repo clone zxmarketingdigital/zx-control-setup9-lp-builder-cro ~/zx-control-setup9 && \
cd ~/zx-control-setup9 && \
claude

Bloqueantes (sem isso o setup para)

▶

Python 3.10+ — base do setup/check_prerequisites.py

▶

Node 18+ ou Bun — build LP estática + Worker

▶

gh CLI autenticado — clonar o repo público

▶

Claude Code CLI — você está nele agora

Opcionais (etapas 5 e 7)

⚠️

Conta Cloudflare grátis — etapa 5 (LP + Worker + D1). Pode pular com --local-only e migrar depois.

⚠️

Gemini API key grátis — etapa 7. Gere em aistudio.google.com → Get API key

⚠️

Claude API key (opcional) — etapa 7. SETE spend limit antes em console.anthropic.com

Como rodar

terminal — pressione Enter no Claude

python3 setup/setup_briefing.py

Escolha o modo

Modo rápido (5 nichos pré-fab) ou profundo (10 perguntas) — recomendo rápido na primeira vez.

Responda o briefing

Nicho, oferta, persona, dores — ou escolha um nicho pronto e ajuste depois.

Confirme briefing.md

Arquivo gerado vira base do design system (etapa 2) e da copy (etapa 3).

Etapa 2 de 8 Pendente

Design System

Cores + tipografia + espaçamento (5 arquétipos pré-fab ou criar do zero via skills locais).

Como rodar

terminal — pressione Enter no Claude

python3 setup/setup_design_system.py

Escolha arquétipo ou crie do zero

5 prontos: B2B SaaS clean, Infoproduto bold, Agência criativa, E-commerce, Serviço local.

Pra criar do zero, use skills locais

/huashu-design ou /design-md — ambas já instaladas no repo.

Confirme styles.css gerado

Saída com CSS vars (cor, fonte, espaçamento) pronta pra etapa 4 consumir.

Etapa 3 de 8 Pendente

Copy alta conversão

Hero, features, objeções, FAQ, CTA escritos pelo Claude (PAS/AIDA/BAB).

Como rodar

terminal — pressione Enter no Claude

python3 setup/setup_copy.py

Escolha framework

PAS, AIDA (recomendado pra agência) ou BAB — o script explica a diferença.

Cole referência ou deixa gerar do zero

Se tiver copy de campanha que funcionou, cole. Senão, Claude escreve baseado no briefing.

Lint avisa palavras técnicas demais

Ajuste pra mensagem de benefício, não feature — ferramenta sinaliza o que reescrever.

Etapa 4 de 8 Pendente

LP build

Gera HTML/Vite estático com cores+copy do briefing.

Como rodar

terminal — pressione Enter no Claude

python3 setup/setup_lp_build.py

Informe 1+ domínio em allowed_origins[]

Por enquanto pode ser localhost — depois adiciona o do cliente.

Script roda bun install + bun run build

npm é fallback automático se bun não estiver instalado.

Preview localhost abre no browser

Confira visual antes de seguir pra etapa 5 (Cloudflare).

Etapa 5 de 8 Pendente

Cloudflare setup (ou --local-only)

Como rodar

terminal — pressione Enter no Claude
python3 setup/setup_cloudflare.py
# ou modo offline:
python3 setup/setup_cloudflare.py --local-only

Modo full: wrangler login abre browser

Script cria D1 database + Worker + secrets automaticamente.

Modo --local-only

Pula Cloudflare, usa SQLite local + chat IA direto do front (ideal pra testar antes de pagar domínio).

Smoke GET /health retorna 200

Worker live confirmado — pode ir pra etapa 6.

Etapa 6 de 8 Pendente

Mini CRM

Rota /crm da LP listando leads do cliente.

Como rodar

terminal — pressione Enter no Claude

python3 setup/setup_minicrm.py

Script grava worker_url + lp_token

Gravado em lp-config.json (gitignored) — só você tem acesso.

CRM em /crm.html da própria LP

Sem app separado, sem login extra — protegido por token.

Smoke GET /leads autenticado mostra count zero

Ainda sem leads — vai encher quando LP for ao ar na etapa 8.

Etapa 7 de 8 Pendente

Chat IA

Configura provider (Gemini grátis ou Claude SDK) + streaming SSE + auto-fallback.

Como rodar

terminal — pressione Enter no Claude

python3 setup/setup_chat_ia.py

Escolha Gemini grátis ou Claude SDK

Recomendado: Gemini (cota generosa). Claude é pago e exige spend limit setado antes.

Pra Claude, SETE spend limit antes

Em console.anthropic.com → Settings → Spend limits. Script confirma antes de salvar.

Smoke POST /chat-ia com streaming SSE

Retorna chunks ao vivo — chat IA respondendo na LP.

Etapa 8 de 8 Pendente

Deploy + métricas

Cloudflare Pages + Web Analytics + UTM tracking + smoke E2E.

Como rodar

terminal — pressione Enter no Claude

python3 setup/setup_deploy.py

Ativar Cloudflare Web Analytics (opcional)

Instruções no script — privacy-first, sem cookie, grátis.

wrangler pages deploy publica em *.pages.dev

URL definitiva (custom domain pode ser configurado depois no painel CF).

Smoke E2E final

curl LP retorna 200 + CORS OPTIONS OK. Banner final mostra todas as URLs.

▶ Aulas

Aulas — Setup 10

Apresentação completa do Clínica Automatizada: os 5 agentes, como o produto funciona e como você instala pra um cliente e cobra por isso. Assista antes de começar — depois é só seguir as 5 etapas.

🎬 Apresentação — Clínica Automatizada (5 Agentes IA)

🩺 Demo ao vivo — explore o produto pronto

clinica-cheia-zxlab.pages.dev ↗

Painel de demonstração com agenda, clientes e mensagens dos 5 agentes já populados. Login:
clinica-teste@zxlab.com.br · senha ClinicaZX@2026

📦 Onde fica o produto

O produto é exclusivo do ZX Control 4.0 Launch e fica disponível pra download direto aqui na área de membros (botão na Etapa 1) — não fica mais no GitHub público.

Etapa 1 de 5 Pendente

Clonar o produto + pré-requisitos

Você não vai programar — o produto já está pronto e testado. Aqui você clona o repositório e abre o Claude Code, que vai te conduzir pela configuração conversando, uma credencial de cada vez. Antes confirme que tem as contas necessárias.

📦 Onde fica o produto

O produto é exclusivo do ZX Control 4.0 Launch e fica disponível pra download direto aqui na área de membros (botão na Etapa 1) — não fica mais no GitHub público.

📥 Baixar o produto

📢Mudou: agora é só clicar no botão pra baixar — não precisa mais do comando do GitHub que aparece nas aulas antigas.

Depois de baixar

Dê duplo-clique no .zip pra descompactar — vai criar uma pasta zxmarketingdigital-clinica-cheia-…

Abra essa pasta no Claude Code — ele te conduz pela configuração conversando, uma credencial de cada vez.

Bloqueantes (sem isso o setup para)

▶

Conta Supabase grátis — banco da clínica (agenda, clientes, mensagens). Use a conta do seu cliente.

▶

Conta Cloudflare grátis — hospeda o motor (Worker) e o painel (Pages) sem custo.

▶

Chave Google Gemini — o cérebro dos agentes. Gere em aistudio.google.com → Get API key (tem free tier).

▶

WhatsApp da clínica via uazapi — recomendado. Pegue UAZAPI_URL + UAZAPI_TOKEN no painel.

Opcionais

⚠️

Link de avaliação do Google — usado pelo agente de avaliação. Pegue no Google Business da clínica.

⚠️

Planilha de clientes atual — se a clínica já tem base, dá pra importar depois (CSV).

Como rodar

no Claude — depois de abrir, diga isso

Configure o Clínica Cheia para o meu cliente

Clone e abra o Claude

Rode o comando acima — o repositório baixa e o Claude Code abre dentro da pasta.

Confirme os pré-requisitos

O Claude pergunta se você tem Supabase, Cloudflare, Gemini e WhatsApp — separe esses acessos antes.

Deixe o Claude te conduzir

A partir daqui é só conversar: ele pede uma credencial de cada vez e explica onde pegar.

Etapa 2 de 5 Pendente

Configurar para a clínica

O Claude coleta as credenciais conversando e escreve dois arquivos de config (não vão pro Git): o .env do motor e o painel/config.js do painel. Quem prefere fluxo scriptado pode usar o wizard.

Como rodar (alternativa scriptada)

terminal — opcional, ou deixe o Claude fazer

node setup/configure.mjs

Nome da clínica + chaves Supabase

Service key (secreta, fica no motor) e anon key (vai pro painel) — em Project Settings → API.

Gemini + WhatsApp + link de avaliação

O Claude gera um WEBHOOK_SECRET forte pra você — guarde, vai usar na etapa do WhatsApp.

Arquivos .env e painel/config.js prontos

Gravados localmente e fora do Git — são os dados da clínica do seu cliente.

Etapa 3 de 5 Pendente

Aplicar o banco

Cria as tabelas da clínica no Supabase (procedimentos, clientes, agendamentos, lista de espera, mensagens) e insere os procedimentos default do nicho. Tudo na conta do seu cliente.

Como rodar

terminal — Supabase CLI logado
supabase link --project-ref <REF_DO_PROJETO> && \
supabase db push

Linke o projeto do cliente

O REF está na URL do Supabase do cliente (Project Settings → General).

db push aplica as migrations

Cria as 5 tabelas com RLS habilitado — o Claude confirma cada uma.

Procedimentos default do nicho

O seed insere os procedimentos de estética prontos — ajuste depois conforme a clínica.

Etapa 4 de 5 Pendente

Deploy do motor + painel

Publica o Worker (os agentes) e o painel da clínica no Cloudflare — tudo no plano grátis. Os segredos vão por wrangler secret, nunca no código.

Como rodar

terminal
pnpm wrangler deploy # o motor (agentes)
pnpm wrangler pages deploy painel/ --project-name clinica-cheia-<slug>

Deploy do Worker

Sobe o motor dos 5 agentes — anote a URL do Worker, você usa na próxima etapa.

Configure os secrets

SUPABASE_SERVICE_KEY, GEMINI_API_KEY, UAZAPI_TOKEN e WEBHOOK_SECRET via wrangler secret put.

Deploy do painel

O painel da clínica vai pro ar em *.pages.dev — é onde a dona marca quem veio.

Etapa 5 de 5 Pendente

Conectar WhatsApp + validar

Aponte o webhook do WhatsApp pro Worker e rode o smoke test, que confere tudo de ponta a ponta. Se passar, o produto está no ar — ensine a dona a marcar Realizado no painel (é o que dispara retorno e avaliação).

1. Registre o webhook no painel do WhatsApp

URL do webhook (uazapi → webhook)

<URL_DO_WORKER>/webhook?token=<WEBHOOK_SECRET>

2. Rode o smoke test

terminal

node setup/smoke.mjs

Webhook com o ?token

Sem o token o Worker rejeita (401) — é o WEBHOOK_SECRET que o Claude gerou na etapa 2.

Smoke valida tudo

Confere variáveis, Supabase, envio de WhatsApp, resposta do Gemini e /health do Worker.

Ensine a clínica

Mostre o painel pra dona e explique: marcar Realizado é o que libera lembrete de retorno e pedido de avaliação.

▶ Aulas

Aulas — Setup 12

Apresentação completa do Jurídico ZX Control: o que é o produto (5 agentes de IA + equipe + acompanhamento de processos no DataJud/CNJ + módulo Growth & CRM), a demonstração ao vivo do painel funcionando e como vender pro advogado solo / escritório pequeno. Assista antes de começar as 6 etapas.

🎬 Call — Jurídico ZX Control (apresentação + demo + como vender)

📚 Repositório público

github.com/zxmarketingdigital/juridico-zx-control ↗

Cole o link do repo no Claude Code e peça pra clonar e configurar — nada de wizard, a instalação é conversada.

no Claude Code — cole o prompt

Clone deste repositório https://github.com/zxmarketingdigital/juridico-zx-control e me conduza pela instalação seguindo o setup/CLAUDE.md — uma credencial de cada vez, me explicando onde achar cada uma.

🖥️ Protótipo online (demo)

zxcontrolsetup.pages.dev ↗

Mande esse link pro seu cliente ver o painel funcionando — agentes, equipe, processos e Growth/CRM já populados. Login de teste: advogado@teste.com / Teste@12345.

💼 Proposta comercial pronta

proposta-juridico-zxcontrol.pages.dev ↗

Apresentação de venda pronta pra usar com o advogado — ancore no tempo que ele economiza: o trabalho braçal do Direito feito em minutos.

Etapa 1 de 6 Pendente

Clonar o produto

O Jurídico ZX Control é um produto pronto e testado — a lógica dos 5 agentes é congelada e validada, você nunca toca no código. A instalação é 100% guiada pelo Claude Code: você não programa nada, só configura por conversa, uma credencial de cada vez. Nada de wizard.

📚 Repositório público

github.com/zxmarketingdigital/juridico-zx-control ↗

O jeito mais simples: cole o link no Claude Code

no Claude Code — cole e siga a condução

Clone deste repositório https://github.com/zxmarketingdigital/juridico-zx-control e me conduza pela instalação seguindo o setup/CLAUDE.md — uma credencial de cada vez, me explicando onde achar cada uma.

O Claude clona o repo, lê o roteiro de instalação e te conduz conversando — você só responde as perguntas dele.

Bloqueantes (sem isso o setup para)

▶

Conta Supabase — crie um projeto novo por cliente (banco do escritório: clientes, casos, documentos, prazos, peças — com login dos advogados e Storage de documentos).

▶

Conta Cloudflare com wrangler logado — hospeda o Worker (API + agentes) e o painel do escritório (Pages).

▶

Chave Google Gemini — o cérebro dos agentes (provider trocável depois). Gere em aistudio.google.com/apikey (tem free tier).

Como rodar

Cole o link do repo no Claude Code

Use o prompt acima — o Claude clona o juridico-zx-control e abre nele.

Ele lê o setup/CLAUDE.md

É o roteiro de instalação — o Claude segue passo a passo conversando, sem despejar lista de variáveis.

Confirme as contas

Cloudflare, Supabase e a chave Gemini — todas com plano gratuito pra começar.

Etapa 2 de 6 Pendente

Configurar credenciais

O Claude coleta uma credencial por vez, explicando onde achar cada uma: URL do projeto Supabase, anon key (pública), service key (opcional, só se aplicar migrations via CLI) e a chave do Gemini. Nada de segredo vai pro Git.

Como rodar

no Claude — só continue a conversa

Continue respondendo as perguntas do Claude  # ele escreve .env + painel/config.js sozinho — nada vai pro git

Supabase URL + anon key

Em Settings → API. A anon key é pública; a service key é opcional e secreta.

Chave do Gemini

Crie no Google AI Studio e cole — o provider é trocável depois numa só configuração em src/config.ts.

Confira os arquivos criados

O .env e o painel/config.js ficam locais, fora do Git.

Etapa 3 de 6 Pendente

Aplicar o banco

Cria as tabelas no Supabase do cliente — clientes, casos, documentos, prazos e peças geradas — com RLS habilitado em todas e o bucket de documentos no Storage (também com policy). Cada escritório tem uma base isolada.

Como rodar

terminal — Supabase CLI logado (ou pelo SQL Editor)
supabase link --project-ref <REF> && \
supabase db push

Link no projeto do cliente

O REF está no Supabase do cliente (Project Settings → General) — cada escritório tem o próprio projeto.

db push aplica as migrations

Cria as tabelas com RLS ligado em todas + o bucket de documentos com policy. Pelo SQL Editor também dá (sem service key).

Confirme a RLS

O Claude confirma que a RLS ficou habilitada em todas as tabelas e no Storage — dados de cliente/caso nunca ficam abertos.

Etapa 4 de 6 Pendente

Deploy do sistema

Publica o Worker (API + os 5 agentes) e o painel do escritório no Cloudflare Pages — tudo no plano grátis. Os segredos (Supabase + Gemini) vão por wrangler secret, nunca no código.

Como rodar

terminal
pnpm run deploy && \
pnpm wrangler pages deploy painel/ --project-name juridico-<cliente>

Deploy do Worker

Sobe a API + os agentes — anote a URL do Worker, você usa no painel.

Configure os secrets

Supabase URL + anon key + service key + chave Gemini via wrangler secret put — nunca no repo.

Publique o painel

Crie o painel/config.js com a URL do Worker e suba a pasta painel/ no Cloudflare Pages.

Etapa 5 de 6 Pendente

Primeiro advogado + Smoke test

Crie o primeiro usuário (o advogado do escritório) no Supabase Auth e valide tudo com o smoke test. Nunca entregue sem ele passar — faça login no painel, rode um agente e confirme que o resultado aparece com o aviso de revisão obrigatória pelo advogado.

Como rodar

terminal

node setup/smoke.mjs

Crie o primeiro usuário

No Supabase Auth, cadastre o e-mail + senha do advogado. Cada advogado da equipe terá o próprio login depois.

Smoke test

Confere que as variáveis essenciais estão presentes e o sistema respondeu sem erro.

Login + 1 agente de ponta a ponta

Faça login no painel, rode um agente e confirme o resultado salvo no histórico com o aviso de revisão obrigatória.

Etapa 6 de 6 Pendente

Demonstrar e vender

O pitch é o trabalho braçal do Direito feito em minutos — com a revisão sempre no advogado: análise de contrato, minuta, resumo de processo, prazo e triagem, mais a gestão de equipe, o acompanhamento de processos no CNJ e o painel Growth/CRM. Use o protótipo online na demonstração e a proposta comercial pronta pra fechar.

🖥️ Protótipo online (demo)

zxcontrolsetup.pages.dev ↗

Mande esse link pro seu cliente ver o painel funcionando — agentes, equipe, processos e Growth/CRM já populados. Login de teste: advogado@teste.com / Teste@12345.

💼 Proposta comercial pronta

proposta-juridico-zxcontrol.pages.dev ↗

Apresentação de venda pronta pra usar com o advogado — ancore no tempo que ele economiza por semana.

Como demonstrar (sem instalar nada)

terminal — demo local populada, sem credencial

node demo/server.mjs   # → http://localhost:8910

Demonstre com o protótipo online

Abra o demo na frente do advogado — ele vê os 5 agentes, a equipe, os processos no DataJud e o painel Growth/CRM funcionando.

Apresente a proposta

Use a página de proposta pronta e ancore no tempo: o trabalho braçal feito em minutos paga o investimento já no primeiro mês.

Fechou? Instale por cliente

Cada instalação é isolada (uma base por escritório) — você revende pra vários advogados.

▶ Aulas

Aulas — Setup 11

Apresentação completa do Corretor ZX Control: o que é o produto (5 agentes de WhatsApp que vendem imóvel), a demonstração ao vivo do sistema funcionando e como vender pro corretor — pitch, precificação e fechamento. Assista a call antes de começar as 6 etapas.

🎬 Call — Corretor ZX Control (apresentação + demo + como vender)

📚 Repositório público

github.com/zxmarketingdigital/corretor-zx-control ↗

🖥️ Protótipo online

demo-corretor.zxlab.com.br ↗

Mande esse link pro seu cliente ver o sistema funcionando — painel com catálogo, carteira, conversas e visitas já populados.

💼 Proposta comercial pronta

demo-corretor.zxlab.com.br/proposta ↗

Apresentação de venda pronta pra usar com o corretor — investimento de R$ 3.000 de implementação + R$ 500/mês.

📑 Apresentação do produto (a mesma da call)

Abrir a apresentação do Corretor ZX Control ↗

A página usada na call de lançamento — o que é o produto, os 5 agentes, o fluxo e o passo a passo da instalação.

Etapa 1 de 6 Pendente

Clonar o produto

O Corretor ZX Control é um produto pronto e testado — a lógica dos 5 agentes é congelada e validada, você nunca toca no código. A instalação é 100% guiada pelo Claude Code: você não programa nada, só configura por conversa, uma credencial de cada vez.

📚 Repositório público

github.com/zxmarketingdigital/corretor-zx-control ↗

O único comando que você precisa rodar

terminal — cole e pressione Enter
git clone https://github.com/zxmarketingdigital/corretor-zx-control.git ~/corretor-cliente && \
cd ~/corretor-cliente && \
claude

Ao abrir, cole no Claude: Inicia a instalação do setup para o meu cliente — ele te apresenta o produto e conduz tudo a partir daí.

Bloqueantes (sem isso o setup para)

▶

Conta Supabase — crie um projeto novo por cliente (banco do corretor: catálogo, carteira, conversas, visitas).

▶

Conta Cloudflare com wrangler logado — hospeda o Worker (agentes) e o painel do corretor (Pages).

▶

Chave Google Gemini — o cérebro dos agentes. Gere em aistudio.google.com/apikey (tem free tier).

▶

Instância Evolution API na SUA infra de revendedor — URL, nome da instância e API key (a instância roda na sua infra, não no computador do corretor).

Opcionais (etapa 6)

⚠️

Planilha CSV de imóveis do corretor — usada na etapa 6 pra importar o estoque do cliente fechado.

⚠️

Link do Google Minha Empresa do corretor — o agente de pós-venda usa pra pedir avaliação no Google.

Como rodar

no Claude — depois de abrir, cole isso

Inicia a instalação do setup para o meu cliente

Clone o repositório

Rode o comando acima — ele baixa o produto pra pasta ~/corretor-cliente.

Abra o Claude Code na pasta

O mesmo comando já abre o claude dentro do repositório clonado.

Peça pra iniciar a instalação

Cole o prompt acima — o Claude apresenta o produto e conduz a configuração conversando.

Etapa 2 de 6 Pendente

Configurar credenciais

O Claude coleta uma credencial por vez, explicando onde pegar cada uma. São 10 itens: nome do corretor, Supabase URL + service key, chave Gemini, Evolution URL + instância + key, token do painel, webhook secret e o link de avaliação do Google.

Como rodar

no Claude — só continue a conversa

Continue respondendo as perguntas do Claude  # ele escreve .env + painel/config.js sozinho — nada vai pro git

Responda as perguntas

Uma credencial por vez — o Claude sempre mostra onde pegar (Supabase → Project Settings → API, etc).

Claude gera os tokens fortes

O token do painel e o webhook secret são gerados por ele — você não precisa inventar senha.

Confira o .env criado

O .env e o painel/config.js ficam locais, fora do Git.

Etapa 3 de 6 Pendente

Aplicar o banco

Cria as 5 tabelas no Supabase do cliente — catálogo de imóveis, carteira de clientes, conversas, visitas e log de disparos — com RLS habilitado em todas. O seed insere dados de demonstração pra você mostrar o sistema funcionando já no primeiro acesso.

Como rodar

terminal — Supabase CLI logado
supabase link --project-ref <REF> && \
supabase db push && \
supabase db execute --file setup/seed.sql

Link no projeto do cliente

O REF está no Supabase do cliente (Project Settings → General) — cada corretor tem o próprio projeto.

db push aplica as 3 migrations

Cria as 5 tabelas com RLS ligado em todas — o Claude confirma cada uma.

Seed insere os dados demo

Imóveis e clientes de demonstração pro painel não nascer vazio na frente do cliente.

Etapa 4 de 6 Pendente

Deploy do sistema

Publica o Worker (os 5 agentes + crons) e o painel do corretor no Cloudflare Pages — tudo no plano grátis. Os 10 secrets vão por wrangler secret, nunca no código.

Como rodar

terminal
pnpm wrangler deploy && \
pnpm wrangler pages deploy painel/ --project-name corretor-<cliente>

Deploy do Worker

Sobe os agentes + crons — anote a URL do Worker, você usa nos próximos passos.

Configure os 10 secrets

Supabase, Gemini, Evolution, token do painel, webhook secret e cia — via wrangler secret put.

Atualize config.js e redeploy do painel

Coloque a URL do Worker no painel/config.js e rode o pages deploy de novo.

Etapa 5 de 6 Pendente

Conectar WhatsApp + Smoke test

Registre o webhook na Evolution, escaneie o QR Code com o celular do corretor e valide tudo com o smoke test de ponta a ponta. Nunca entregue sem ele passar 5/5 — se algo falhar, pare e corrija antes de mostrar ao cliente.

Como rodar

terminal

node setup/smoke.mjs

Webhook → <worker>/webhook

Registre na Evolution com o header x-webhook-secret — sem ele o Worker rejeita (401).

QR Code com o celular do cliente

Escaneie com o celular do corretor até o status ficar connected.

Smoke test 5/5

Valida env, Supabase, envio de WhatsApp, resposta do Gemini e /health do Worker.

Etapa 6 de 6 Pendente

Demonstrar e vender

O pitch do dia 1 é Atendente 24/7 + anti-no-show + indicação; o radar de oportunidades é o "valor que cresce" conforme a carteira enche. Use o protótipo online na demonstração e a proposta comercial pronta pra fechar: implementação R$ 3.000 + R$ 500/mês de recorrência — ancore em comissão: uma visita a mais fechada paga o ano.

🖥️ Protótipo online

demo-corretor.zxlab.com.br ↗

Mande esse link pro seu cliente ver o sistema funcionando — painel com catálogo, carteira, conversas e visitas já populados.

💼 Proposta comercial pronta

demo-corretor.zxlab.com.br/proposta ↗

Apresentação de venda pronta pra usar com o corretor — investimento de R$ 3.000 de implementação + R$ 500/mês.

Como rodar (importar a base do cliente fechado)

terminal — depois que o corretor fechar
node setup/importar-planilha.mjs imoveis planilha.csv

Demonstre com o protótipo online

Abra o demo-corretor na frente do cliente — ele vê o atendente, a agenda de visitas e o painel funcionando.

Apresente a proposta (R$ 3.000 + R$ 500/mês)

Use a página de proposta pronta e ancore em comissão — uma visita a mais fechada no ano paga tudo.

Fechou? Importe estoque e carteira

Rode o import CSV com a planilha de imóveis (e clientes) do corretor — o radar ganha combustível no dia 1.

Escolha por onde começar

Aulas — Setup 1

Instalar Pré-requisitos

Claude Code — o assistente de setup

Python, Node.js, Git e Docker Desktop

Primeiro Acesso — Clonar e Abrir

O que acontece quando você rodar esse comando

Na primeira vez, o Claude vai se autenticar

Digite INICIAR SETUP para começar

Configurar o Ambiente

Seu nome

Nome do seu negócio

O Claude vai perguntar qual provedor de WhatsApp você quer usar

Conectar o WhatsApp

Evolution API — roda no seu computador

Z-API — roda na nuvem (R$97/mês)

Escaneie o QR Code (apenas Evolution API)

Configurar o Email

Crie uma conta gratuita em resend.com

Acesse API Keys no painel da Resend

Cole a API Key quando o Claude pedir

Ativar o Agente IA

API Key do provedor escolhido

Nome e tom do agente

O agente é instalado em ~/.operacao-ia/scripts/

Importar seus Contatos

Colar diretamente no terminal

Informar o caminho de um arquivo CSV

O que acontece automaticamente

Configurar Disparos

Peça ao Claude para montar o disparo

Revise o preview e confirme

Filtre por grupo ou tag quando quiser

Ativar o Monitor Diário

O Claude instala o monitor automaticamente

Primeiro health check imediato

Teste Final e Operação Pronta

Resumo de tudo que foi configurado

Primeiro disparo guiado — dentro do Claude

Operação IA pronta

✅ Checklist da Operação IA Completa

Aulas — Setup 2

Primeiro Acesso — Setup 2

O que acontece quando você rodar esse comando

Digite INICIAR SETUP 2 para começar

Independente do Setup 1

O que o Claude faz automaticamente

Mission Control

Como o Claude gera o Mission Control

Como abrir no browser

Como personalizar

Uso no dia a dia

RTK Token Killer

O que é o RTK

Verificar instalação

Uso no dia a dia — transparente

Pack de Skills Profissionais

Como usar as skills

Para que serve no dia a dia

Expandir com mais skills

Agente Guardião + Heartbeat

O que são o Guardião e o Heartbeat

O que fazer quando receber um alerta

Verificar se o Guardião está ativo

Supabase + Auth

Criar conta Supabase antes desta etapa

O que o banco habilita

Plano gratuito e limites

Importar Contatos para a Nuvem

O que acontece durante a migração

Verificar a importação

A partir de agora, tudo vai para a nuvem

Mini-CRM Publicado

Como o deploy acontece

Para que serve

Após o deploy

✅ Checklist da Operação Robusta

Aulas — Setup 3

Boas-vindas + Diagnóstico

O que acontece quando você rodar esse comando