delivrabilite-email

Délivrabilité email — gate pré-envoi & runbook incident

Ce skill est le GATE obligatoire de tout envoi de masse : il valide la liste et contrôle la copy AVANT qu'un lot parte, impose la cadence de montée en charge, et fournit le runbook quand la délivrabilité casse.

Adapté des fiches docs/methodo/ops/delivrabilite-email.md et cold-email-cadence.md (distillation coldoutboundskills, MIT © 2026 GrowthEngineX — voir docs/methodo/ops/NOTICE.md), exécution via RapidoCRM.

Règle d'invocation OBLIGATOIRE

Ce skill est invoqué avant tout lot d'envoi. Un lot sous le seuil KB est REFUSÉ — pas d'envoi tant que la liste n'est pas corrigée.

• machine-outbound → mode outbound (cold email).
• rapidocrm:campagne-marketing → mode newsletter (câblé, conditionnel à la présence du plugin rapido-marketing ; sinon checklist minimale côté rapidocrm).

Modes (paramètre du contrat)

Le skill s'invoque avec un mode :

• outbound (défaut, cold email/prospection) — tout le gate : scorecard de liste + spam_check + plafonds + cadence/warmup de delivrabilite.md.
• newsletter (envoi à une base opt-in existante) — scorecard d'hygiène (doublons, formats invalides, emails de rôle) + spam_check du copy
  • présence du lien de désinscription (bloquante) + taille du lot vs plafond ; PAS de règles de warmup/cadence (base déjà consentante).

Même seuil de refus, mêmes scripts dans les deux modes — aucune duplication : seule la couche warmup/cadence est retirée en newsletter, où l'absence de lien de désinscription (spam_check → controles.lien_desinscription: false) est bloquante.

Étape 0 — Charger (obligatoire)

• ./rapido-kb/marketing/delivrabilite.md — plafond quotidien, calendrier de montée en charge, seuil de note minimale, règles de pause. Absent → le créer depuis ${CLAUDE_PLUGIN_ROOT}/reference/kb-templates/delivrabilite.md. (En mode newsletter, seuls plafond et seuil sont utilisés ; warmup/cadence ignorés.)
• ${CLAUDE_PLUGIN_ROOT}/reference/garde-fous-marketing.md (§a envois confirmés, §b RGPD, §c délivrabilité) et docs/methodo/etat-de-lart-2026.md §4 (warmup, plafonds, rotation — chiffres de référence).
• ./rapido-kb/marketing/apprentissages.md (incidents/leçons passés — priment).

Gate pré-envoi (bloquant)

1. Scorecard de liste — REFUS si sous le seuil

• python3 "${CLAUDE_PLUGIN_ROOT}/skills/delivrabilite-email/scripts/scorecard_liste.py" liste.json
• Entrée : le segment/export (contacts avec titre, ou emails), le plafond_quotidien et le seuil_note lus dans delivrabilite.md.
• Sortie chiffrée (formule affichée) : doublons, emails de rôle (info@, contact@…), formats invalides, diversité des titres, concentration de domaines, taille du lot vs plafond → note A-E + actions correctives.
• refus: true (note sous le seuil) ⇒ on n'envoie pas. Aucune dérogation sans modifier explicitement delivrabilite.md (traçable). Appliquer les actions correctives, puis rejouer le scorecard.

2. Contrôle de la copy

• python3 "${CLAUDE_PLUGIN_ROOT}/skills/delivrabilite-email/scripts/spam_check.py" copy.json (objet + corps) → lexique à risque FR/EN, densité de liens, excès de majuscules, ponctuation agressive, promesses chiffrées → signalements + note de risque (faible/moyen/élevé).
• Le script signale seulement : la réécriture est déléguée à rapidocrm:redaction-commerciale (pas de doublon). Re-contrôler après réécriture.
• Mode newsletter : controles.lien_desinscription doit être true — sinon REFUS du lot (obligation légale d'un lien de désinscription).

3. Volumes & cadence

• Plafond quotidien (les deux modes) : jamais au-delà ; fractionner un lot trop gros sur plusieurs jours (taille du lot vs plafond de delivrabilite.md).
• Cadence / warmup — mode outbound uniquement : respecter le calendrier de montée en charge de delivrabilite.md. En newsletter, ces règles ne s'appliquent pas (base opt-in déjà consentante).
• Chaque lot reste soumis au hook garde-envois (confirmation humaine explicite) — ce gate ne remplace pas la confirmation, il la précède.
• Envoi/planification via RapidoCRM : send_email, schedule_email, send_newsletter (désinscription honorée immédiatement — RGPD).

Suivi post-envoi

• Lire ce que le serveur expose réellement : get_stats_campagne ({success, total, par_statut[]} — audit M0) et list_campagnes.
• Limite connue : les bounces/plaintes par destinataire ne sont pas exposés comme signal de délivrabilité exploitable. C'est consigné comme outil MCP manquant avec spec dans docs/OUTILS-MCP-MANQUANTS.md (entrée 1) — à faire porter par le backend (Tunis). En attendant : suivi au niveau statut de campagne, sans taux de bounce fin.

Runbook incident (délivrabilité qui casse)

1. Signaux : chute brutale des réponses ou pic d'échecs (au niveau des statuts de campagne, faute de taux de bounce fin).
2. PAUSE : suspendre les lots à venir (ne plus rien confirmer). L'annulation des envois déjà planifiés nécessite un outil d'annulation CRM non exposé à ce jour (voir docs/OUTILS-MCP-MANQUANTS.md entrée 3) — le signaler ; sinon documenter les planifications non annulables.
3. Diagnostic (checklist) : authentification SPF/DKIM/DMARC valide (côté client) ? liste récemment élargie ? copy modifiée ? volume monté trop vite ? → purger les emails invalides (rejouer le scorecard), vérifier l'auth.
4. Reprise progressive : revenir 1-2 crans en arrière dans le calendrier, ne pas “pousser plus” sur un domaine qui décroche.
5. Capitalisation : consigner l'incident et la reprise dans ./rapido-kb/marketing/apprentissages.md (date | contexte | leçon | preuve | skill source), via mise-a-jour-kb. Pas de leçon sans preuve chiffrée.

Modes dégradés

• Infra warmup/rotation absente (pas d'équivalent Smartlead) : audit + méthode + garde-fous restent applicables ; l'infra de montée en charge se fait via un outil externe → docs/OUTILS-MCP-MANQUANTS.md (entrée 2).
• Bounces non exposés : suivi au statut de campagne (ci-dessus).

Cas d'usage croisés

• Réécriture de la copy signalée → rapidocrm:redaction-commerciale.
• Séquences & cadence outbound → machine-outbound.
• Campagnes CRM → rapidocrm:campagne-marketing.

Garde-fous (rappel)

Gate avant tout lot ; REFUS si note < seuil KB (pas de dérogation sans modifier delivrabilite.md) ; jamais au-delà du plafond ; chaque lot confirmé (garde-envois) ; scores par script (jamais de tête) ; RGPD (désinscription immédiate) ; capacités manquantes consignées, jamais inventées.