| name | whatsapp-funil |
| description | Estrutura a sequência de WhatsApp/DM de um funil — mensagens por momento: lembrete de evento/live, confirmação, carrinho abandonado, cartão recusado, nutrição e re-engajamento — casadas ao estágio de consciência. O aluno preenche com o produto/oferta dele; a skill gera a copy aplicada das mensagens a partir do copy.md (quando ele existe) e o aluno revisa e aprova. Use quando precisar montar/diagnosticar a sequência de WhatsApp ou DM de um funil, decidir que mensagem mandar em cada momento, ou casar o tom e o timing de cada disparo ao quão quente está o contato. A skill estrutura a sequência e gera a copy aplicada a partir do copy.md; o texto final é revisado e aprovado por você. |
| user_invocable | true |
Toda mensagem sai SEPARADA e com botão Copiar (regra dura). Além do documento da peça, cada mensagem individual sai em arquivo próprio pronto pra usar: e-mail = 1 HTML por e-mail no padrão do disparador (tabela, inline, preheader, merge tags) com DOIS botões fixos no canto superior direito do preview: "Copiar texto" (só o texto do e-mail, pronto pra colar no editor da ferramenta) e "Copiar HTML" (o código LIMPO do e-mail, pronto pra colar no modo HTML da ferramenta); os botões removem a si mesmos do que é copiado; WhatsApp/DM = página com as mensagens em texto, botão "Copiar texto" em cada uma. Tudo listado num índice clicável (emails/index.html ou equivalente). O dono nunca precisa garimpar copy dentro de documento: é clicar, copiar, colar.
WhatsApp / DM de Funil — Sequência por momento
Skill que estrutura a sequência de WhatsApp / DM de um funil: que mensagem mandar em cada momento (lembrete de evento, confirmação, carrinho abandonado, cartão recusado, nutrição, re-engajamento), com que tom e em que timing — casado ao quão quente está o contato.
KB (fonte de verdade): KB-whatsapp-funil.md (nesta pasta). Tem o método completo, os momentos da sequência, os timings (ex.: "30 min após o carrinho") e o verbatim da fonte. Carregue o KB antes de prescrever — nunca responda de cabeça.
Tese central: o WhatsApp/DM é o canal mais quente do funil — chega direto, é lido em minutos, tem a maior taxa de resposta. Por isso mesmo é o mais fácil de queimar: mandar a mesma mensagem pra todo mundo, no momento errado, vira spam e o contato te bloqueia. O segredo é o momento certo + a mensagem certa pra cada situação. Quem só abandonou o carrinho está com objeção; quem teve o cartão recusado já tentou pagar e está quentíssimo — cada um pede uma abordagem diferente. Método do Alan Nicolas.
Onde salvar e ler — convenção de projeto
Todo o trabalho de um nicho fica em projetos/{slug}/ (um slug por nicho). Um projeto = uma pasta, com todas as peças do funil dentro. Nada solto na raiz.
Como descobrir o projeto ativo:
- Se o usuário passou o slug/nicho no comando, use-o.
- Senão,
ls projetos/ 2>/dev/null: uma pasta → use-a; várias → pergunte qual; nenhuma → o funil ainda não começou.
Nomes dentro da pasta (sem repetir o slug): avatar.md, offerbook.md, copy.md, funil.md, DESIGN.md, recuperacao.md, cro.md; subpastas pagina/, emails/, conteudo/, carrossel/, mockups/. Nos 3 formatos (md/html/pdf) onde a skill gera.
Onde salvar: o entregável desta skill sai em projetos/{slug}/whatsapp.md.
Passo 0 — Checar insumos antes de rodar
Regras compartilhadas (leia antes de gerar): .claude/skills/_shared/perfil.md — o Perfil do Projeto (topo do offerbook) define o papel do canal e traz o guard de voz/tipo (se Voz = marca ou Tipo ∈ {físico, saas-app, serviço, b2b}, proibido enquadramento de especialista/curso/depoimento-de-aluno). E .claude/skills/_shared/nunca-travar.md — pré-requisito e ferramenta em linguagem de leigo (glossário inline: explique cada termo técnico em 4 palavras entre parênteses na 1ª vez), Apify é central, nunca opcional (fallback só com cota estourada), e nunca prometa que o HTML abre sozinho — sempre o caminho do arquivo + como abrir no SO do aluno.
- Obrigatório:
offerbook.md (produto, ticket, público e momentos do funil vêm dele).
- Recomendados:
avatar.md (voz e objeções do cliente) e recuperacao.md (se existir, alinhe as mensagens de recuperação com a cascata dele).
Se faltar o obrigatório, aponte a skill que o gera (/offerbook) e PERGUNTE se o aluno quer seguir mesmo assim.
Copy aplicada — gerada NESTA skill a partir do copy.md
Sem cara de IA na copy (regra dura). Em TODA copy voltada ao cliente final (headline, bullet, página, e-mail, mensagem, roteiro): sem travessão (—) — reescreva com ponto, vírgula ou dois-pontos; e sem a construção "não é sobre X, é sobre Y" (e variantes "não é X, é Y", "não se trata de X, e sim de Y") — esse contraste é assinatura de texto de IA. Afirme direto o que É, ou mostre o contraste com fato concreto do avatar. Vale pra copy aplicada gerada por esta skill.
Versões, pendências e Book do Funil (regra dura — texto completo em .claude/skills/_shared/book-do-funil.md; LEIA-o ao fechar a peça). Recriar nunca apaga: peça existente ganha versão nova (-v2), e o ✕ das versões antigas só esconde do Book (nunca apaga do disco). Pendências do dono vão pra projetos/{slug}/pendencias.md com CHAVE por decisão (re-run reconcilia, nunca soma). Ao terminar: atualize o card da peça no Book (projetos/{slug}/index.html — cards linkam sempre o .html, nunca .md) e o "VOCÊ ESTÁ AQUI" do mapa; documentos internos levam "← Voltar" + "← Book do Funil" (roteiro/VSL leva os DOIS botões, com caminho relativo real); amostra/checkpoint entra no Book ANTES de ir pro chat; feche com "Preencha as pendências" e abra o Book. Se o Perfil disser agência, ofereça a "versão cliente" do Book.
Se projetos/{slug}/copy.md existe (fundação da copy aprovada no /copy-funil: Big Idea, mecanismos, voz/léxico, banco de headlines e bullets, objeções), esta skill GERA a copy aplicada da sua peça a partir dele — o texto final das mensagens de cada momento. O aluno NÃO volta pro /copy-funil pra isso. Se o copy.md NÃO existe, aponte /copy-funil (a fundação) e PERGUNTE se o aluno quer seguir só com a estrutura. A copy aplicada obedece: Big Idea e mecanismos do copy.md · voz e léxico do avatar · regra de honestidade de prova ([SEM PROVA AINDA]) · compliance de nicho sensível. Depois de aplicada, a peça pode ser auditada na fase de validação do /copy-funil (nota Hopkins + checklist Sugarman).
Gate de pré-requisito (execute ANTES de tudo)
Esta skill parte do output das etapas anteriores do funil. Antes de qualquer coisa, descubra o projeto ativo e confira que os arquivos existem dentro dele:
# 1. Descubra o projeto ativo:
ls projetos/ 2>/dev/null
# 2. Confira os arquivos dentro do projeto ativo:
ls projetos/{slug}/offerbook.md projetos/{slug}/copy.md 2>/dev/null
- Se existir(em), leia deles a oferta (produto, ticket, público, momentos do funil) do
projetos/{slug}/offerbook.md e a copy base do projetos/{slug}/copy.md.
- Se FALTAR algum, PARE e exiba um aviso claro apontando qual skill rodar antes:
Pra estruturar a sequência de WhatsApp/DM eu preciso do projetos/{slug}/offerbook.md, que sai da skill /offerbook (e da projetos/{slug}/copy.md pra copy base, da skill /copy-funil). Rode /offerbook primeiro; quando projetos/{slug}/offerbook.md existir, volte e rode esta skill de novo.
Não invente de cabeça o conteúdo que deveria vir da etapa anterior.
Como usar
Quando você precisar montar/diagnosticar a sequência de WhatsApp ou DM de um funil:
- Carregue o KB (
KB-whatsapp-funil.md) pra ter os momentos, os timings e o verbatim na mão.
- Colete os inputs do seu projeto (você preenche com a realidade do seu funil):
- Produto / oferta e ticket — o que está sendo vendido.
- Tem evento no funil? — live, aula, webinário, masterclass? (define os lembretes).
- O que seu funil consegue detectar? — carrinho abandonado? cartão recusado? boleto/pix gerado? (define quais mensagens de recuperação dá pra ativar).
- Sua ferramenta de automação de WhatsApp/DM — você dispara manual ou tem automação? (genérico: qualquer ferramenta de automação de WhatsApp/DM serve).
- Quão quente é o contato — ele veio de tráfego frio, da sua base, de um evento? (define o tom).
- Diagnostique cada momento que existe no seu funil (Passo a passo abaixo).
- Monte a sequência de mensagens por momento, do mais quente ao mais frio.
- Apresente a estrutura pra você revisar/aprovar antes de configurar qualquer disparo.
- Gere a copy aplicada de cada mensagem nesta skill, a partir do
projetos/{slug}/copy.md (quando ele existe) — você revisa e aprova o texto final.
Gate (antes de prescrever)
A sequência de WhatsApp/DM só funciona se você distingue os momentos. Tratar todo contato igual é o erro número um — e o que mais queima o canal.
"Se ela abandonou o carrinho... ela está com objeções. Se ela chegou a colocar o cartão e recusou, percebe que ela tentou... a tua abordagem vai ser completamente diferente."
Antes de montar a sequência, confirme: quais momentos seu funil consegue detectar? Você só ativa a mensagem certa pros momentos que consegue identificar (tem evento? detecta carrinho abandonado? detecta cartão recusado?).
Gate — Perfil do Projeto muda o PAPEL do WhatsApp (regra dura). Antes de prescrever, leia o Perfil do Projeto (topo do offerbook.md, regra em .claude/skills/_shared/perfil.md) e adapte o canal:
- Tipo = físico/varejo-local → o WhatsApp é o canal PRINCIPAL do negócio (não só recuperação): atendimento, captação no ponto, catálogo, promoção local, lembrete de retorno/agendamento. Estruture a sequência como o eixo do funil, não como um apêndice de checkout online.
- Tipo = serviço / b2b OU Ticket = alto(5k+)/premium → o objetivo de CADA mensagem é agendar/confirmar/lembrar da REUNIÃO (call, diagnóstico, visita), nunca vender direto por WhatsApp. Nada de link de checkout no fio; o WhatsApp aquece e leva pra reunião.
- Guard: se Voz = marca ou Tipo ∈ {físico, saas-app, serviço, b2b}, é proibido enquadramento de "especialista/curso/mentoria" e "depoimento de aluno" nas mensagens — use voz do cliente / prova de uso / case.
- Situação = afiliado → meça e aja até o CLIQUE no seu link; do checkout em diante é do produtor (você não controla o pagamento, não gere mensagem de cartão recusado/boleto).
Processo passo a passo
- Listar os momentos do seu funil — quais existem: lembrete de evento, confirmação, carrinho abandonado, cartão recusado, boleto/pix, nutrição, re-engajamento.
- Para cada momento, ler o que o contato está sentindo (a tabela abaixo / KB §3).
- Definir o timing de cada disparo (ex.: lembrete antes do evento; "30 min após o carrinho"; cartão recusado logo após a falha).
- Definir o tom de cada mensagem (mais quente pra quem tentou pagar; mais leve/cuidadoso pra quem só abandonou).
- Encadear a sequência do contato mais quente ao mais frio.
- Mapear os disparos (momento + timing + tom) — e gerar a copy aplicada de cada mensagem a partir do
copy.md (quando ele existe), pra você revisar.
- Apresentar a estrutura pra você aprovar.
Mensagens por momento do funil
| Momento | O que o contato está sentindo | Mensagem (objetivo) | Timing |
|---|
| Confirmação de inscrição | Acabou de entrar — interesse no pico | Confirmar, reforçar o que vai receber, baixar a ansiedade | Imediato, logo após a inscrição |
| Lembrete de evento/live | Inscrito, mas a vida puxa pra outro lado | Lembrar do evento + reforçar o valor de aparecer | Sequência: véspera → dia → 1h antes → "estamos começando" |
| Link do evento | Hora de entrar | Mandar o link de acesso (Zoom/live), curto e direto | Bem perto da hora (não junto da agenda) |
| Carrinho abandonado | Chegou no checkout e travou — está com objeção | Tom leve, "aconteceu algo errado?" — abrir conversa | 30 min depois do abandono |
| Cartão recusado | Tentou pagar e falhou — quentíssimo, só faltou passar | Mais quente e direta: ajudar a finalizar, trocar o meio de pagamento e/ou desconto | Logo após a falha |
| Boleto/pix gerado | Escolheu pagar mas não concluiu — interesse alto | Empurrar pra finalizar (ex.: cartão com desconto) | Antes de vencer / esfriar |
| Nutrição / re-engajamento | Esfriou, não converteu em nada | Reativar a dor, voltar pro problema, reconstruir o caminho | Sequência mais longa, sem pressão |
Regra de leitura: quem tentou pagar (cartão recusado) está mais quente que quem só abandonou o carrinho. A mensagem do cartão recusado é mais quente e direta; a do carrinho é mais cuidadosa, porque ali existe objeção. Quem apareceu no evento está mais quente que quem só se inscreveu.
Nicho regulado — saúde (regra dura): onde a tabela prescreve desconto (cartão recusado, boleto/pix), em saúde/médico o incentivo NUNCA é desconto anunciado (vedação do conselho): é facilitar o pagamento (parcelar, trocar o meio, reenviar o código) e reagendar, nunca "R$ X off" na mensagem.
CTA "falar com o time / IA de atendimento" (regra dura). Toda mensagem oferece uma saída humana pra quem travou: um convite claro pra responder aqui e falar com o time (ou com a IA de atendimento) — "me responde aqui que eu te ajudo a finalizar". É obrigatório nas mensagens de cartão recusado e boleto/pix (o contato já quis pagar e esbarrou em algo operacional: ali um "responde que eu resolvo com você" converte mais que qualquer desconto). O WhatsApp é conversa: nunca deixe o contato num beco sem ter pra quem responder.
Regras de tom e timing
Tom:
- WhatsApp/DM é conversa, não panfleto. Tom de pessoa falando com pessoa, nunca aviso automático seco.
- Quanto mais quente o contato (tentou pagar, apareceu no evento), mais direta pode ser a mensagem.
- Quanto mais frio ou com objeção (carrinho abandonado, nutrição), mais leve e curioso o tom — abrir conversa, não pressionar.
- Uma mensagem, uma ideia. Mensagem longa no WhatsApp não é lida.
Timing:
- 30 min é a janela do carrinho abandonado — quente o bastante pra reagir, fresco o bastante pra lembrar.
- Cartão recusado: logo após a falha (a intenção de pagar ainda está viva).
- Lembrete de evento: cadência, não um disparo só (véspera, dia, 1h antes, "começando agora").
- Link do evento perto da hora; a agenda vai antes, o link vai na hora.
- Boleto/pix: agir antes de vencer ou esfriar.
Honestidade de prova: nunca invente depoimento, número, case ou citação nas mensagens — prova vem do offerbook.md/pesquisa. Sem prova → garantia/bastidor/transparência e marque [SEM PROVA AINDA]; nicho regulado → linguagem de possibilidade (gate de compliance do offerbook).
Regras de ouro
SEMPRE: distinguir o momento antes de escolher a mensagem · tratar cartão recusado diferente de carrinho abandonado · tom de conversa (pessoa pra pessoa) · timing certo por momento (30 min no carrinho, logo após a falha no cartão recusado) · cadência nos lembretes de evento · uma ideia por mensagem · apresentar a estrutura pra revisão antes de configurar disparo.
NUNCA: mandar a mesma mensagem pra todo contato · pressionar quem está só com objeção (carrinho) como se fosse cartão recusado · mandar o link do evento junto da agenda (link vai na hora) · texto de aviso automático seco (vira spam, o contato bloqueia) · mensagem longa demais · entregar copy aplicada sem você revisar e aprovar (a skill gera a partir do copy.md; a aprovação é sua) · configurar/disparar nada sem você aprovar.
Output (o que a skill entrega)
- Mapa dos momentos que seu funil consegue detectar.
- Mensagem prescrita pra cada momento (objetivo, tom, timing).
- Sequência ordenada do contato mais quente ao mais frio.
- Cadência dos lembretes de evento (se houver evento no funil).
- Mapa de disparos (momento + timing + tom) — com a copy aplicada de cada mensagem gerada nesta skill a partir do
copy.md (quando ele existe), pra você revisar e aprovar.
Material visual usa o DESIGN.md da marca. Se você renderizar a sequência/o mapa como material visual (HTML, PDF), gere-o JÁ com os tokens do projetos/{slug}/DESIGN.md — cores, fontes, borda/raio, tamanho, logo. NUNCA use um tema fixo/genérico (dark, champagne, "padrão do cohort", template pronto). Legibilidade conforme o público (nichos 50+/acessibilidade → fonte grande ≥18px, alto contraste). Contraste por fundo (regra dura): texto sobre fundo ESCURO usa o token CLARO da marca (ex.: on-deep/creme), NUNCA o token muted (que é do fundo CLARO e some no escuro); e legenda/microcopy de apoio sai MENOR e mais leve (opacidade ~.7) que o corpo, pra não competir com headline nem com o botão. CSS inline, self-contained, sem emoji, português acentuado. Se não houver DESIGN.md, gere-o com /design-md antes.
Veto conditions (NÃO prescrever se…)
| Situação | Ação |
|---|
| Você não sabe quais momentos seu funil detecta | PARAR → levantar isso primeiro (é o gate) |
| Pediram a copy pronta das mensagens | Gerar a copy aplicada a partir do copy.md; se ele não existir, apontar /copy-funil e perguntar se segue só com a estrutura |
| Vão configurar/disparar sem você aprovar | PARAR → apresentar a estrutura, esperar o OK |
Skill whatsapp-funil v1 — sequência de WhatsApp/DM de funil por momento de consciência. Método do Alan Nicolas. Toda prescrição calibra no KB. A skill estrutura a sequência e gera a copy aplicada a partir do copy.md (quando ele existe); o aluno revisa e aprova. NUNCA executa ou dispara nada.
Entrega padrão (texto completo em .claude/skills/_shared/entrega-padrao.md — LEIA-o ao fechar a entrega)
Todo entregável sai nos 3 formatos (.md fonte · .html com os tokens do projetos/{slug}/DESIGN.md do aluno — nunca tema genérico; ≥18px/alto contraste pro público; texto sobre fundo escuro usa o token claro/on-deep, nunca muted · .pdf via scripts/gerar_pdf.sh). Toda entrega E todo checkpoint abrem o .html renderizado (detecte o SO — macOS open · Windows start "" · Linux xdg-open; se não abrir sozinho, ex. Codex, imprima o caminho + como abrir) e enviam o arquivo na conversa; nunca peça aprovação sem o usuário ver renderizado. Feche SEMPRE apontando UM próximo comando (ordem canônica do mapa). Ferramentas: check antes de usar (Chrome pro PDF, fallback imprimir em PDF; Apify é central nas skills de coleta, fallback só em cota estourada — _shared/nunca-travar.md).
Ferramentas específicas desta skill:
- Transcrição de áudio (whisper) — a IA NÃO escuta áudio sozinha. Check:
which whisper-cli ou pip3 show mlx-whisper (+ which ffmpeg pra converter). Tendo, transcreva pelo terminal (whisper-cli -m <modelo> -l pt -f audio.wav -otxt ou mlx_whisper audio.wav --language pt). Faltando: ofereça o setup e PERGUNTE antes de instalar — macOS brew install whisper-cpp ffmpeg (+ pip install mlx-whisper no Apple Silicon); Windows winget install ffmpeg + pip install faster-whisper (rode com python -m faster_whisper ou script equivalente). Fallback sem instalar nada: o WhatsApp transcreve áudio (segurar a mensagem > transcrever > colar aqui), ditado do celular, ou colar transcrição de qualquer ferramenta. O que importa é a fala real chegar em texto.
