Rapport KPI Saycom · automatisation n8n

Vous tapez le nom du client et la période (3, 6, 12 mois ou dates libres). En 10 à 15 secondes, n8n va chercher les chiffres dans GA4, Google Business Profile, SayRank, la base des formulaires et Google Maps, puis renvoie le rapport HTML complet aux couleurs Saycom.

• 9 workflows actifs, 87 nodes au total
• 9 + 10 comptes Google routés (GA4 + GBP)
• 10 à 15 s pour un rapport complet

• Ce que vous donnez : Le nom du client tel qu'il est dans EXPORT_SAYRANK, et la période. La comparaison avec l'année précédente (N-1) est calculée toute seule.
• Ce que fait le système : Il vérifie la demande, retrouve le client, choisit le bon compte Google, interroge 6 sources en parallèle, puis cherche les concurrents.
• Ce que vous recevez : Une page HTML prête à montrer ou imprimer. Si une source est en panne, le rapport sort quand même, avec la case concernée vide.

1. Le parcours d'une demande

1. La demande arrive. Soun remplit le formulaire (nom + période), ou un outil appelle l'API directement.
2. WF0 vérifie. La demande est-elle complète ? Le client existe-t-il dans EXPORT_SAYRANK ? Est-il branché à GA4, GBP et SayRank ? Sinon : erreur claire.
3. Six collectes en parallèle. GA4, performances GBP, avis, SayRank, fiche Google et e-mails reçus. Les sub-workflows choisissent le bon compte Google.
4. Merge KPIs attend les 6 réponses, même celles en panne, pour ne jamais bloquer le rapport.
5. Les concurrents. Une recherche Google Maps « métier + ville » via SerpApi, ou le résultat gardé en cache 30 jours.
6. Compute derived met tout en forme : chiffres en français, évolutions N vs N-1, flèches, blocs à afficher ou masquer.
7. WF6 remplit le template du rapport aux couleurs Saycom.
8. Le rapport HTML revient au formulaire ou à l'outil appelant, en 10 à 15 secondes.

2. Les 9 workflows, node par node

Pour chaque workflow : son ID, son rôle, ce qu'il reçoit, ce qu'il renvoie, puis chaque node dans l'ordre du flux.

{
  "Nom du client": "MENUISERIE VINCENT PIERRE",
  "Période": "3 derniers mois"
}

fichier binaire "report"
  mimeType: text/html
  fileName: rapport-kpi.html

{
  "company_name": "MENUISERIE VINCENT PIERRE",
  "period_months": 3
}
ou
{
  "company_name": "MENUISERIE VINCENT PIERRE",
  "period_n":  {"date_from":"2026-03-01","date_to":"2026-03-31"},
  "period_n1": {"date_from":"2025-03-01","date_to":"2025-03-31"}
}

200  Content-Type: text/html
<!DOCTYPE html> … rapport complet

400/404/422  application/json
{"error":"company_not_found",
 "message":"Entreprise '…' introuvable dans EXPORT_SAYRANK.",
 "field":"company_name", "details":{…}}

{
  "company_name": "MENUISERIE VINCENT PIERRE",
  "period_n":  {"date_from":"2026-03-01","date_to":"2026-03-31"},
  "period_n1": {"date_from":"2025-03-01","date_to":"2025-03-31"}
}

{
  "ok": true,
  "metrics": {
    "sessions_n": <nombre>, "sessions_n1": <nombre>,
    "delta_sessions_pct": <nombre>,
    "activeUsers_n": …, "newUsers_n": …,
    "screenPageViews_n": …, "avgSessionDuration_n": …,
    "userEngagementDuration_n": …,
    "devices": {"mobile":…, "desktop":…, "tablet":…},
    "sources": [{"name":"Organic Search","sessions":…}]
  }
}

{
  "company_name": "MENUISERIE VINCENT PIERRE",
  "period_n":  {"date_from":"2026-03-01","date_to":"2026-03-31"},
  "period_n1": {"date_from":"2025-03-01","date_to":"2025-03-31"}
}

{
  "ok": true,
  "metrics": {
    "apparitions_n": <nombre>, "apparitions_n1": <nombre>,
    "calls_n": …, "website_clicks_n": …,
    "directions_n": …, "conversations_n": …
  },
  "totals_n": {…}, "totals_n1": {…}
}

{ "company_name": "MENUISERIE VINCENT PIERRE" }

{
  "ok": true,
  "reviews": {
    "count": <nombre>, "note": <nombre>,
    "distribution": {"1":…,"2":…,"3":…,"4":…,"5":…},
    "pagination_truncated": false
  }
}

{ "codecrm": "CL…", "company_name": "MENUISERIE VINCENT PIERRE" }

{
  "ok": true,
  "positions_total": <nombre>,
  "top1_count": …, "top3_count": …, "top10_count": …,
  "top3_keywords": [{"mot_cle":"…","position":…}],
  "mots_cles_rates": [ … ],
  "all_keywords": [ … ]
}

{
  "data": {
    "NOM_CLIENT": "…", "PERIODE": "3 mois",
    "SESSIONS_N": "…", "HAS_REVIEWS": true,
    "CONCURRENTS": [ … ], …
  }
}

<!DOCTYPE html>
<html lang="fr"> … </html>

{
  "ga4_email": "saycomgmb@gmail.com",
  "ga4_property_id": "<ID GA4>",
  "body": { "requests": [ … ] }
}

{ "reports": [ {"rows":[…]}, {"rows":[…]}, {"rows":[…]} ] }

{
  "gbp_email_local": "recuperationsaycomgmb",
  "url": "https://mybusiness.googleapis.com/v4/…/reviews?pageSize=50",
  "method": "GET"
}

{ "reviews": [ … ] }  ou  { "multiDailyMetricTimeSeries": [ … ] }

3. D'où vient chaque chiffre du rapport

Une ligne par source de données : le workflow qui la lit, et les variables du rapport qu'elle remplit. Les noms en majuscules sont les cases du template.

Les variables sont toutes calculées dans le node Compute derived de WF0, à partir des réponses brutes. Les flags HAS_… affichent ou masquent un bloc entier du rapport.

4. Erreurs et dégradation

Deux familles : la demande est fausse (le système refuse avec un message clair), ou une source est en panne (le rapport sort quand même).

1. La demande est refusée

Réponse JSON {error, message, field, details}. Le front doit se baser sur error, qui ne change jamais.

2. Une source tombe : rapport dégradé, pas d'échec

Les 6 appels de collecte et l'appel SerpApi sont réglés sur onError = continueRegularOutput. Une source en panne laisse sa case vide (— ou 0) ou masque son bloc.

5. Maintenance

Ajouter un compte Google

Un nouveau client branché sur un compte Google que n8n ne connaît pas encore.

1. Créer le credential dans n8n : Google Analytics OAuth2 pour GA4, Google OAuth2 API pour GBP. Garder la convention de nom : Google Analytics account - <email> et Google account - <partie avant @>.
2. Dans sub-ga4-call : ajouter une règle au Switch ga4_email (égalité exacte, sensible à la casse, sur l'email complet), dupliquer un node GA4 - …, lui donner le nouveau credential, le brancher sur une nouvelle entrée du Merge (augmenter son nombre d'entrées).
3. Dans sub-gbp-call : même chose sur le Switch gbp_email, mais la règle compare la partie avant le @ (gbp_email_local).
4. Remplir email_ga4 / email_gbp et les IDs du client dans EXPORT_SAYRANK, puis lancer un rapport test.

Attention : les Switch n'ont pas de sortie par défaut. Un email absent des règles ne lève pas d'erreur, la source revient simplement vide dans le rapport.

Modifier le template ou WF0

1. Le template rendu est template-suivi-client-v4.html, mais il est régénéré par retokenize_v4.py depuis template-v4-new.html. Une retouche faite à la main sur le fichier rendu est perdue à la régénération : passer par un rep() dans le script.
2. Déployer avec deploy_v4.py wf6 (ou wf0, form). Le script ré-encode le template en base64 dans Render mustache, fait un PUT sur l'ID live (pas de doublon) et écrit d'abord un backup backup-live-<ID>-<slot>.json. Option --dry-run pour voir sans écrire.
3. Les identifiants n8n se chargent depuis .env (jamais commité).
4. Le backup est l'état d'avant le déploiement. Pour auditer ce qui tourne vraiment, relire le workflow live via l'API (GET /api/v1/workflows/<id>).

deploy_v4.py ne couvre que WF0, WF6 et WF-Form. WF1 à WF4 et les deux sub-workflows se modifient dans l'éditeur n8n (ou via redeploy.py).

Règles à ne pas casser

• Ne jamais toucher au workflow legacy k4gIRb1GRvKc15sW (ancien rapport Google Slides, environ 250 nodes). Il ne fait pas partie de ce système.
• EXPORT_SAYRANK est la seule source de vérité pour les clients (sheet 1AO6prkiy1oL55Z4ibgya9gc2EgKQ4atiRHmK3qqArY0, onglets « Feuille 1 » et « Liste entreprise Sayrank »). Les anciennes sheets d'inventaire GA4 et GBP sont obsolètes.
• Pas de mode keypair pour des paramètres de requête répétés dans un node HTTP : n8n dédoublonne les clés. Les 8 dailyMetrics GBP sont donc écrits en dur dans l'URL (node Lookup de WF2).
• Les nodes Execute Workflow portent l'ID du sub-workflow en dur. Si un sub-workflow est recréé, il faut repatcher ces IDs (patch_subwf_refs.py) avant d'activer.
• Mustache, pas Handlebars : Handlebars plante dans le sandbox n8n. Pas de {{ littéral dans le JS du template.
• Les noms des nodes comptent : le code lit d'autres nodes par leur nom ($('Lookup unique'), $('Merge KPIs')…). Renommer un node casse ces références.

6. Points ouverts

• 🔴 Bloquant · Compte saycom.mcpte révoqué
  Le compte Google saycom.mcpte@gmail.com est signalé révoqué (GA4 et GBP, invalid_grant) depuis le 16/08/2026 : 20 lignes sur les 60 premières de la sheet passent par lui. Leurs rapports sortent sans trafic, appels ni avis. Reconnexion à faire côté Saycom.
• 🟠 À surveiller · Quota SerpApi : 250 recherches par mois
  Compte en offre gratuite. Le cache de 30 jours évite de repayer un même client, mais un grand nombre de nouveaux rapports dans le mois peut épuiser le quota (le bloc concurrents se masque alors).
• 🟠 À surveiller · 637 clients sans site_ga4
  637 lignes sur 1 339 n'ont pas de site_ga4. Le comptage des e-mails se replie sur la colonne domain ; il reste une centaine de lignes sans site ni domaine exploitable, qui sortent à 0 e-mail.
• 🟠 À surveiller · WF3 renvoie 0 avis pour MENUISERIE VINCENT PIERRE
  Réponse ok: true, count: 0, sans erreur. La note Google manque donc dans tout son rapport. Cause non trouvée à ce jour.
• 🟠 À surveiller · Avis limités à 50
  WF3 ne lit qu'une page de 50 avis : au-delà, le nombre affiché plafonne à 50 et la note est calculée sur ces 50 avis.
• 🟢 Info · Mode TEST
  WF0, WF6 et le formulaire sont les variantes « TEST inline HTML » : pas de stockage du rapport, pas de PDF ni de lien partageable pour l'instant, pas d'authentification sur le webhook.

7. Glossaire

GA4

Google Analytics 4 : l'outil de Google qui mesure les visites du site du client.

GBP

Google Business Profile : la fiche de l'entreprise sur Google et Maps (appels, itinéraires, avis).

codecrm

L'identifiant du client dans SayRank (format CL…). À ne pas confondre avec l'ID Saycom de la sheet.

Webhook

Une adresse web qui déclenche un workflow quand on lui envoie une requête. Exemple : /webhook/kpi/report.

Sub-workflow

Un petit workflow réutilisable appelé par d'autres, ici pour choisir le bon compte Google.

Mustache

Le moteur de template : il remplace chaque {{VARIABLE}} du modèle HTML par sa valeur.

Credential

Un accès enregistré dans n8n (compte Google, base, clé API). Les workflows le désignent par son nom.

EXPORT_SAYRANK

La Google Sheet de référence : une ligne par client, avec ses comptes et ses IDs.

N / N-1

La période étudiée (N) et la même période un an plus tôt (N-1), pour comparer.