Ça fait plus d'un an qu'on automatise le reporting d'autres agences avec Claude Code. C'est le chantier le plus simple pour gagner du temps et récupérer de la marge : récolter la data, la mettre en forme, faire parler les chiffres avec le contexte du client, l'IA le fait très bien aujourd'hui.
La vidéo ci-dessus montre le résultat, puis la méthode en 4 étapes. Tout ce qui est dit dans la vidéo est repris ici, en checklists à cocher.
La règle avant de commencer : vise 90 à 95 % d'automatisation, jamais 100 %. Un humain relit toujours avant l'envoi. Sinon tu dégrades ton accompagnement, et ton client n'a plus de raison de payer. Le but, c'est plus de clients par consultant sans baisser la qualité, pas zéro consultant.
La méthode en 4 étapes
- La data. Récupérer les données de tous les comptes de tes clients : Google Ads, Meta Ads, Search Console, GA4, Brevo, Klaviyo… C'est l'étape la plus longue et la plus technique.
- Le contexte client. L'historique des comptes, tes messages avec le client, tes calls, sa typologie d'entreprise. C'est ce qui fait la qualité de l'analyse : l'IA doit savoir ce que savent tes consultants.
- Le support. Le format (slides ou page HTML), les graphiques à montrer, les templates à utiliser.
- Le LLM. Le prompt système, les skills, les outils, ton tone of voice. C'est la partie la plus simple, à condition d'avoir bien fait les 3 premières. Sans contexte, tu obtiens de la bouillie.
Étape 1 · La data
✅ Checklist Google Ads
C'est la source la plus pénible : l'accès à l'API demande une validation de Google, compte quelques jours. Lance la demande dès aujourd'hui.
- Avoir un compte administrateur Google Ads (MCC) et y lier les comptes de tes clients (le client accepte la demande de liaison depuis son compte).
- Noter l'ID du MCC (format
123-456-7890). Il servira delogin-customer-iddans chaque appel. - Dans le MCC : Outils → Centre API. Remplir le formulaire pour obtenir un jeton de développeur (developer token).
- Le jeton commence en accès « Compte de test ». Demander l'accès de base (Basic access) dans le même Centre API et attendre la validation de Google (quelques jours).
- Dans Google Cloud Console, activer l'API Google Ads sur le même projet que les autres API Google (voir la checklist Search Console + GA4 plus bas).
- Générer un refresh token OAuth avec le scope
https://www.googleapis.com/auth/adwords, connecté avec un compte qui a accès au MCC. - Ranger dans tes secrets (étape « Les secrets », plus bas) :
GOOGLE_ADS_DEVELOPER_TOKEN,GOOGLE_ADS_LOGIN_CUSTOMER_ID,GOOGLE_OAUTH_CLIENT_ID,GOOGLE_OAUTH_CLIENT_SECRET,GOOGLE_OAUTH_REFRESH_TOKEN. - Tester avec une requête GAQL simple (
SELECT customer.descriptive_name FROM customer) sur un compte client.
Avec le jeton et l'ID du MCC, tu peux tout faire avec l'API Google Ads.
✅ Checklist Meta Ads
Même principe : un jeton. Mais cette fois, c'est instantané.
- Dans le Business Manager (business.facebook.com) → Paramètres d'entreprise → Utilisateurs → Utilisateurs système : créer un utilisateur système (rôle Admin).
- Lui attribuer les comptes publicitaires de tes clients, avec au minimum l'accès « Voir les performances ».
- Sur developers.facebook.com : créer une application de type Business et lui ajouter le produit Marketing API.
- Rattacher l'app au Business Manager, puis générer le token de l'utilisateur système avec les permissions
ads_readetread_insights. Choisir l'expiration « Jamais ». - ⚠️ N'avoir que deux applications connectées à ton Business Manager. Au-delà, on a eu des problèmes d'accès.
- Un seul token pour tous les clients, pas un par client : c'est ce qu'on a vu de plus pénible à maintenir chez les agences.
- Ranger le token dans tes secrets :
META_SYSTEM_USER_TOKEN. - Tester avec un appel
GET /me/adaccounts: tu dois voir tous les comptes de tes clients.
✅ Checklist Search Console + GA4
Les API Google « classiques ». Tout se passe dans Google Cloud Console (console.cloud.google.com).
- Créer un projet Google Cloud. Un seul projet pour toutes les API Google (Ads, Search Console, GA4, Slides, Sheets, Drive) : sinon les fichiers créés par un projet sont invisibles pour l'autre.
- API et services → Bibliothèque : activer Google Search Console API, Google Analytics Data API et Google Analytics Admin API (plus Google Ads API, Slides, Sheets et Drive si tu sors des decks Google).
- Configurer l'écran de consentement OAuth (« Interne » si tu es sur Google Workspace).
- Identifiants → Créer → ID client OAuth → Application Web. Ajouter l'URL de redirection de ton app (et
https://developers.google.com/oauthplaygroundpour générer un token à la main). - Générer un refresh token avec les scopes
webmasters.readonlyetanalytics.readonly, connecté avec le compte de l'agence qui a accès aux propriétés des clients. - Côté client : te faire ajouter en Lecteur sur la propriété GA4, et en utilisateur sur la propriété Search Console.
- Noter pour chaque client l'ID de propriété GA4 (un nombre comme
123456789, pas un vieuxUA-…) et la propriété Search Console exacte (https://site.com/ousc-domain:site.com). - Tester : un rapport sessions sur 7 jours dans GA4, une requête
searchAnalytics/querydans Search Console.
✅ Checklist Brevo, Klaviyo et les autres
Plus simple : des clés d'API, à l'échelle d'un client ou d'un compte entier.
- Brevo : Paramètres → SMTP & API → Clés API → générer une clé.
- Klaviyo : Paramètres → Clés API → créer une clé privée en lecture seule.
- Une clé par client si chaque client a son compte, une seule clé si tu gères tout depuis un compte agence.
- Toutes les sources ont une API, sauf de très rares cas. Même là, il y a toujours une combine (export programmé, connecteur, etc.).
✅ Les secrets : Claude ne voit jamais tes clés
Tu donnes tout ça à Claude de manière sécurisée. Jamais une clé collée dans le chat.
- Installer la CLI Vercel (
npm i -g vercel) et lier ton projet (vercel link). - Ajouter chaque clé dans les variables d'environnement du projet :
vercel env add NOM_DE_LA_CLE(ou depuis le dashboard Vercel → Settings → Environment Variables). - Récupérer les variables en local avec
vercel env pull .env.local. Vérifier que.env.localest bien dans le.gitignore. - Dire à Claude : « Les clés sont dans les variables d'environnement, lis-les avec
process.env, ne les affiche jamais. » Claude écrit le code qui les utilise sans jamais les avoir en clair.
Étape 2 · Le contexte client
C'est ce qui fait la différence entre « vos clics baissent de 12 % » et « vos clics baissent de 12 % depuis l'arrêt des campagnes de notoriété décidé en réunion le 3 ».
- Enregistrer tes calls clients (Fathom, tl;dv, Fireflies…) et récupérer les transcriptions ou les résumés.
- Récupérer l'historique des échanges : Slack, Gmail, WhatsApp, LinkedIn, Telegram… Tout est accessible en API aujourd'hui.
- Pour aller vite, passer par un agrégateur d'API de messagerie comme Unipile ou Zernio, qui fait ce travail à ta place.
- Ajouter l'historique des comptes (ce qui a été fait, testé, arrêté) et la typologie d'entreprise (e-commerce, lead gen, B2B, panier moyen, marge…).
- Connecter tout ça à ton app, et le donner à Claude résumé, pas brut : quelques faits datés par client.
Étape 3 · Le support
On utilise encore Claude. Avant de lancer, décide :
- Le format : un deck Google Slides (familier pour le client) ou une page HTML brandée, qui peut se mettre à jour tous les jours comme un mini-portail client.
- Les graphiques à montrer par section, et les templates à respecter (souvent celui que l'agence a déjà).
- Pour du design propre avec Claude : Refero Styles (refero.design) pour l'inspiration, et shadcn/ui (ui.shadcn.com) pour les composants. Tu obtiens de bonnes pages HTML, de bonnes animations et de bons graphiques.
Étape 4 · Le LLM
- Pour tester plusieurs modèles, passer par un agrégateur comme OpenRouter (ou Ollama pour des modèles en local). Attention, ça coûte un peu plus cher : l'agrégateur prend sa commission. Je le conseille en phase de test.
- Une fois le modèle choisi : une clé d'API directe chez le fournisseur, dans tes secrets.
- Écrire le prompt système : ce que l'IA doit produire, ce qu'elle n'a pas le droit d'inventer, la longueur des textes.
- Lui donner ses skills et ses outils (lire les données, lire le deck, proposer une modification…).
- Fixer le tone of voice : comment tu t'adresses à tes clients, comment tu mets en jambes les chiffres, comment tu as l'habitude de faire parler la data. Le plus efficace : coller 2 ou 3 de tes anciens rapports en exemple.
Le prompt de départ à coller dans Claude Code
Une fois les 4 étapes prêtes, tu demandes à Claude de tout mettre en œuvre dans une application complète :
Construis une app Next.js (déployée sur Vercel, base Supabase) qui génère le
reporting mensuel de mes clients d'agence.
Données : Google Ads (API Google Ads, MCC), Meta Ads (Marketing API, token
utilisateur système), GA4 (Analytics Data API), Search Console, Brevo/Klaviyo.
Toutes les clés sont dans les variables d'environnement : lis-les avec
process.env, ne les affiche et ne les loggue jamais.
Écrans :
1. Un cockpit des connexions : une ligne par client, une colonne par source,
vert/orange/rouge selon un VRAI appel API (pas la présence d'un identifiant),
avec l'action à faire en français.
2. Un générateur : choix du client et de la période (comparaison période
précédente et N-1), choix des conversions à suivre, génération du rapport.
3. Le rapport : [slides Google / page HTML brandée], une phrase d'analyse par
section et des recommandations chiffrées.
Contexte client : pour chaque client, un résumé (calls, messages, historique,
typologie) injecté dans le prompt d'analyse.
Règles d'analyse : n'invente aucun chiffre, une seule base de comparaison par
phrase, unités toujours présentes, vouvoiement, ton : [colle 2 exemples de tes
rapports]. Rien n'est envoyé au client automatiquement : un humain relit.
Commence par le cockpit des connexions, puis le générateur.
Respecte ces étapes et tu as le reporting de tes rêves, automatisé à 90 %.
Annexe · Comment on l'a construit pour deux agences
Le retour d'expérience complet : l'architecture, le pipeline, les prompts et les pièges.
0. Ce que fait le système, en 3 écrans
1. Le déclencheur. Le consultant choisit le client et la période (mois précédent, trimestre, période personnalisée). Il choisit ensuite les conversions à analyser : un bouton « Détecter » liste les événements clés GA4 et les actions Meta réellement présents sur la période, avec leurs volumes. Il peut aussi décocher des sections ou masquer les écarts. Il clique sur « Générer ». La progression s'affiche en direct. À la fin, il a trois liens : la présentation, la feuille de données, et « Relire avec l'assistant ».
2. L'éditeur de deck assisté. Les vignettes des slides à gauche, l'aperçu au centre, l'assistant IA à droite. L'assistant ne modifie jamais rien tout seul. Il propose des cartes « Appliquer / Ignorer » : un texte réécrit, une slide supprimée, une slide ajoutée, un graphique redessiné. L'humain clique, et chaque modification peut être annulée.
3. Le cockpit des connexions. Une ligne par client, une colonne par plateforme (Google Ads, GA4, Search Console, Meta, Notion). Chaque case est verte, orange ou rouge, avec un diagnostic en français et l'action à faire (« le compte n'est pas lié au MCC, demander l'accès au client »). C'est l'écran qui a le plus changé la vie des équipes : avant, on découvrait qu'un accès était cassé le jour de l'envoi.
Rien ne part automatiquement au client. C'est un choix : l'IA prépare, un humain valide.
1. L'architecture
Référentiel clients (Notion) ◄── synchro ──► Supabase
│
Navigateur ──► App Next.js (Vercel) ───────────┤
│ │
├── webhook ──► n8n « Génération »
│ ├ Notion : fiche client
│ ├ Drive : copie du gabarit Slides + Sheets
│ ├ Google Ads, GA4, Search Console, Meta
│ ├ Sheets : onglets de données
│ ├ IA : phrases d'analyse + recommandations
│ ├ App : graphiques en PNG
│ └ Slides : textes, KPIs, images, nettoyage
├── webhook ──► n8n « Sonde des connexions »
├── webhook ──► n8n « Accès aux decks »
└── API Claude : assistant de relecture
La stack :
- Next.js 16 (App Router) + Tailwind + shadcn/ui pour l'app, hébergée sur Vercel.
- Supabase pour la base, l'authentification et le stockage des documents clients.
- n8n pour la collecte des données. Les agences avaient déjà leur instance et un workflow de reporting existant : on l'a repris et durci au lieu de tout réécrire.
- Claude (API Anthropic) pour l'assistant de relecture et la lecture des documents clients, plus des agents IA dans n8n pour les phrases d'analyse.
- Google Slides + Sheets pour le livrable. Les clients finaux reçoivent un format qu'ils connaissent déjà.
La règle qui structure tout : l'app ne détient aucun accès
L'app n'a aucun credential Google, Meta ou Notion. Tous les accès restent dans n8n, chez l'agence. Quand l'app a besoin de lire un deck ou de tester une connexion, elle appelle un petit workflow n8n dédié, protégé par un secret partagé dans un en-tête HTTP.
Pourquoi c'est important :
- L'agence garde la main sur ses accès. Elle peut révoquer l'app sans toucher à ses comptes Google.
- Une fuite côté app n'ouvre pas les comptes publicitaires des clients.
- Un seul endroit à maintenir quand un token expire.
2. Brancher chaque outil
C'est la partie que tout le monde sous-estime. Le code se fait en quelques jours. Les accès, c'est des semaines si tu ne fais pas ça proprement.
Google Ads. Un credential OAuth2 dans n8n, le developer token de l'agence et l'ID du MCC (login-customer-id) en en-têtes. Les requêtes passent en REST avec GAQL (googleAds:search). Mets la version de l'API, le MCC et le token dans un seul node de config : on les a trouvés copiés dans 12 nodes différents, et Google supprime les vieilles versions d'API sans prévenir.
GA4. Le node natif Google Analytics de n8n, en OAuth. La propriété GA4 est un nombre (ex. 123456789), pas l'ancien identifiant UA-…. On a trouvé 14 clients avec un identifiant Universal Analytics stocké à la place du GA4. Sur ces clients, le rapport sortait vide sans aucune erreur.
Search Console. OAuth2, endpoint searchAnalytics/query. Piège classique : la propriété doit être encodée dans l'URL (encodeURIComponent), et elle peut être https://site.com/ ou sc-domain:site.com. Si elle est déjà encodée dans ton référentiel et que tu la ré-encodes, tu obtiens http%253A… et une erreur 400.
Google Slides, Sheets et Drive. Trois credentials OAuth, et ils doivent venir du même projet Google Cloud. Le scope drive.file ne voit que les fichiers créés par le même projet. On avait trois projets GCP qui cohabitaient, et les graphiques Sheets refusaient de s'insérer dans Slides (« spreadsheet could not be found »). Partager la feuille publiquement ne change rien. On a fini par sortir les graphiques de Sheets (voir §4).
Meta. Le cas le plus pénible. Une des deux agences avait 24 tokens différents, un par client, aiguillés par un Switch écrit en dur. On a testé les 30 tokens de l'instance un par un avec un vrai appel me/adaccounts : 24 étaient valides et ouvraient 117 comptes publicitaires, 6 étaient morts. La cible propre, c'est un utilisateur système du Business Manager avec ads_read, et un seul token. En attendant, l'app permet de coller un token par client. Il est stocké côté serveur uniquement, et seuls les 4 derniers caractères s'affichent.
Notion. Le référentiel clients des agences (nom, cadence de reporting, les 4 identifiants de comptes). Synchronisé avec Supabase dans les deux sens (voir §6).
Les accès à demander au client final, en un seul mail : lecteur sur GA4, utilisateur sur Search Console, liaison du compte Google Ads au MCC de l'agence, ads_read sur le Business Manager Meta.
3. Le pipeline, étape par étape
1. Le clic. L'app vérifie que le client existe, que son reporting est actif et qu'aucun autre rapport n'est en cours pour lui (sinon un double clic lance deux runs).
2. Les identifiants. Ceux affichés dans le cockpit l'emportent sur Notion. La règle : ce que tu vois dans l'app, c'est ce que le rapport utilise.
3. Les conversions. Dans l'ordre : ce que le consultant a coché, sinon les règles enregistrées pour ce client, sinon une détection automatique sur la période. Sans ce dernier filet, un client sans règle avait une slide Conversions vide alors que GA4 comptait 912 leads.
4. Le contexte. L'app assemble un bloc de texte pour l'IA, plafonné à 12 000 caractères : le client, la période, les sections hors périmètre (« ne pas les commenter »), les conversions qui comptent, les termes de marque, les paramètres business (taux lead vers client, panier moyen, marge) et les notes de l'équipe. Il contient aussi le résumé des documents déposés : comptes rendus de réunion, objectifs, brief.
5. Le webhook. L'app crée une ligne reporting_runs en statut queued, puis appelle n8n avec {notionId, startDate, endDate, selectedConversions, overrides, contextText, sections, display}.
6. Les périodes. n8n calcule trois fenêtres : la période, la période précédente (même durée, qui finit la veille) et la même période à N-1. Plus une série de 11 mois pour les graphiques d'évolution.
7. La copie du gabarit. Le gabarit Slides et le gabarit Sheets sont dupliqués dans le dossier de sortie Drive, puis partagés au domaine de l'agence.
8. La collecte. Quatre branches en parallèle : GA4 (8 rapports), Google Ads (11 requêtes GAQL), Search Console, Meta. Chaque branche écrit ses données dans un onglet de la feuille. Si une régie n'est pas branchée ou si sa section est décochée, la section est retirée du deck au lieu de laisser des trous.
9. L'IA. Une phrase d'analyse par slide de KPIs et des recommandations SEA, SEO et Social (prompts au §5).
10. Les textes. Les placeholders du gabarit ([Slide5], [datePeriod], [AméliorationsSEA]…) sont remplacés via l'API Slides (replaceAllText).
11. Les graphiques. n8n envoie les données à l'app, qui renvoie des images PNG (voir §4).
12. La passe finale. Elle renumérote les sections, supprime les intercalaires devenus orphelins et vide les zones d'écart masquées. Elle tourne une seule fois, après tout le reste.
13. Le suivi. L'app interroge l'API n8n toutes les quelques secondes. Elle affiche l'étape en cours, récupère l'ID du deck à la fin, et traduit une erreur en phrase française. Un run peut finir « Terminé avec réserves » : le deck est là, mais une section a été retirée parce qu'un accès était refusé.
4. Les graphiques : pourquoi on les dessine nous-mêmes
L'approche classique, c'est d'insérer des graphiques Google Sheets liés dans Slides. On l'a abandonnée. Elle dépend des projets GCP (voir §2), les graphiques sortent en anglais, avec un cadre noir, et vides quand la feuille est mal partagée.
À la place, l'app rend les graphiques en PNG :
- n8n lit les plages de la feuille (
values:batchGet) et les poste à/api/charts, avec un secret en en-tête. - L'app construit une description du graphique (barres, colonnes, courbes, tableau, bulles) et la compresse dans l'URL de l'image : deflate, base64url, puis une signature HMAC.
- Elle répond avec des requêtes
replaceAllShapesWithImageque n8n envoie à Slides. - Google Slides va chercher l'image à cette URL. L'app la dessine à la volée avec
next/og, à 2× la taille du placeholder, avec la police du deck embarquée.
Rien n'est stocké. Une URL falsifiée reçoit un 403. Une section sans données produit une carte propre avec une phrase (« Aucune campagne Meta active sur la période ») au lieu d'un graphique vide.
Deux détails :
- Slides refuse les URLs d'image de plus de 2 ko. L'app réduit la description jusqu'à passer sous la limite.
- L'image hérite du contour du placeholder. Une seconde requête retire la bordure. Elle part à part, pour qu'un échec cosmétique ne coûte jamais un graphique.
5. L'IA : où elle écrit, et les prompts
Les phrases d'analyse (une par slide de KPIs)
Chaque agent reçoit les KPIs de sa slide, les deltas et le contexte client. Voici les consignes communes, à copier :
Tu écris UNE phrase de 15 à 25 mots, en français avec accents, en texte brut
(pas de guillemets, pas de markdown, pas de JSON).
Message d'abord : le chiffre principal, son sens, la base de comparaison dite
explicitement, puis la cause si les données la montrent. Une seule base par phrase.
« delta » = vs période précédente, « delta2 » = vs N-1. Choisis la plus parlante
et nomme-la.
Vouvoiement, langage business (leads, coût par lead, CA, panier moyen).
Unités toujours présentes, format français (1 353 ; 24,8 %).
N'invente aucun chiffre. Aucune excuse, aucune formule défensive.
Un zéro se décrit pour ce qu'il mesure, jamais au-delà : écris « aucun évènement
clé enregistré sur la période », jamais « aucune activité sur votre site ».
Mets le zéro en regard du trafic s'il est fourni.
Utilise le contexte client pour expliquer les variations et traduire les
conversions en valeur business.
<contexte_client>{{ contexte }}</contexte_client>
La règle du zéro vient d'un vrai incident. L'IA avait écrit « aucune activité sur votre site » pour un client qui avait 286 utilisateurs sur la période. Il n'avait simplement aucun événement clé configuré. Ce genre de phrase, envoyée au client, coûte la crédibilité de l'agence.
Les recommandations (SEA, SEO, Social)
Donne 3 ou 4 recommandations, une par ligne, sans intro, sans titre, sans puce.
Chacune : un verbe à l'infinitif, une cible précise, au moins un chiffre tiré des
données, l'impact attendu et une échéance. 30 mots maximum.
Vouvoiement, langage business.
Derrière, un petit script nettoie la sortie : il découpe les lignes, retire les puces et les numéros, supprime la ligne d'intro qui finit par « : », garde 4 lignes maximum et réduit la police si c'est long. L'API Slides ne sait pas faire d'autofit, donc c'est à toi de borner la longueur.
La relecture du deck (Claude)
L'assistant a six outils : lire le deck, lire la feuille de données, et proposer quatre types de modifications. Les règles de son prompt :
- toujours commencer par lire le deck ;
- ne jamais écrire, seulement proposer ;
- ne jamais inventer un chiffre ;
- un titre tient sur 1 ou 2 lignes, un commentaire fait 35 mots maximum ;
- ne pas toucher à la couverture, aux intercalaires ni à la slide de fin.
En mode « audit », il applique la grille de l'agence en 10 points : cohérence du récit, résumé en ouverture, un message fort par titre, causes hiérarchisées et chiffrées, transformer les questions en « nous recommandons X à partir du [date], validez-vous ? », lien au business, une base de comparaison par section, le ton, la forme. Il rend un verdict en 2 phrases, les 3 priorités, puis une proposition concrète pour chacune.
C'est lui qui a trouvé le pire bug du projet (voir §7, piège n°1), en remarquant que deux onglets ne racontaient pas la même chose.
Les documents du client
L'équipe peut déposer un PDF, un compte rendu ou un brief, ou écrire une note en Markdown dans l'app. Claude lit le fichier une seule fois, au dépôt, et le condense en 150 mots de faits datés (ou « RIEN D'UTILE »). Seul ce résumé part dans le contexte. Une note courte (moins de 2 000 caractères) est reprise mot pour mot : elle est déjà triée, la condenser ne ferait que la déformer.
Résultat concret : une slide a expliqué une hausse du coût par lead « suite à l'arrêt des campagnes de notoriété ». Cette cause n'apparaît dans aucune donnée. Elle venait du compte rendu de réunion déposé la veille.
6. Le cockpit des connexions
La règle d'or : un accès ne se juge jamais sur l'existence d'un credential. Seulement sur un vrai appel.
Pour chaque client et chaque plateforme, la sonde n8n fait un appel réel et léger :
- Google Ads : une requête
customeren GAQL ; - GA4 : un rapport sessions sur 7 jours ;
- Search Console : une requête
searchAnalytics; - Meta : une lecture
act_…; - Notion : la lecture de la fiche.
Elle renvoie {ok, httpStatus, detail}. L'app traduit ensuite en verdict (vert / orange / rouge) et en phrase française avec l'action à faire. Le détail brut est stocké, jamais affiché.
Un cron Vercel re-sonde chaque nuit les connexions qui n'ont pas été vérifiées depuis plus de 20 h, 6 en parallèle. Le matin, l'équipe voit ce qui a cassé avant d'en avoir besoin.
Le jour de la mise en route, sur 42 clients, 25 avaient au moins un accès refusé. Personne ne le savait.
La synchro avec Notion
Le référentiel clients reste dans Notion, parce que c'est là que l'équipe travaille. Il est synchronisé avec Supabase dans les deux sens, avec deux protections :
- Une correction faite dans l'app n'est jamais écrasée par la synchro suivante. Elle part dans une file d'attente avec l'ancienne valeur. Tant qu'elle n'est pas remontée dans Notion, la descente ne l'écrase pas.
- Si les deux côtés ont changé, rien n'est écrasé en silence : le conflit est signalé avec les deux valeurs.
Attention aux conventions d'écriture : un identifiant Google Ads s'écrit 123-456-7890 d'un côté et 1234567890 de l'autre. Sans normalisation, la synchro réécrit les mêmes valeurs à l'infini.
7. Les 12 pièges qui nous ont coûté le plus cher
1. Des chiffres inventés, depuis toujours. Dans le workflow hérité, une ligne de code multipliait les conversions par 10 et divisait le coût par 4,2. Le commentaire disait « scale like in your sheet ». Le ROAS était marqué « fictif, pour l'exemple ». C'était faux sur 11 mois, pour tous les clients. Audite le workflow existant avant de le durcir. On l'a corrigé en reprenant les valeurs brutes de l'API.
2. Un seul 403 tuait tout le rapport. Un accès refusé sur une régie, et le client n'avait pas de deck du tout. Chaque node de collecte a maintenant une sortie d'erreur câblée vers le node qui retire la section concernée.
3. Le mois qui déborde. date.setMonth(m - 10) garde le quantième du jour. Un 31 décembre moins 10 mois donne « 31 février », donc le 3 mars : février disparaît du graphique. Utilise Date.UTC(y, m - 10, 1).
4. Le taux de conversion faux. On affichait 0,16 % au lieu de 0,70 %. Le dénominateur était la somme des utilisateurs de chaque événement, et non le nombre d'utilisateurs affiché sur la slide.
5. Meta compte trois fois le même achat. Meta renvoie le même événement en pixel, onsite, omni et agrégat. Un filtre « contient purchase » additionne tout. Garde une seule couche par événement (le pixel en priorité). Et par défaut, ne retiens que l'étape la plus profonde du tunnel (achat ou lead, sinon checkout, sinon panier) pour ne pas compter deux fois le même visiteur.
6. La mauvaise fenêtre. Les recommandations SEA tournaient sur les « 14 derniers jours », dans un rapport sur un mois passé. Toutes les requêtes doivent prendre la période du rapport.
7. Le modèle IA retiré. Le workflow appelait un ancien modèle Claude, retiré par Anthropic. Le résultat était une erreur 404 et plus aucun rapport. Centralise le nom du modèle et surveille les dépréciations.
8. Une réponse IA mal formée tuait le deck. Ajoute 3 essais automatiques. Si les trois échouent, mets le texte « À compléter avant envoi. » au lieu de planter. Un texte vide fait aussi échouer l'API Slides.
9. Les slides supprimées deux fois. Plusieurs nodes de nettoyage visaient la même slide. La deuxième suppression renvoyait une erreur 400 et le run s'arrêtait. Chaque section a maintenant un seul responsable, et les IDs viennent d'un seul node central.
10. La numérotation écrite en dur. Quand une section était retirée, le deck s'ouvrait sur « 2 ». Une passe finale détecte maintenant les intercalaires par leur structure et renumérote. Elle ne fait rien si les numéros ne sont pas croissants, et la relancer ne change rien.
11. Les variables d'environnement collées avec un guillemet. Une clé API n8n collée dans Vercel avec un retour à la ligne invisible a laissé un run « En cours » pendant 45 minutes sans explication. Toutes les variables passent maintenant par une fonction qui retire blancs et guillemets. Une erreur d'API n8n s'affiche en clair au lieu d'être avalée.
12. On ne modifie plus n8n à la main. Un workflow de 250 nodes ne se corrige pas en cliquant dans l'éditeur. Chaque correction est un script qui :
- tourne à blanc par défaut ;
- sauvegarde le workflow avant et après ;
- refuse de s'appliquer si le code attendu a bougé ;
- vérifie que chaque node Code compile (
new Function(code)) avant d'envoyer.
Ce dernier garde-fou vient d'un \d devenu d dans un template literal : la sonde a ignoré toutes les dates pendant des jours sans rien dire.
9. Ce qu'on ferait différemment
- Commencer par le cockpit des connexions, pas par le deck. Le premier jour, 25 clients sur 42 avaient un accès cassé, et chacun ressemblait à un bug du reporting.
- Auditer les chiffres du workflow existant avant d'y toucher. On a hérité de chiffres multipliés par 10. Personne ne l'avait remarqué, parce que personne ne recalculait.
- Un seul projet Google Cloud et un utilisateur système Meta, dès le départ.
- Faire relire chaque rapport par l'assistant avant envoi. L'IA recopie très bien les chiffres. Elle se trompe encore sur les pourcentages et les ratios qu'elle calcule elle-même. La relecture est là pour ça.













