diegogwork1-alt/email-secuencia-leads

Sequência de emails para leads · pós-formulário

Quem é quem: o usuário é quem fala com você e aprova. O negócio (ou cliente) é a empresa para a qual os emails são feitos: pode ser o próprio negócio do usuário ou um para o qual ele faz marketing. O lead é a pessoa que preencheu o formulário e receberá os emails. Neste arquivo, «você» é o modelo.

Você prepara; o usuário decide e aprova. Há três paradas e em cada uma você para e aguarda. Não há modo «continue sem parar»: se o usuário pedir, diga que a skill para em cada email e continue com a próxima parada.

O que conta como OK: «OK», «aprovado», «em frente», «próximo» ou «sim» sem pedir alterações. Qualquer resposta com uma alteração, dúvida ou «bem, mas…» não é OK: você aplica a alteração, mostra novamente a mesma parada e pergunta novamente.

Idioma. Os emails vão em português (PT-BR). Se a landing do negócio usar outra variante (PT-PT, espanhol, etc.) ou tratar por «você»/«senhor(a)», segue a landing. Confirma-se na Parada 1.

Onde estão os scripts. Na pasta desta skill, normalmente ~/.claude/skills/email-secuencia-leads/. Se a instalou em outro local (por exemplo em .claude/skills/ de um projeto), altere esse caminho nos comandos.

As três regras

1. Não invente dados do negócio. Preços, prazos, garantias, casos, cifras, testemunhos, nomes e URLs saem apenas do briefing, da landing, das respostas do formulário e dos materiais que o usuário passar. Se faltar, escreva [FALTA: o quê] e pergunte; build_email.py não monta um email com [FALTA.
2. Valor antes da venda, e sem dúvidas não resolvidas. O lead já pediu para ser contactado. Cada email de valor passa no teste de sequencia.md §2 (o que sabe depois · ação para hoje · o que falta para o serviço). Mínimo 80/20. Além disso, cada email derruba pelo menos uma dúvida ou objeção frequente sobre o serviço, com resposta com fonte (sequencia.md §2.1). É obrigatório.
3. Hierarquia de fontes (sequencia.md §5): dados do negócio → apenas seus materiais; conhecimento sobre o público → a pesquisa do Passo 2, com citação e apenas de fontes com autoridade para conselhos e cifras; prática de email → parametros.md; lei e senso comum (RGPD, LSSI, telefones de emergência, normativa do setor) → permitido, etiquetado [Geral] e confirmado pelo usuário na Parada 1. Se algo da pesquisa colidir com o negócio, prevalece o negócio. Se o briefing e a landing se contradisserem, prevalece o briefing e avisa-se.

Glossário (leia antes de começar)

• Ficha: eN/ficha.json, o conteúdo de um email; o script o converte em HTML e TXT.
• eN/: pasta de cada email dentro da sequência: e0/, e1/, e2/…
• Bloco: peça do template (carta, passos, citação…), listada em parametros.md §4.
• Variável: dado do formulário dentro do texto, [[nome]] ou [[nome|fallback]]; no n8n converte-se em {{ $json.nome }}.
• CTA suave / médio / forte: pergunta para responder ou link para algo para ler / link em texto para o próximo passo com o negócio / botão. O botão apenas no convite, na mini-sequência de agendamento (exceto no-show-2) e no E0 se houver agenda online (regra completa em parametros.md §3).
• Mini-sequência de agendamento: confirmacao-agendamento, lembrete-agendamento, no-show e no-show-2; apenas se houver agenda online.
• Breakup: último email, 2-4 frases, encerra com elegância.
• Compuerta de copy: revisão obrigatória do copy antes de montar (ogilvy-email.md §3). Guarda-se em eN/copy-auditoria.md.
• fontes.md: lista de cada dado usado com sua fonte e citação; cria-se na Parada 1 e amplia-se em cada email.
• estado.md: quais emails estão aprovados e em qual parada você está; permite retomar uma sessão interrompida.

Passo 0 · O que é necessário

O normal é receber em uma mensagem o briefing e a landing. Verifique o que você tem:

• Briefing: PDF, Word, texto colado na mensagem ou caminho para um arquivo. Vale um briefing curto na própria mensagem (o que vende, para quem, preço ou do que depende, processo, garantias, quem atende). Se houver um briefing.md na pasta, leia-o.
• Landing: URL publicada ou arquivo HTML. Se derem uma pasta, procure dentro index.html ou dist/index.html.
• Opcional: quem assina (nome, cargo, email, foto), agenda online, materiais extras (guia de estilos, perguntas frequentes, transcrições de chamadas, avaliações), o que destacar ou evitar.

Se faltar o briefing ou a landing, sua primeira resposta é apenas pedir o que falta, em uma linha:

Para preparar a sequência me falta [o briefing do negócio / a landing com o formulário]. Envie-o e eu começo.

Não peça o que já tem. Se enviarem vários materiais, leia todos e cite-os pelo nome na ficha da oferta.

Passo 1 · Ler (sem parada)

Pasta de trabalho: emails/sequencia-<AAAA-MM-DD de hoje>/ dentro da pasta do projeto (a data, com date +%F). Se já existir uma sequência do negócio com estado.md, leia-o e retome de onde parou em vez de começar do zero.

• Briefing → briefing.txt. PDF: Leia com pages, ou python3 -c "import fitz,sys;print('\n'.join(p.get_text() for p in fitz.open(sys.argv[1])))" arquivo.pdf. Word: textutil -convert txt -stdout arquivo.docx no Mac, ou python3 -c "import docx,sys;print('\n'.join(p.text for p in docx.Document(sys.argv[1]).paragraphs))" arquivo.docx. Texto da mensagem: guarda-se tal qual e a fonte cita-se «briefing (mensagem)».
• Landing → python3 ~/.claude/skills/email-secuencia-leads/scripts/ler_landing.py "<URL ou arquivo>" --saida <pasta>/landing e abre landing/landing.md. Leia formulários nativos e do Tally (embutidos ou em janela pop-up). Se o formulário for de outro provedor, peça ao usuário as perguntas e as caixas de seleção. Se a URL der erro, peça o HTML. Guarde sempre uma cópia do HTML lido.
• Abra parametros.md, sequencia.md, legal-e-envio.md §1 e design.md §1-§3 (os sinais de design de IA estão em §1.1).

Passo 2 · Pesquisar o público (sem parada)

Siga referencias/pesquisa-publico.md à risca. Em resumo:

1. Defina os avatares (buyer persona e lead protótipo) com o briefing e a landing.
2. Reúna fontes: com a busca web (WebSearch e WebFetch) ou, se tiver NotebookLM conectado, em um caderno com os materiais do negócio.
3. Busque a voz do público e o conhecimento com autoridade.
4. Classifique as fontes.
5. Responda às 11 perguntas fixas: sentimentos, interesses, o que precisa saber sobre o serviço, dúvidas, objeções, respostas para cada uma, momentos, ações para hoje, mitos, como escolher e limites.
6. Escreva pesquisa/publico.md com os avatares (A1…), as descobertas (H1…) e a tabela de dúvidas e objeções (D1…).

Leva cerca de 10 minutos. Enquanto roda, diga ao usuário em uma linha o que está fazendo. Se não tiver nenhuma ferramenta de busca, avise e peça material do especialista do negócio (perguntas frequentes das chamadas dele, avaliações, transcrições); não o substitua com conhecimento próprio.

Parada 1 · Diagnóstico e plano → OK

Crie marca.json (formato assets/exemplo-marca.json, regras design.md §2), fontes.md e plano.md. Mostre no chat, nesta ordem:

1. Legal, acima de tudo: 🟢 caixa de comunicações independente, ou 🔴 ausente/combinada/não verificável, com o texto literal das caixas. Se for 🔴, o aviso exato de legal-e-envio.md §1: entrega-se apenas o E0 (e o agendamento se houver agenda); o plano completo se propõe para o usuário saber o que vem, mas os emails de valor não são redigidos até que confirme a caixa. Se o formulário coletar dados sensíveis (art. 9 RGPD), diz-se aqui como [Geral]. Se o negócio não estiver na Espanha nem na UE, diz-se que estas regras são da Espanha e da UE e que deve confirmar as do seu país.

2. Discrição: se o avatar oculta o problema do seu círculo (copy-email.md §5), proponha: assunto e preheader sem a palavra sensível, mas dizendo igualmente do que se trata o email, e sem repetir suas respostas do formulário. O corpo sim nomeia o tema. O usuário confirma.

3. Ficha da oferta (tabela, cada dado com sua fonte: «briefing p. 3», «landing», «FAQ l. 120», «briefing (mensagem)»): serviço e promessa · avatares (A1…, definidos no Passo 2) · diferenciais · prova disponível (apenas a que existe e é verificável) · processo · preço ou do que depende · próximo passo real e sua URL · quem assina.

4. Formulário → variáveis e plataforma de envio: cada pergunta com seu campo ([[campo]]), suas opções e em qual email se usa (ou «em nenhum, por discrição»). E pergunte com o que se envia: n8n, ActiveCampaign, Brevo, Mailchimp… Não é um detalhe para o final: muda o arquivo que se entrega, as variáveis da saudação e o utm_source de marca.json (legal-e-envio.md §3.1). Se o negócio já paga uma plataforma, envia-se por ela. Saber no meio da sequência obriga a refazer os links de todos os emails.

5. Tipo de oferta (A/B/C/D de parametros.md §1) e por quê, em uma frase.

6. O que aprendemos sobre o público (de pesquisa/publico.md):

   • os avatares (A1…), em uma linha cada;
   • as 5-8 descobertas mais úteis (interesses e o que precisa saber incluídos), com id, citação curta e grupo da fonte (AUTORIDADE, PUBLICO ou CLIENTE);
   • as dúvidas e objeções mais frequentes (D1…), com as palavras do lead, a resposta (Hn) ou [FALTA: resposta do cliente], e em qual email se derruba cada uma.

   Os que colidem com o negócio ou precisam ser validados, marcados.

7. Plano da sequência (tabela): email · dia · tipo · situação do lead (Hn) · dúvida ou objeção que derruba (Dn → Hn) · o que sabe depois (Hn) · ação para hoje (Hn) · o que falta para o serviço · assunto provisório · CTA (suave/médio/forte e destino) · blocos. Quais colunas são obrigatórias em cada tipo de email: sequencia.md §2 e §2.1. Se uma obrigatória ficar vazia, esse email muda de ângulo ou é removido. As 5 dúvidas ou objeções mais frequentes devem estar cobertas antes do convite (no tipo D, as que não couberem, o convite responde). Adiciona-se a mini-sequência de agendamento apenas se houver agenda.

8. Identidade visual: logo (URL PNG/JPG ou «falta PNG»), acento, botão, tipografia de títulos, papel, e se os títulos vão em maiúsculas ou as citações sem itálico conforme o guia da marca.

9. Idioma e tratamento: variante do português e você, tu ou senhor(a), conforme a landing.

10. Dados que faltam, lista curta e numerada. Aqui vão também as decisões [Geral] e as descobertas marcadas «validar com o cliente» que o usuário deve confirmar.

Termine com: «Você aprova o plano da sequência? Não redijo nada sem seu OK.» Guarde estado.md: «Plano pendente de OK».

Cada email, em ordem (E0 → E1 → …)

Parada 2 · Copy → OK

Antes de escrever, leia copy-email.md (sobretudo §0, clareza antes de engenhosidade), brodie-email.md e os checks de títulos de ogilvy-email.md §0 (O1-O5). Redija com sequencia.md §3, dentro de parametros.md §3-§4. Regra que manda: entende-se do que se trata o email no assunto e nas duas primeiras frases, e tudo se diz com palavras da rua, sem mistério nem adivinhações. Cada dado novo vai para fontes.md. Passe pela compuerta de ogilvy-email.md §3 e guarde-a em eN/copy-auditoria.md.

Mostre:

• assunto recomendado e 2 alternativas;
• preheader e remetente;
• o texto de cada bloco em sua ordem, com as variáveis como [[campo]];
• que dúvida ou objeção derruba (Dn) e a frase que o faz;
• CTA e destino;
• a maquete: os blocos em ordem (parametros.md §4) e em que se diferencia do email anterior;
• a linha de resumo da compuerta.

Pergunte: «Você aprova o copy do email N?»

• Se a compuerta não aprovar após suas tentativas, mostre o copy marcado _PEND com o motivo. Só se monta com o OK explícito do usuário ou após aplicar suas alterações.
• Se faltar a resposta do negócio à dúvida principal do email ([FALTA: resposta do cliente]), não o redija. Informe o usuário e, com seu OK, marque-o «pendente de resposta» em estado.md e passe para o próximo email. Retome-o quando a resposta chegar, antes do fechamento da sequência.

Montagem e controle (sem parada, até 0 erros)

1. eN/ficha.json com o formato de assets/exemplo-ficha.json e o copy aprovado tal qual.
2. python3 ~/.claude/skills/email-secuencia-leads/scripts/build_email.py eN/ficha.json eN/email.html. Gera email.html (para n8n), email.txt e email-amostra.html.
   • Se sair um AVISO que obriga a alterar texto aprovado (comprimento, CTA, assunto), não o altere por conta própria: volte à Parada 2 com a correção proposta e peça o OK novamente. Os avisos puramente técnicos (cores, peso) corrigem-se em marca.json.
3. python3 ~/.claude/skills/email-secuencia-leads/scripts/qa_email.py eN/email.html até 0 erros.
4. python3 ~/.claude/skills/email-secuencia-leads/scripts/render_preview.py eN/email.html (precisa de Google Chrome ou Chromium e Pillow: pip install pillow). Veja com Leia preview-folha.png, preview-escuro.png e todos os trechos de previews-detalhe/. Critério: parece uma carta de uma marca cuidada, respira, o logo se lê no escuro, o acento é sóbrio, nada se desalinha no mobile. E não parece um template de IA: revise os sinais de design.md §1.1 (antetítulos, serifa de catálogo, creme e terracota inventadas, linhas longas, numeração decorativa). Se não houver Chrome, avise e peça ao usuário para abrir email-amostra.html no navegador.

Parada 3 · Email terminado → OK

Mostre preview-folha.png (com SendUserFile se a ferramenta existir; se não, dê o caminho). Dê o assunto e o preheader tal como vão na plataforma de envio (com expressões) e os caminhos de email.html e email.txt. No Mac, deixe o HTML na área de transferência…

… [truncado para tradução]