Fiche Technique: Mission Newsletter Mensuelle
Système de synchronisation Huss → HubSpot avec Claude Pro
1. Contexte et Problématique
Le scénario métier
Rocateq envoie une newsletter mensuelle à ses clients France via HubSpot. Problème: la liste d'envoi n'est pas synchronisée avec Huss, le CRM administratif qui fait foi sur "qui est client".
Les problèmes identifiés
- Nouveaux clients oubliés: Ils sont dans Huss mais pas dans la liste newsletter HubSpot
- Doublons potentiels: Un même contact peut exister dans les deux systèmes
- Risque RGPD: Des contacts désinscrits ne doivent jamais être réimportés
- Pas d'API Huss: Export manuel CSV obligatoire
La solution construite
Un Claude Project dédié avec connexion MCP Google Drive et un Skill de rapprochement qui:
- Compare automatiquement les exports Huss et HubSpot
- Détecte les doublons et les exclusions (désinscrits, rebonds)
- Génère les fichiers CSV d'import prêts pour HubSpot
- Archive tout dans Google Drive
2. Architecture du Système
Flux de données mensuel
📊 Export Huss (xlsx)
→
📁 Google Drive
→
🤖 Claude Project
→
⚡ Skill Rapprochement
→
📋 Rapport + CSV
→
📧 Import HubSpot
Composants du système
| Composant |
Rôle |
Localisation |
| Project "Newsletter Rocateq" |
Contexte, règles, instructions permanentes |
Claude Pro |
| MCP Google Drive |
Lecture des exports, écriture des rapports |
Connecteur Claude |
| Skill "newsletter-contacts-hubspot" |
Script de rapprochement reproductible |
Claude Pro |
| Knowledge Base |
Règles RGPD, checklist mensuelle |
Claude Project |
| Dossier NEWSLETTER MENSUELLE |
Entrées, traitements, archives |
Google Drive |
3. Structure Google Drive
NEWSLETTER MENSUELLE/
├── 01_ENTREES/
│ └── AAAA-MM/
│ ├── AAAA-MM_export_huss.xlsx
│ ├── AAAA-MM_export_hubspot_contacts.csv
│ └── AAAA-MM_export_hubspot_liste.csv
│
├── 02_TRAITEMENTS/
│ └── AAAA-MM/
│ ├── AAAA-MM_rapport_rapprochement.xlsx
│ ├── AAAA-MM_import_hubspot_nouveaux.csv
│ └── AAAA-MM_import_hubspot_ajout_liste.csv
│
├── 03_NEWSLETTER/
│ └── AAAA-MM/
│ ├── AAAA-MM_newsletter_brouillon.gdoc
│ └── AAAA-MM_bilan_envoi.gdoc
│
└── 04_REFERENTIEL/
├── tone_of_voice.md
└── templates_email.html
4. Procédure Mensuelle Pas à Pas
Phase 1: Préparation (J-7 avant envoi)
1
Exporter Huss
Dans le CRM Huss, exporter les clients actifs avec:
- Email, Nom, Prénom, Société
- Code client Huss
- Code postal, Ville, Pays
Nommage: AAAA-MM_export_huss.xlsx
Destination: 01_ENTREES/AAAA-MM/
2
Exporter HubSpot - Tous les contacts
Contacts → Tous les contacts → Exporter avec:
- Email
- Désabonné de tous les e-mails (Unsubscribed from all email)
- Email hard bounce reason
- Email address quarantined
- Marketing contact status
Nommage: AAAA-MM_export_hubspot_contacts.csv
3
Exporter HubSpot - Liste newsletter
Listes → [Nom de la liste newsletter] → Exporter
Nommage: AAAA-MM_export_hubspot_liste.csv
Note: Optionnel si la liste est de type "active"
Phase 2: Traitement Claude
4
Ouvrir une nouvelle conversation dans le Project
Dans Claude → Project "Newsletter Rocateq" → Nouvelle conversation
Message d'entrée:
Mise à jour newsletter 2026-10
Si MCP Drive actif: Claude lit automatiquement le dossier 01_ENTREES/2026-10/
Sinon: Déposer les 3 fichiers dans la conversation
5
Analyser le rapport de rapprochement
Claude exécute le Skill et produit un rapport avec:
- Synthèse chiffrée: Nouveaux, Existants, À ajouter à la liste, Exclus
- Alertes: Contacts à vérifier (adresses génériques, fautes de frappe)
- Onglet A_VERIFIER: Décisions manuelles requises
⚠️ Alerte BLOQUANT = L'export HubSpot ne contient pas les désinscrits. Refaire l'export avec les bonnes colonnes.
6
Valider les cas à vérifier
Pour chaque contact dans A_VERIFIER, décider:
- Garder: "OK pour contact@entreprise.com" (adresse générique mais seul contact)
- Écarter: "Exclure jean.dupon@gmial.com" (faute de frappe, à corriger dans Huss)
7
Générer les fichiers définitifs
Après validation, écrire:
OK, génère les fichiers définitifs
Claude produit dans 02_TRAITEMENTS/AAAA-MM/:
AAAA-MM_import_hubspot_nouveaux.csv → Nouveaux contacts à créer
AAAA-MM_import_hubspot_ajout_liste.csv → Contacts existants à ajouter à la liste
AAAA-MM_rapport_rapprochement.xlsx → Archive complète
Phase 3: Import HubSpot
8
Importer les nouveaux contacts
HubSpot → Contacts → Importer → import_hubspot_nouveaux.csv
- Définir comme contacts marketing
- Mapper les colonnes: Email, Prénom, Nom, Société, code_client_huss, date_import_huss
9
Ajouter à la liste newsletter
HubSpot → Contacts → Importer → import_hubspot_ajout_liste.csv
Ces contacts existent déjà, ils sont juste ajoutés à la liste newsletter.
10
Contrôler l'import
- Vérifier le rapport d'erreurs HubSpot
- Compter les membres de la liste:
Ancien total + Nouveaux + Ajouts = Nouveau total
- Archiver le rapport dans
02_TRAITEMENTS/AAAA-MM/
5. Variantes: Avec et Sans MCP
Phase 1 Sans MCP HubSpot
Situation actuelle
- Export HubSpot manuel (3 fichiers)
- Import CSV manuel dans HubSpot
- Validation humaine à chaque étape
Temps: 25-30 min/mois
Phase 2 Avec MCP HubSpot
Évolution possible
- Claude lit directement les contacts HubSpot
- Plus d'export HubSpot manuel
- Contrôle post-import automatique
Temps: 15-20 min/mois
Évolution vers l'automatisation complète
| Phase |
Déclencheur |
Actions Claude |
Actions Eric |
| Phase 1 |
Message dans conversation |
Rapprochement + fichiers CSV |
3 exports + 2 imports + contrôle |
| Phase 2 |
Message dans conversation |
Lecture HubSpot + rapprochement + fichiers CSV |
1 export Huss + 2 imports + contrôle |
| Phase 3 |
Email de Us avec export joint |
MCP Gmail → rapprochement → fichiers CSV |
2 imports + contrôle |
Scénario Phase 3: Automatisation via MCP Gmail
Avec la validation de Us (CRM administratif), un export mensuel peut être envoyé automatiquement par email.
Workflow envisagé:
- Us envoie l'export CSV par email à une adresse dédiée
- MCP Gmail détecte l'email et déclenche le Project
- Claude extrait la pièce jointe, exécute le Skill
- Les fichiers d'import sont générés automatiquement
- Eric reçoit une notification et importe dans HubSpot
Note: L'import dans HubSpot reste manuel pour garder un contrôle humain.
6. Règles RGPD et Qualité
Exclusions obligatoires
- Désinscrit de tous les e-mails → Exclu définitivement
- Rebond définitif (hard bounce) → Exclu
- Signalé comme spam → Exclu
- Hors France → Hors périmètre
Cas à vérifier manuellement
- Adresses génériques (contact@, compta@) → OK si seul contact B2B
- Fautes de frappe (gmial.com, .con) → Corriger dans Huss
- Pays vide mais CP 5 chiffres → Considéré France
Traçabilité dans HubSpot
Chaque contact importé porte deux propriétés personnalisées:
code_client_huss : Identifiant client dans Huss
date_import_huss : Date du dernier import (format AAAA-MM-01)
7. Checklist Mensuelle