Guide d'intégration Zapier

Réponse rapide : automatisez les rapports Surmado avec Zapier. Faites pointer le webhook_url de Surmado vers un déclencheur Catch Hook de Zapier. Zapier reçoit le payload de fin de rapport (avec les métriques du résumé déjà extraites) et le transmet à Google Sheets, Slack, Notion ou par e-mail. Pour des données plus détaillées, ajoutez ensuite un appel à l’API REST avec votre clé d’API. Cinq workflows courants sont inclus : suivi trimestriel, alertes concurrentielles, tableaux Notion, synthèses Strategy et reporting multi-clients pour agences.

Temps de lecture : 18 minutes

Dans ce guide :

• Créez une automatisation de suivi trimestriel en recevant le webhook report.completed de Surmado, en lisant report.summary.presence_score et les champs associés, puis en ajoutant une ligne dans Google Sheets (3 tâches Zapier par Job)
• Créez des alertes concurrentielles en cas de positionnement faible avec Filter by Zapier sur report.summary.competitive_rank, puis publiez dans Slack uniquement si le rang est supérieur à 3 (4 tâches lorsque l’alerte se déclenche)
• Configurez l’intégration d’une base Notion pour les rapports Site Audit avec report.summary.seo_score, performance_score, accessibility_score et critical_issues_count, plus l’objet quick_wins (4 tâches par Job)
• Envoyez des synthèses Strategy à la direction : les webhooks Strategy n’incluent pas de résumé, mais vous recevez report.pdf_url (un lien magique valable 30 jours) que vous pouvez intégrer directement dans un e-mail (3 tâches par Job)
• Créez un tableau de bord multi-clients pour agences qui alimente une feuille Google Sheets principale avec les métriques de tous les clients, en utilisant report.summary.business_name du payload comme filtre client (3 à 4 tâches par rapport client)

Coût : le forfait Starter de Zapier ($20/mois) prend en charge ces workflows.

---

Prérequis

Ce dont vous avez besoin

1. Un compte Zapier (forfait Starter au minimum pour les Zaps à plusieurs étapes)
2. Un compte Surmado avec accès à l’API (inclus dans tous les forfaits : PAYG, Pro et Pro+)
3. Une clé d’API Surmado (sur_live_...) : créez-la sur app.surmado.com dans Settings → API Keys
4. Un compte pour l’application de destination (Google Sheets, Slack, Notion, etc.)

Forfaits Zapier requis

Forfait gratuit :

• 100 tâches/mois
• Zaps à une seule étape uniquement
• Insuffisant pour les workflows Surmado (qui demandent plusieurs étapes)

Forfait Starter ($20/mois) :

• 750 tâches/mois
• Zaps à plusieurs étapes (indispensable)
• Minimum recommandé

Forfait Professional ($50/mois) :

• Zaps illimités
• Paths (logique conditionnelle)
• Recommandé pour les agences qui gèrent plusieurs clients

---

Le schéma d’intégration

Les cinq workflows ci-dessous suivent la même structure :

1. Déclencheur : Webhooks by Zapier, « Catch Hook ». Zapier vous donne une URL unique.
2. Configurez Surmado pour envoyer (POST) les rapports terminés à cette URL en indiquant webhook_url à la création du rapport.
3. Analysez le payload reçu. Zapier aplatit le JSON imbriqué avec __ (double tiret bas) : report.summary.presence_score devient donc report__summary__presence_score dans le sélecteur de champs de Zapier.
4. (Facultatif) Appel à l’API REST si vous avez besoin de champs au-delà du résumé. Appelez GET https://api.surmado.com/v1/reports/{{report__id}} avec l’en-tête Authorization: Bearer sur_live_YOUR_KEY.
5. Agissez : écrivez dans Google Sheets, publiez dans Slack, créez une page Notion, etc.

Exemple de payload de webhook

{
  "event": "report.completed",
  "timestamp": "2026-04-15T12:00:00+00:00",
  "report": {
    "id": "rpt_abc123xyz",
    "token": "SIG-2026-04-A1B2C",
    "product": "signal",
    "status": "completed",
    "tier": "basic",
    "data_url": "https://api.surmado.com/v1/reports/rpt_abc123xyz",
    "pdf_url": "https://api.surmado.com/v1/reports/view/VIEW_TOKEN",
    "summary": {
      "business_name": "Acme Coffee Roasters",
      "industry": "Food & Beverage",
      "brand_url": "https://acme.com",
      "presence_score": 34.2,
      "authority_score": 42.7,
      "competitive_rank": 4,
      "top_competitor": "Blue Bottle",
      "insights_summary": ["Presence score: 34.2 (↑5.5)", "..."]
    }
  }
}

Rapports Strategy ("product": "solutions") : ils arrivent sans objet summary. Utilisez report.pdf_url et report.token à la place.

---

Workflow 1 : suivi trimestriel dans Google Sheets

Cas d’usage du suivi trimestriel

Chaque fois qu’un rapport AI Visibility est terminé, ajoutez ses métriques de résumé à une feuille Google Sheets pour suivre leur évolution dans le temps.

Mise en place du suivi trimestriel

Étape 1 : créer la feuille Google Sheets

Nom de la feuille : AI Visibility Tracking

Colonnes :

• A: Date
• B: Token
• C: Business Name
• D: Presence Score
• E: Authority Score
• F: Competitive Rank
• G: Top Competitor

---

Étape 2 : créer le Zap, déclencheur Catch Hook

Déclencheur : Webhooks by Zapier → Catch Hook

Zapier vous donne une URL du type https://hooks.zapier.com/hooks/catch/12345/abcdef/. Copiez-la.

---

Étape 3 : configurer Surmado pour envoyer le webhook

Lorsque vous créez un rapport AI Visibility via l’API, indiquez webhook_url :

curl -X POST https://api.surmado.com/v1/reports/signal \
  -H "Authorization: Bearer sur_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "brand_slug": "acme_corp",
    "url": "https://acme.com",
    "email": "founder@acme.com",
    "industry": "B2B SaaS",
    "location": "United States",
    "persona": "Small business owners",
    "pain_points": "Losing track of customer conversations",
    "brand_details": "Simple CRM with email integration",
    "direct_competitors": "HubSpot, Pipedrive",
    "webhook_url": "https://hooks.zapier.com/hooks/catch/12345/abcdef/"
  }'

Lancez un rapport pour que Zapier puisse capturer un exemple de payload. (Vous pouvez aussi passer d’abord par webhook.site pour visualiser la structure avant de configurer Zapier.)

---

Étape 4 : filtre, ne traiter que les rapports AI Visibility terminés

Action : Filter by Zapier

Conditions (toutes doivent être remplies) :

• event Exactly matches report.completed
• report__product Exactly matches signal

---

Étape 5 : ajouter à Google Sheets

Action : Google Sheets → Create Spreadsheet Row

Correspondance des colonnes :

• Date: {{timestamp}}
• Token: {{report__token}}
• Business Name: {{report__summary__business_name}}
• Presence Score: {{report__summary__presence_score}}
• Authority Score: {{report__summary__authority_score}}
• Competitive Rank: {{report__summary__competitive_rank}}
• Top Competitor: {{report__summary__top_competitor}}

---

Étape 6 : tester et activer

Test : lancez un vrai rapport AI Visibility avec l’URL du webhook. Vérifiez que la ligne apparaît.

Activation : activez le Zap.

---

Résumé du workflow de suivi trimestriel

1. Webhooks by Zapier: Catch Hook (Surmado POSTs report.completed)
   ↓
2. Filter: event = report.completed, product = signal
   ↓
3. Google Sheets: Create row with summary metrics

Tâches Zapier par Job : 3 tâches.

---

Workflow 2 : alertes concurrentielles dans Slack

Cas d’usage des alertes concurrentielles

Lorsqu’un rapport AI Visibility vous classe au-delà de la 3e place, publiez une alerte dans Slack.

Mise en place des alertes concurrentielles

Étapes 1 à 3 : identiques au Workflow 1

(Catch Hook → configuration de webhook_url sur les rapports → capture d’un exemple de payload)

---

Étape 4 : filtre, n’alerter que si le rang est supérieur à 3

Action : Filter by Zapier

Conditions (toutes doivent être remplies) :

• event Exactly matches report.completed
• report__product Exactly matches signal
• report__summary__competitive_rank (Number) Greater than 3

---

Étape 5 : envoyer un message Slack

Action : Slack → Send Channel Message

Canal : #marketing (ou le canal de votre équipe)

Message :

:warning: Competitive rank alert for *{{report__summary__business_name}}*

Ranked *#{{report__summary__competitive_rank}}* in AI visibility.

*Presence score*: {{report__summary__presence_score}}
*Authority score*: {{report__summary__authority_score}}
*Top competitor*: {{report__summary__top_competitor}}

View full report: {{report__pdf_url}}
Report token: `{{report__token}}`

---

Résumé du workflow d’alertes concurrentielles

1. Catch Hook
   ↓
2. Filter: product = signal AND competitive_rank > 3
   ↓
3. Slack: Alert with metrics + PDF link

Tâches Zapier en cas de déclenchement : 4 tâches (le filtre compte comme une tâche).

---

Workflow 3 : résultats Site Audit dans une base Notion

Cas d’usage Site Audit

Créez une page de base Notion pour chaque rapport Site Audit terminé, avec les scores et les principaux gains rapides.

Mise en place Site Audit

Étape 1 : créer la base Notion

Nom de la base : Site Audit Reports

Propriétés :

• Title (Title): [Brand] - [Date]
• Token (Text): Intelligence Token
• SEO Score (Number): 0-100
• Performance Score (Number): 0-100
• Accessibility Score (Number): 0-100
• Total Pages (Number)
• Critical Issues (Number)
• Report Date (Date)
• PDF (URL)

---

Étapes 2 et 3 : même configuration du Catch Hook

Créez un Catch Hook, puis configurez les rapports Site Audit pour qu’ils envoient leur POST à cette URL :

curl -X POST https://api.surmado.com/v1/reports/scan \
  -H "Authorization: Bearer sur_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "brand_slug": "acme_corp",
    "url": "https://www.acme.com",
    "email": "founder@acme.com",
    "webhook_url": "https://hooks.zapier.com/hooks/catch/12345/abcdef/"
  }'

---

Étape 4 : filtre, ne traiter que les Site Audit terminés

Conditions :

• event Exactly matches report.completed
• report__product Exactly matches scan

---

Étape 5 : mettre en forme les gains rapides avec Code by Zapier

Action : Code by Zapier → Run Python

Input Data :

• quick_wins: {{report__summary__quick_wins}} (transmet l’objet en JSON)

Code :

import json

raw = input_data.get('quick_wins', '{}')
try:
    quick_wins = json.loads(raw) if isinstance(raw, str) else (raw or {})
except Exception:
    quick_wins = {}

lines = [f"- **{area.replace('_', ' ').title()}**: {text}"
         for area, text in quick_wins.items() if text]

output = {'quick_wins_md': '\n'.join(lines) if lines else 'No quick wins surfaced.'}

---

Étape 6 : créer la page Notion

Action : Notion → Create Database Item

Base : Site Audit Reports

Correspondance des propriétés :

• Title: {{report__summary__business_name}} - {{timestamp}}
• Token: {{report__token}}
• SEO Score: {{report__summary__seo_score}}
• Performance Score: {{report__summary__performance_score}}
• Accessibility Score: {{report__summary__accessibility_score}}
• Total Pages: {{report__summary__total_pages}}
• Critical Issues: {{report__summary__critical_issues_count}}
• Report Date: {{timestamp}}
• PDF: {{report__pdf_url}}

Contenu de la page :

## Quick Wins

{{quick_wins_md}}

## Executive Summaries

**Pages**: {{report__summary__page_analysis_summary}}

**Links**: {{report__summary__link_analysis_summary}}

**Schema**: {{report__summary__schema_strategy_summary}}

**Content gaps**: {{report__summary__content_gaps_summary}}

## Intelligence Token

`{{report__token}}`

Fetch full data: `GET https://api.surmado.com/v1/reports/{{report__id}}` with Bearer auth.

---

Résumé du workflow Site Audit

1. Catch Hook
   ↓
2. Filter: product = scan
   ↓
3. Code by Zapier: Format quick_wins object into Markdown
   ↓
4. Notion: Create database page with scores + quick wins

Tâches Zapier par Job : 4 tâches.

---

Workflow 4 : synthèse de fin de Strategy

Cas d’usage de la synthèse Strategy

Lorsqu’un rapport Strategy est livré, envoyez un e-mail à la direction avec le lien vers le PDF.

Remarque sur les webhooks Strategy

Les webhooks Strategy ("product": "solutions") n’incluent pas d’objet summary : la sortie structurée du rapport Strategy n’est pas exposée pour l’instant via l’API REST. Vous recevez : report.id, report.token, report.pdf_url et report.data_url. Utilisez le lien du PDF dans votre synthèse.

Mise en place de la synthèse Strategy

Étapes 1 à 3 : même configuration du Catch Hook

Créez les rapports Strategy avec un webhook_url :

curl -X POST https://api.surmado.com/v1/reports/solutions \
  -H "Authorization: Bearer sur_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "brand_slug": "acme_corp",
    "email": "founder@acme.com",
    "business_story": "B2B SaaS CRM, 50 employees, $3M ARR",
    "decision": "Should we build a mobile app or improve the web experience?",
    "success": "40% engagement increase in 6 months",
    "timeline": "Need decision in next 30 days",
    "scale_indicator": "regional",
    "webhook_url": "https://hooks.zapier.com/hooks/catch/12345/abcdef/"
  }'

---

Étape 4 : filtre, ne traiter que les rapports Strategy terminés

Conditions :

• event Exactly matches report.completed
• report__product Exactly matches solutions

---

Étape 5 : envoyer l’e-mail via Gmail

Action : Gmail → Send Email

To : leadership@yourcompany.com

Subject : Strategy report ready — token {{report__token}}

Body Type : HTML

Body :

<p>A Strategy report has been delivered.</p>

<p><strong>Token:</strong> <code>{{report__token}}</code></p>

<p><a href="{{report__pdf_url}}">View the full report (PDF)</a></p>

<p><small>The PDF link is a magic-link URL valid for approximately 30 days.
For programmatic access to the report metadata, call
<code>GET https://api.surmado.com/v1/reports/{{report__id}}</code>
with your Surmado API key.</small></p>

---

Résumé du workflow de synthèse Strategy

1. Catch Hook
   ↓
2. Filter: product = solutions
   ↓
3. Gmail: Send PDF link to leadership

Tâches Zapier par Job : 3 tâches.

---

Workflow 5 : tableau de bord multi-clients pour agences

Cas d’usage du tableau de bord d’agence

Une agence réalise chaque mois un rapport AI Visibility pour 20 clients. Alimentez automatiquement une feuille Google Sheets principale avec les métriques de chaque client.

Mise en place du tableau de bord d’agence

Étape 1 : créer la feuille principale

Nom de la feuille : Client Dashboard

Colonnes :

• A: Client Name
• B: Date
• C: Token
• D: Presence Score
• E: Authority Score
• F: Competitive Rank
• G: Top Competitor
• H: Status

---

Étape 2 : un seul Catch Hook pour tous les clients

Créez un seul Zap avec Catch Hook. Utilisez le même webhook_url pour les rapports de tous les clients. Comme le payload contient report.summary.business_name (issu de la marque que vous avez enregistrée), Zapier peut router par client au sein du même Zap.

Créez une seule fois chaque client comme une marque distincte :

curl -X POST https://api.surmado.com/v1/brands/ensure \
  -H "Authorization: Bearer sur_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"brand_name": "Phoenix Cool Air"}'

Réutilisez ensuite le brand_slug renvoyé lorsque vous créez les rapports.

---

Étape 3 : filtrer sur report.completed et signal

(Comme pour le Workflow 1.)

---

Étape 4 : calculer le statut avec Formatter

Action : Formatter by Zapier → Numbers → Lookup Table

Input : {{report__summary__presence_score}}

Lookup :

• 0 to 30: At Risk
• 30.01 to 60: Needs Work
• 60.01 to 100: Leading

Sortie : le texte du statut.

---

Étape 5 : ajouter à la feuille principale

Action : Google Sheets → Create Spreadsheet Row

Correspondance des colonnes :

• Client Name: {{report__summary__business_name}}
• Date: {{timestamp}}
• Token: {{report__token}}
• Presence Score: {{report__summary__presence_score}}
• Authority Score: {{report__summary__authority_score}}
• Competitive Rank: {{report__summary__competitive_rank}}
• Top Competitor: {{report__summary__top_competitor}}
• Status: (issu de l’étape 4)

---

Étape 6 : alerte Slack conditionnelle pour les clients à risque

Action : Filter by Zapier

Condition : report__summary__presence_score (Number) Less than 30

Action : Slack → Send Channel Message

Message :

:rotating_light: At-risk client alert: *{{report__summary__business_name}}*

*Presence score*: {{report__summary__presence_score}} (below 30 threshold)
*Competitive rank*: #{{report__summary__competitive_rank}}

Action needed: Schedule a Strategy report or content optimization sprint.

View AI Visibility report: {{report__pdf_url}}

---

Résumé du workflow de tableau de bord d’agence

1. Catch Hook (single URL, used by all client reports)
   ↓
2. Filter: product = signal
   ↓
3. Formatter: Classify status from presence score
   ↓
4. Google Sheets: Add row with client metrics
   ↓
5. [If presence_score < 30] Slack: at-risk alert

Tâches Zapier par rapport client : 3 à 4 tâches. Pour 20 clients par mois : environ 70 à 90 tâches au total (largement dans les limites du forfait Starter).

---

Schémas avancés

Schéma 1 : récupérer des données plus détaillées via l’API REST

Le résumé du webhook couvre la plupart des besoins, mais si vous voulez des détails par plateforme (par exemple les scores de présence ChatGPT et Claude), récupérez l’objet complet public_intelligence :

Action : Webhooks by Zapier → GET

URL : https://api.surmado.com/v1/reports/{{report__id}}

Headers :

• Authorization: Bearer sur_live_YOUR_API_KEY

Structure de la réponse (AI Visibility) :

{
  "report_id": "rpt_abc123xyz",
  "status": "completed",
  "token": "SIG-2026-04-A1B2C",
  "public_intelligence": {
    "summary": { "presence_score": 34.2, "...": "..." },
    "data": {
      "visibility_metrics": { "presence_score": 34.2, "ghost_influence_percentage": 48.3 },
      "platform_variance": { "chatgpt": { "presence_score": 42.1 }, "claude": { "..." } },
      "competitive_position": { "rank": 4, "total_competitors": 12 },
      "...": "..."
    }
  }
}

Dans Zapier, ces champs deviennent public_intelligence__data__platform_variance__chatgpt__presence_score, etc.

Consultez Données structurées et Intelligence Tokens pour le schéma complet.

---

Schéma 2 : comparaison historique

Cas d’usage : comparer le nouveau rapport à celui du trimestre précédent.

Mise en place :

1. Catch Hook + filtre sur signal
2. Google Sheets → Lookup Spreadsheet Row (retrouver le token précédent de cette marque)
3. Webhooks by Zapier → GET sur le point d’accès REST du rapport précédent
4. Code by Zapier → calculer l’écart (actuel - précédent)
5. Ajouter la comparaison à la feuille ou l’envoyer par e-mail

---

Schéma 3 : diffusion vers plusieurs destinations

Cas d’usage : envoyer les mêmes données à Google Sheets, Notion et Airtable.

Mise en place : un seul Catch Hook → filtre → ajout d’actions « create row/page/record » en parallèle pour chaque destination. Un seul payload de webhook alimente toutes les destinations.

---

Schéma 4 : vérification de la signature du webhook (facultatif)

Surmado signe chaque webhook avec X-Surmado-Signature (HMAC-SHA256 sur le corps JSON canonicalisé). Pour les workflows sensibles, vérifiez la signature dans une étape Code by Zapier avant d’agir. Consultez le Guide d’intégration de l’API pour l’algorithme de vérification.

---

Dépannage

Problème 1 : le Catch Hook ne se déclenche pas

Symptôme : le Zap reste silencieux lorsqu’un rapport Surmado est terminé.

Causes :

• webhook_url n’a pas été indiqué dans l’appel de création du rapport
• L’URL Zapier n’est pas en HTTPS (Surmado exige HTTPS : Zapier l’utilise toujours, mais vérifiez qu’il n’y a pas de faute de frappe)
• Le Zap est désactivé
• Le rapport lui-même a échoué (cherchez plutôt un événement report.failed)

Solution :

• Utilisez webhook.site comme URL de test pour confirmer que Surmado envoie bien le payload
• Vérifiez le statut du rapport avec GET /v1/reports/{report_id} : s’il est à failed, vous recevrez un webhook report.failed, et non completed
• Activez le Zap et lancez un rapport de test

---

Problème 2 : des champs vides dans Google Sheets ou Notion

Symptôme : les lignes de destination ont des cellules vides.

Causes :

• Le chemin du champ utilise un seul tiret bas au lieu de deux (report_summary_presence_score au lieu de report__summary__presence_score)
• Le champ n’existe pas pour ce produit (par exemple, les rapports Site Audit n’ont pas de presence_score ; Strategy n’a aucun champ de résumé)
• Les données source n’ont pas renseigné ce champ (par exemple, top_competitor peut valoir null si la marque n’a aucun concurrent identifié)

Solution :

• Utilisez le sélecteur de champs de Zapier plutôt que de saisir les chemins à la main
• Vérifiez le produit : report__product indique quels champs de résumé attendre
• Pour AI Visibility, les champs du résumé proviennent de l’extracteur. Consultez Données structurées et Intelligence Tokens pour la liste des champs

---

Problème 3 : l’appel à l’API REST renvoie 401 Unauthorized

Symptôme : l’étape GET de Webhooks by Zapier échoue avec une erreur 401.

Cause : l’en-tête Authorization est absent ou mal formé.

Solution : vérifiez que l’en-tête est Authorization: Bearer sur_live_... (avec le préfixe Bearer). Vous pouvez aussi utiliser X-API-Key: sur_live_... à la place.

---

Problème 4 : lignes en double dans Google Sheets

Symptôme : le même rapport apparaît deux fois.

Causes :

• Surmado retente les envois de webhook échoués (3 tentatives avec délai croissant) : si votre Zap est lent, Surmado peut réessayer avant que Zapier ait confirmé la réception
• Vous avez configuré le webhook_url sur deux rapports pour la même marque

Solution :

• Répondez rapidement : le Catch Hook de Zapier est rapide par défaut, mais un filtre ou une étape Code surchargés peuvent retarder la réponse au-delà du délai de 30 secondes de Surmado
• Dédoublonnez sur report__id (Formatter de Zapier ou une recherche Google Sheets peut vérifier l’existence d’une ligne avant l’insertion)

---

Problème 5 : le Presence Score semble être de 0 à 1 au lieu de 0 à 100

Symptôme : le Presence Score affiche 0.342 au lieu de 34.2.

Cause : vous regardez un ancien chemin de champ (l’ancien format visibility_metrics.presence_rate). Le champ de résumé report.summary.presence_score est déjà normalisé sur 0-100.

Solution : utilisez directement report__summary__presence_score, sans multiplication.

---

Bonnes pratiques

1. Donnez des noms cohérents à vos Zaps

• AI Visibility → Google Sheets (Client Dashboard)
• Site Audit → Notion Database
• Strategy → Email Leadership

Pourquoi : ils sont faciles à repérer dans Zapier quand vous avez plus de 50 Zaps.

---

2. Ajoutez des notifications d’erreur

Ajoutez à la fin des Zaps critiques une étape qui vous envoie un e-mail ou un message Slack si une étape précédente échoue. Les notifications d’erreur intégrées de Zapier sont silencieuses par défaut.

---

3. Utilisez des dossiers pour vous organiser

Dossiers Zapier (forfait Professional) :

• Client Reporting : tous les Zaps de tableau de bord client
• Internal Monitoring : vos propres rapports
• Alerts : alertes concurrentielles, clients à risque

---

4. Un Catch Hook par produit

Utilisez un Zap Catch Hook par produit (AI Visibility, Site Audit, Strategy), et non un par marque. Filtrez sur report__product dans le Zap. Vous n’avez besoin de configurer webhook_url qu’une seule fois par marque et par création de rapport.

---

5. Conservez les payloads bruts pour pouvoir les rejouer

Enregistrez le payload complet du webhook dans une feuille ou une base « raw events ». Si votre logique en aval change plus tard, vous pourrez rejouer les anciens événements sans relancer les rapports.

---

Estimation des tâches Zapier

Workflows pour un seul rapport :

• Suivi (Catch Hook → Filter → Sheets) : 3 tâches
• Avec alerte Slack : 4 tâches
• Notion avec étape Code : 4 tâches
• Workflow complet d’agence avec alerte conditionnelle : 5 à 6 tâches

Tableaux de bord d’agence (20 clients par mois) :

• Suivi de base : environ 60 à 80 tâches/mois
• Avec alertes et plusieurs destinations : environ 100 à 140 tâches/mois

Forfait recommandé :

• 1 à 5 clients : Starter ($20/mois, 750 tâches)
• 5 à 20 clients : Starter suffit dans la plupart des cas ; Professional ($50/mois) ajoute Paths et les dossiers
• Plus de 20 clients : Professional avec dossiers et filtres

---

Questions fréquentes

Puis-je déclencher des Zaps sans configurer de webhook ?

Oui. En solution de repli, Gmail peut se déclencher sur les e-mails de hi@surmado.com (Surmado envoie aussi un e-mail lorsqu’un rapport est terminé). Mais les webhooks sont plus rapides, plus fiables et transportent le payload complet du résumé. Privilégiez les webhooks.

Dois-je payer à la fois Zapier et Surmado ?

Oui. Zapier est une plateforme d’automatisation distincte. Surmado fournit les rapports, l’API REST et l’envoi des webhooks. Zapier relie les deux.

Puis-je partager des Zaps avec des clients ?

Oui (forfait Professional). Utilisez Zapier Transfer pour copier un Zap dans le compte Zapier d’un client. Il pourra l’adapter à ses besoins.

Que se passe-t-il si les champs du résumé changent ?

Les formats d’Intelligence Token (SIG-, SCN-, SOL-) sont stables. Les noms des champs du résumé peuvent s’enrichir avec le temps (de nouveaux champs sont ajoutés), mais nous nous efforçons de ne pas supprimer ni renommer les champs existants. Nous préviendrons les utilisateurs de l’API en cas de changement non rétrocompatible.

Puis-je utiliser Zapier pour une analyse historique en masse ?

En partie. Vous pouvez relancer manuellement des rapports pour les marques que vous voulez actualiser. Pour une analyse en masse sur de nombreux anciens rapports, utilisez directement l’API REST (GET /v1/reports est paginé). Consultez le Guide d’intégration de l’API.

Zapier fonctionne-t-il avec les lacunes de contenu de Site Audit ?

Oui. Les payloads Site Audit incluent report.summary.content_gaps_summary sous forme de synthèse, et report.summary.quick_wins.content_gaps sous forme de recommandation hiérarchisée. Pour la liste complète des lacunes, interrogez l’API REST et lisez public_intelligence.data.audit_data.enrichment.content_gaps.

Zapier fonctionne-t-il avec les rapports Strategy ?

En partie. Les webhooks Strategy transportent le token et le lien du PDF, pas un résumé structuré. Utilisez-les pour déclencher des workflows de fin de rapport (envoyer le PDF, créer une tâche, prévenir la direction). Les données structurées de Strategy ne sont pas exposées via l’API REST aujourd’hui ; cela dépendra de la feuille de route.

---

Besoin d’aide pour configurer des intégrations Zapier ? Écrivez à hi@surmado.com en décrivant votre cas d’usage : nous pouvons fournir des modèles de Zap sur mesure ou une aide à l’intégration.