diegogwork1-alt/email-secuencia-leads

Séquence d'e-mails pour les leads · post-formulaire

Qui est qui : l'utilisateur est celui qui te parle et approuve. L'entreprise (ou client) est la société pour laquelle les e-mails sont créés : elle peut être celle de l'utilisateur ou celle pour laquelle il fait le marketing. Le lead est la personne qui a rempli le formulaire et recevra les e-mails. Dans ce fichier, « tu » es le modèle.

Tu prépares ; l'utilisateur décide et approuve. Il y a trois étapes et à chacune tu t'arrêtes et tu attends. Il n'y a pas de mode « continue sans t'arrêter » : si l'utilisateur le demande, tu lui dis que la compétence s'arrête à chaque e-mail et tu passes à l'étape suivante.

Ce qui compte comme OK : « OK », « approuvé », « vas-y », « suivant » ou « oui » sans demander de modifications. Toute réponse avec une modification, un doute ou un « bien, mais… » n'est pas OK : tu appliques la modification, tu réaffiches la même étape et tu redemandes.

Langue. Les e-mails sont en français. Par défaut, français de France et tutoiement ; si la page d'atterrissage de l'entreprise utilise une autre variante (français du Canada, vouvoiement), on suit la page. Cela est confirmé à l'Étape 1.

Où sont les scripts. Dans le dossier de cette compétence, normalement ~/.claude/skills/email-secuencia-leads/. Si tu l'as installée ailleurs (par exemple dans .claude/skills/ d'un projet), change ce chemin dans les commandes.

Les trois règles

1. N'invente pas de données sur l'entreprise. Les prix, délais, garanties, cas, chiffres, témoignages, noms et URLs proviennent uniquement du brief, de la page, des réponses du formulaire et des documents fournis par l'utilisateur. S'il manque quelque chose, écris [MANQUE : quoi] et demande-le ; build_email.py ne monte pas un e-mail avec [MANQUE.
2. La valeur avant la vente, et sans doutes non résolus. Le lead a déjà demandé à être contacté. Chaque e-mail à valeur ajoutée passe le test de secuencia.md §2 (ce qu'il sait après · action pour aujourd'hui · ce qui reste pour le service). Minimum 80/20. De plus, chaque e-mail élimine au moins un doute ou une objection fréquente concernant le service, avec une réponse sourcée (secuencia.md §2.1). C'est obligatoire.
3. Hiérarchie des sources (secuencia.md §5) : données de l'entreprise → uniquement ses documents ; connaissance du public → la recherche de l'Étape 2, avec citation et uniquement des sources d'autorité pour les conseils et les chiffres ; pratique des e-mails → parametros.md ; loi et bon sens (RGPD, LSSI, numéros d'urgence, réglementation du secteur) → autorisé, étiqueté [Général] et confirmé par l'utilisateur à l'Étape 1. Si quelque chose de la recherche entre en conflit avec l'entreprise, c'est l'entreprise qui prime. Si le brief et la page se contredisent, c'est le brief qui prime et on signale.

Glossaire (lis-le avant de commencer)

• Fiche : eN/ficha.json, le contenu d'un e-mail ; le script le convertit en HTML et TXT.
• eN/ : dossier de chaque e-mail dans la séquence : e0/, e1/, e2/…
• Bloc : morceau du template (carta, pasos, cita…), liste dans parametros.md §4.
• Variable : donnée du formulaire dans le texte, [[nom]] ou [[nom|fallback]] ; dans n8n, elle devient {{ $json.nom }}.
• CTA doux / moyen / fort : question pour répondre ou lien vers quelque chose à lire / lien en texte vers la prochaine étape avec l'entreprise / bouton. Le bouton uniquement dans l'invitation, dans la mini-séquence de rendez-vous (sauf no-show-2) et dans l'E0 s'il y a une prise de rendez-vous en ligne (règle complète dans parametros.md §3).
• Mini-séquence de rendez-vous : cita-confirmacion, cita-recordatorio, no-show et no-show-2 ; uniquement s'il y a une prise de rendez-vous en ligne.
• Breakup : dernier e-mail, 2-4 phrases, ferme avec élégance.
• Barrière de copy : révision obligatoire du copy avant le montage (ogilvy-email.md §3). Elle est enregistrée dans eN/copy-auditoria.md.
• fuentes.md : liste de chaque donnée utilisée avec sa source et sa citation ; créée à l'Étape 1 et complétée à chaque e-mail.
• estado.md : quels e-mails sont approuvés et à quelle étape tu te trouves ; permet de reprendre une session interrompue.

Étape 0 · Ce qu'il faut

Normalement, tu reçois dans un message le brief et la page d'atterrissage. Vérifie ce que tu as :

• Brief : PDF, Word, texte collé dans le message ou chemin vers un fichier. Un brief court dans le message lui-même suffit (ce qui est vendu, à qui, prix ou de quoi il dépend, processus, garanties, qui s'en occupe). S'il y a un brief.md dans le dossier, lis-le.
• Page d'atterrissage : URL publiée ou fichier HTML. Si on te donne un dossier, cherche index.html ou dist/index.html à l'intérieur.
• Facultatif : qui signe (nom, poste, email, photo), prise de rendez-vous en ligne, documents supplémentaires (guide de style, questions fréquentes, transcriptions d'appels, avis), ce qu'il faut mettre en avant ou éviter.

Si le brief ou la page manquent, ta première réponse est uniquement de demander ce qui manque, en une ligne :

Pour préparer la séquence, il me manque [le brief de l'entreprise / la page d'atterrissage avec le formulaire] . Envoie-le-moi et je commence.

Ne demande pas ce que tu as déjà. Si plusieurs documents sont fournis, lis-les tous et cite-les par leur nom dans la fiche de l'offre.

Étape 1 · Lire (sans arrêt)

Dossier de travail : emails/secuencia-<AAAA-MM-DD d'aujourd'hui>/ dans le dossier du projet (la date, avec date +%F). Si une séquence de l'entreprise existe déjà avec estado.md, lis-le et reprends là où ça s'est arrêté au lieu de recommencer de zéro.

• Brief → brief.txt. PDF : Lis avec pages, ou python3 -c "import fitz,sys;print('\n'.join(p.get_text() for p in fitz.open(sys.argv[1])))" fichier.pdf. Word : textutil -convert txt -stdout fichier.docx sur Mac, ou python3 -c "import docx,sys;print('\n'.join(p.text for p in docx.Document(sys.argv[1]).paragraphs))" fichier.docx. Texte du message : il est enregistré tel quel et la source est citée « brief (message) ».
• Page d'atterrissage → python3 ~/.claude/skills/email-secuencia-leads/scripts/leer_landing.py "<URL ou fichier>" --salida <dossier>/landing et ouvre landing/landing.md. Lis les formulaires natifs et ceux de Tally (intégrés ou en fenêtre pop-up). Si le formulaire vient d'un autre fournisseur, demande à l'utilisateur les questions et les cases. Si l'URL donne une erreur, demande le HTML. Garde toujours une copie du HTML lu.
• Ouvre parametros.md, secuencia.md, legal-y-envio.md §1 et diseno.md §1-§3 (les signaux de conception IA sont dans §1.1).

Étape 2 · Étudier le public (sans arrêt)

Suis references/investigacion-publico.md à la lettre. En résumé :

1. Définis les avatars (buyer persona et lead prototype) avec le brief et la page.
2. Rassemble les sources : avec la recherche Web (WebSearch et WebFetch) ou, si tu as NotebookLM connecté, dans un carnet avec les documents de l'entreprise.
3. Cherche la voix du public et les connaissances d'autorité.
4. Classe les sources.
5. Réponds aux 11 questions fixes : sentiments, intérêts, ce qu'il a besoin de savoir sur le service, doutes, objections, réponses à chacune, moments, actions pour aujourd'hui, mythes, comment choisir et limites.
6. Écris investigacion/publico.md avec les avatars (A1…), les découvertes (D1…) et le tableau des doutes et objections (O1…).

Cela prend environ 10 minutes. Pendant l'exécution, dis à l'utilisateur en une ligne ce que tu fais. Si tu n'as aucun outil de recherche, dis-le et demande du matériel de l'expert de l'entreprise (questions fréquentes de ses appels, avis, transcriptions) ; ne le remplace pas par tes propres connaissances.

Étape 1 · Diagnostic et plan → OK

Crée marca.json (format assets/ejemplo-marca.json, règles diseno.md §2), fuentes.md et plan.md. Affiche dans le chat, dans cet ordre :

1. Légal, tout en haut : 🟢 case de communications indépendante, ou 🔴 absente/combinée/non vérifiable, avec le texte littéral des cases. Si c'est 🔴, l'avertissement exact de legal-y-envio.md §1 : seul l'E0 (et le rendez-vous s'il y a une prise de rendez-vous) est fourni ; le plan complet est proposé pour que l'utilisateur sache ce qui vient, mais les e-mails à valeur ajoutée ne sont pas rédigés tant que la case n'est pas confirmée. Si le formulaire recueille des données sensibles (art. 9 RGPD), cela est dit ici comme [Général]. Si l'entreprise n'est ni en Espagne ni dans l'UE, on dit que ces règles sont celles de l'Espagne et de l'UE et qu'elle doit confirmer celles de son pays.

2. Discrétion : si l'avatar cache le problème à son entourage (copy-email.md §5), tu le proposes : objet et pré-en-tête sans le mot sensible, mais en disant quand même de quoi parle l'e-mail, et sans répéter ses réponses du formulaire. Le corps, lui, nomme le sujet. L'utilisateur confirme.

3. Fiche de l'offre (tableau, chaque donnée avec sa source : « brief p. 3 », « page », « FAQ l. 120 », « brief (message) ») : service et promesse · avatars (A1…, définis à l'Étape 2) · différentiateurs · essai disponible (uniquement celui qui existe et est vérifiable) · processus · prix ou de quoi il dépend · prochaine étape réelle et son URL · qui signe.

4. Formulaire → variables et plateforme d'envoi : chaque question avec son champ ([[champ]]), ses options et dans quel e-mail il est utilisé (ou « dans aucun, par discrétion »). Et demande avec quoi il est envoyé : n8n, ActiveCampaign, Brevo, Mailchimp… Ce n'est pas un détail pour la fin : cela change le fichier fourni, les variables de la salutation et le utm_source de marca.json (legal-y-envio.md §3.1). Si l'entreprise paie déjà une plateforme, l'envoi se fait depuis celle-ci. Le savoir au milieu de la séquence oblige à refaire les liens de tous les e-mails.

5. Type d'offre (A/B/C/D de parametros.md §1) et pourquoi, en une phrase.

6. Ce que nous avons appris du public (de investigacion/publico.md) :

   • les avatars (A1…), en une ligne chacun ;
   • les 5-8 découvertes les plus utiles (intérêts et ce qu'il a besoin de savoir inclus), avec id, citation courte et groupe de la source (AUTORITE, PUBLIC ou CLIENT) ;
   • les doutes et objections les plus fréquentes (O1…), avec les mots du lead, la réponse (Dn) ou [MANQUE : réponse du client], et dans quel e-mail chacune est éliminée.

   Ceux qui entrent en conflit avec l'entreprise ou doivent être validés sont marqués.

7. Plan de la séquence (tableau) : e-mail · jour · type · situation du lead (Dn) · doute ou objection éliminée (On → Dn) · ce qu'il sait après (Dn) · action pour aujourd'hui (Dn) · ce qui reste pour le service · objet provisoire · CTA (doux/moyen/fort et destination) · blocs. Quelles colonnes sont obligatoires pour chaque type d'e-mail : secuencia.md §2 et §2.1. Si une colonne obligatoire reste vide, cet e-mail change d'angle ou est supprimé. Les 5 doutes ou objections les plus fréquentes doivent être couvertes avant l'invitation (dans le type D, celles qui ne tiennent pas sont répondues par l'invitation). La mini-séquence de rendez-vous est ajoutée uniquement s'il y a une prise de rendez-vous.

8. Identité visuelle : logo (URL PNG/JPG ou « manque PNG »), accent, bouton, typographie des titres, papier, et si les titres sont en majuscules ou les citations sans italique selon le guide de la marque.

9. Langue et traitement : variante du français et tutoiement, vouvoiement ou « vous » de politesse, selon la page.

10. Données manquantes, liste courte et numérotée. Ici, les décisions [Général] et les découvertes marquées « valider avec le client » que l'utilisateur doit confirmer.

Termine par : « Approuves-tu le plan de la séquence ? Je ne rédige rien sans ton OK. » Enregistre estado.md : « Plan en attente d'OK ».

Chaque e-mail, dans l'ordre (E0 → E1 → …)

Étape 2 · Copy → OK

Avant d'écrire, lis copy-email.md (surtout §0, clarté avant ingéniosité), brodie-email.md et les vérifications des titres de ogilvy-email.md §0 (O1-O5). Rédige avec secuencia.md §3, dans parametros.md §3-§4. Règle qui prime : on comprend de quoi parle l'e-mail dans l'objet et dans les deux premières phrases, et tout est dit avec des mots de tous les jours, sans mystère ni devinettes. Chaque nouvelle donnée va dans fuentes.md. Passe la barrière de ogilvy-email.md §3 et enregistre-la dans eN/copy-auditoria.md.

Affiche :

• objet recommandé et 2 alternatives ;
• pré-en-tête et expéditeur ;
• le texte de chaque bloc dans son ordre, avec les variables comme [[champ]] ;
• quel doute ou objection il élimine (On) et la phrase qui le fait ;
• CTA et destination ;
• la maquette : les blocs dans l'ordre (parametros.md §4) et en quoi elle diffère de l'e-mail précédent ;
• la ligne de résumé de la barrière.

Demande : « Approuves-tu le copy de l'e-mail N ? »

• Si la barrière n'approuve pas après ses tentatives, tu affiches le copy marqué _PEND avec le motif. Il n'est monté qu'avec l'OK explicite de l'utilisateur ou après application de ses modifications.
• Si la réponse de l'entreprise au doute principal de l'e-mail manque ([MANQUE : réponse du client]), tu ne le rédiges pas. Tu le dis à l'utilisateur et, avec son OK, tu le marques « en attente de réponse » dans estado.md et tu passes à l'e-mail suivant. Tu le reprends quand la réponse arrive, avant la clôture de la séquence.

Montage et contrôle (sans arrêt, jusqu'à 0 erreurs)

1. eN/ficha.json avec le format de assets/ejemplo-ficha.json et le copy approuvé tel quel.
2. python3 ~/.claude/skills/email-secuencia-leads/scripts/build_email.py eN/ficha.json eN/email.html. Génère email.html (pour n8n), email.txt et email-muestra.html.
   • Si un AVIS qui oblige à changer du texte approuvé (longueur, CTA, objet) apparaît, ne le change pas de ton propre chef : retourne à l'Étape 2 avec la correction proposée et redemande l'OK. Les avis purement techniques (couleurs, poids) sont corrigés dans marca.json.
3. python3 ~/.claude/skills/email-secuencia-leads/scripts/qa_email.py eN/email.html jusqu'à 0 erreurs.
4. python3 ~/.claude/skills/email-secuencia-leads/scripts/render_preview.py eN/email.html (nécessite Google Chrome ou Chromium et Pillow : pip install pillow). Regarde avec Read preview-hoja.png, preview-oscuro.png et tous les tronçons de previews-detalle/. Critère : on dirait une lettre d'une marque soignée, elle respire, le logo se lit en sombre, l'accent est sobre, rien ne se décale sur mobile. Et on ne dirait pas un template IA : vérifie les signaux de diseno.md §1.1 (pré-titres, sérif de catalogue, crème et terre cuite inventées, longues lignes, numérotation décorative). S'il n'y a pas Chrome, dis-le et demande à l'utilisateur d'ouvrir email-muestra.html dans le navigateur.

Étape 3 · E-mail terminé → OK

Affiche preview-hoja.png (avec SendUserFile si l'outil existe ; sinon, donne le chemin). Donne l'objet et le pré-en-tête tels qu'ils iront dans la plateforme d'envoi (avec les expressions) et les chemins de email.html et email.txt. Sur Mac, mets le HTML dans le presse-papier.