Guida all'integrazione con Zapier

Risposta rapida: automatizza i report Surmado con Zapier. Punta un webhook_url di Surmado a un trigger Catch Hook di Zapier: Zapier riceve il payload di completamento (con le metriche di sintesi già estratte) e lo inoltra a Google Sheets / Slack / Notion / email. Per dati più approfonditi, aggiungi un recupero tramite REST API con la tua chiave API. Includiamo cinque workflow comuni: monitoraggio trimestrale, alert sulla concorrenza, dashboard Notion, digest di Strategy e report multi-cliente per agenzie.

Tempo di lettura: 18 minuti

In questa guida:

• Costruisci l’automazione del monitoraggio trimestrale ricevendo il webhook report.completed di Surmado, leggendo report.summary.presence_score e i campi correlati e aggiungendo una riga a Google Sheets (3 task di Zapier per Job)
• Crea alert sulla concorrenza per i posizionamenti deboli con Filter by Zapier su report.summary.competitive_rank, poi pubblica su Slack solo quando il rank è > 3 (4 task quando scatta)
• Configura l’integrazione con un database Notion per i report Site Audit usando report.summary.seo_score, performance_score, accessibility_score e critical_issues_count più l’oggetto quick_wins (4 task per Job)
• Invia ai dirigenti i digest di completamento di Strategy: i webhook di Strategy non includono una sintesi, ma ricevi report.pdf_url (un magic link valido 30 giorni) che puoi inserire direttamente in un’email (3 task per Job)
• Costruisci una dashboard multi-cliente per agenzie che popola un Google Sheet principale con le metriche di tutti i clienti, usando report.summary.business_name del payload come filtro per cliente (3-4 task per report di ogni cliente)

Costo: il piano Zapier Starter ($20/mese) supporta questi workflow.

---

Prerequisiti

Cosa ti serve

1. Account Zapier (almeno il piano Starter per gli Zap con più step)
2. Account Surmado con accesso API (incluso in tutti i piani: PAYG, Pro e Pro+)
3. Una chiave API Surmado (sur_live_...): creala su app.surmado.com in Settings → API Keys
4. Account dell’app di destinazione (Google Sheets, Slack, Notion e così via)

Requisiti del piano Zapier

Piano gratuito:

• 100 task/mese
• Solo Zap a step singolo
• Non sufficiente per i workflow di Surmado (servono più step)

Piano Starter ($20/mese):

• 750 task/mese
• Zap con più step (necessari)
• Minimo consigliato

Piano Professional ($50/mese):

• Zap illimitati
• Paths (logica condizionale)
• Consigliato per le agenzie con più clienti

---

Lo schema di integrazione

Tutti e cinque i workflow qui sotto hanno la stessa struttura:

1. Trigger: Webhooks by Zapier, “Catch Hook”. Zapier ti dà un URL univoco.
2. Configura Surmado perché invii con POST i completamenti dei report a quell’URL, includendo webhook_url quando crei il report.
3. Leggi il payload in arrivo. Zapier appiattisce il JSON annidato con __ (doppio trattino basso), quindi report.summary.presence_score diventa report__summary__presence_score nel selettore dei campi di Zapier.
4. (Facoltativo) Recupero tramite REST API se ti servono campi oltre la sintesi. Chiama GET https://api.surmado.com/v1/reports/{{report__id}} con l’header Authorization: Bearer sur_live_YOUR_KEY.
5. Agisci: scrivi su Google Sheets, pubblica su Slack, crea una pagina Notion e così via.

Payload webhook di esempio

{
  "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)", "..."]
    }
  }
}

I report di Strategy ("product": "solutions") arrivano senza un oggetto summary: usa invece report.pdf_url e report.token.

---

Workflow 1: monitoraggio trimestrale su Google Sheets

Caso d’uso del monitoraggio trimestrale

Ogni volta che un report AI Visibility si completa, aggiungi le metriche di sintesi a un Google Sheet per il monitoraggio nel tempo.

Configurazione del monitoraggio trimestrale

Passaggio 1: crea il Google Sheet

Nome del foglio: AI Visibility Tracking

Colonne:

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

---

Passaggio 2: crea lo Zap con il trigger Catch Hook

Trigger: Webhooks by Zapier → Catch Hook

Zapier ti dà un URL come https://hooks.zapier.com/hooks/catch/12345/abcdef/. Copialo.

---

Passaggio 3: configura Surmado per inviare il webhook

Quando crei un report AI Visibility tramite API, includi 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/"
  }'

Avvia un report così Zapier può acquisire un payload di esempio. (Puoi anche usare prima webhook.site per vedere in anteprima la struttura prima di collegare Zapier.)

---

Passaggio 4: filtro per elaborare solo i report AI Visibility completati

Azione: Filter by Zapier

Condizioni (devono essere tutte vere):

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

---

Passaggio 5: aggiungi a Google Sheets

Azione: Google Sheets → Create Spreadsheet Row

Associazione delle colonne:

• 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}}

---

Passaggio 6: prova e attiva

Prova: avvia un vero report AI Visibility con l’URL del webhook. Controlla che compaia la riga.

Attiva: accendi lo Zap.

---

Riepilogo del workflow di monitoraggio trimestrale

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

Task di Zapier per Job: 3 task.

---

Workflow 2: alert sulla concorrenza su Slack

Caso d’uso degli alert sulla concorrenza

Quando un report AI Visibility ti mostra al di sotto del #3, pubblica un alert su Slack.

Configurazione degli alert sulla concorrenza

Passaggi 1-3: come nel Workflow 1

(Catch Hook → configura webhook_url sui report → acquisisci un payload di esempio)

---

Passaggio 4: filtro per avvisare solo quando il rank è > 3

Azione: Filter by Zapier

Condizioni (devono essere tutte vere):

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

---

Passaggio 5: invia il messaggio Slack

Azione: Slack → Send Channel Message

Canale: #marketing (o il canale del tuo team)

Messaggio:

: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}}`

---

Riepilogo del workflow degli alert sulla concorrenza

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

Task di Zapier quando scatta: 4 task (anche il filtro conta come task).

---

Workflow 3: risultati di Site Audit in un database Notion

Caso d’uso di Site Audit

Crea una pagina di database Notion per ogni report Site Audit completato, con i punteggi e i principali quick win.

Configurazione di Site Audit

Passaggio 1: crea il database Notion

Nome del database: Site Audit Reports

Proprietà:

• 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)

---

Passaggi 2-3: stessa configurazione del Catch Hook

Crea un Catch Hook, poi configura i report Site Audit perché inviino con POST a quell’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/"
  }'

---

Passaggio 4: filtro per elaborare solo i Site Audit completati

Condizioni:

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

---

Passaggio 5: formatta i quick win con Code by Zapier

Azione: Code by Zapier → Run Python

Input Data:

• quick_wins: {{report__summary__quick_wins}} (passa l’oggetto come JSON)

Codice:

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.'}

---

Passaggio 6: crea la pagina Notion

Azione: Notion → Create Database Item

Database: Site Audit Reports

Associazione delle proprietà:

• 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}}

Contenuto della pagina:

## 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.

---

Riepilogo del workflow di 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

Task di Zapier per Job: 4 task.

---

Workflow 4: digest di completamento di Strategy

Caso d’uso del digest di Strategy

Quando un report Strategy viene consegnato, invia ai dirigenti un’email con il link al PDF.

Nota sui webhook di Strategy

I webhook di Strategy ("product": "solutions") non includono un oggetto summary: l’output strutturato del report Strategy al momento non è esposto tramite la REST API. Ricevi: report.id, report.token, report.pdf_url e report.data_url. Usa il link al PDF nel tuo digest.

Configurazione del digest di Strategy

Passaggi 1-3: stessa configurazione del Catch Hook

Crea i report Strategy con 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/"
  }'

---

Passaggio 4: filtro per i soli report Strategy completati

Condizioni:

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

---

Passaggio 5: invia l’email con Gmail

Azione: 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>

---

Riepilogo del workflow del digest di Strategy

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

Task di Zapier per Job: 3 task.

---

Workflow 5: dashboard multi-cliente per agenzie

Caso d’uso della dashboard per agenzie

Un’agenzia che esegue AI Visibility ogni mese per 20 clienti. Popola in automatico un Google Sheet principale con le metriche di ogni cliente.

Configurazione della dashboard per agenzie

Passaggio 1: crea il foglio principale

Nome del foglio: Client Dashboard

Colonne:

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

---

Passaggio 2: un solo Catch Hook per tutti i clienti

Crea un unico Zap con Catch Hook. Usa lo stesso webhook_url nei report di ogni cliente. Poiché il payload include report.summary.business_name (dal brand che hai registrato), Zapier può instradare per cliente all’interno dello stesso Zap.

Crea ogni cliente come brand separato una sola volta:

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"}'

Poi riusa il brand_slug restituito quando crei i report.

---

Passaggio 3: filtro su report.completed e signal

(Come nel Workflow 1.)

---

Passaggio 4: calcola lo stato con Formatter

Azione: Formatter by Zapier → Numbers → Lookup Table

Input: {{report__summary__presence_score}}

Lookup:

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

Output: testo dello stato.

---

Passaggio 5: aggiungi al foglio principale

Azione: Google Sheets → Create Spreadsheet Row

Associazione delle colonne:

• 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: (dal Passaggio 4)

---

Passaggio 6: alert Slack condizionale per i clienti a rischio

Azione: Filter by Zapier

Condizione: report__summary__presence_score (Number) Less than 30

Azione: Slack → Send Channel Message

Messaggio:

: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}}

---

Riepilogo del workflow della dashboard per agenzie

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

Task di Zapier per report di un cliente: 3-4 task. Per 20 clienti al mese: circa 70-90 task in totale (ben entro il piano Starter).

---

Schemi avanzati

Schema 1: recuperare dati più approfonditi tramite REST API

La sintesi del webhook copre la maggior parte delle esigenze, ma se vuoi dettagli per piattaforma (per esempio i punteggi di presenza su ChatGPT e Claude), recupera l’intero oggetto public_intelligence:

Azione: Webhooks by Zapier → GET

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

Headers:

• Authorization: Bearer sur_live_YOUR_API_KEY

Struttura della risposta (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 },
      "...": "..."
    }
  }
}

In Zapier, questi campi vengono appiattiti in public_intelligence__data__platform_variance__chatgpt__presence_score e così via.

Per lo schema completo vedi Dati strutturati e Intelligence Token.

---

Schema 2: confronto storico

Caso d’uso: confrontare il nuovo report con il trimestre precedente.

Configurazione:

1. Catch Hook + filtro su signal
2. Google Sheets → Lookup Spreadsheet Row (trova il token precedente per questo brand)
3. Webhooks by Zapier → GET sull’endpoint REST del report precedente
4. Code by Zapier → calcola la differenza (attuale - precedente)
5. Aggiungi il confronto al foglio o invialo via email

---

Schema 3: distribuzione su più destinazioni

Caso d’uso: gli stessi dati su Google Sheets + Notion + Airtable.

Configurazione: un solo Catch Hook → filtro → aggiungi azioni parallele “create row/page/record” per ogni destinazione. Un singolo payload webhook alimenta tutte.

---

Schema 4: verifica della firma del webhook (facoltativa)

Surmado firma ogni webhook con X-Surmado-Signature (HMAC-SHA256 sul corpo JSON canonicalizzato). Per i workflow ad alto rischio, verifica la firma in uno step Code by Zapier prima di agire. Per l’algoritmo di verifica vedi la Guida all’integrazione API.

---

Risoluzione dei problemi

Problema 1: il Catch Hook non parte

Sintomo: lo Zap resta muto quando un report Surmado si completa.

Cause:

• webhook_url non era incluso nella chiamata di creazione del report
• L’URL di Zapier non usa HTTPS (Surmado richiede HTTPS: Zapier lo usa sempre, ma controlla eventuali refusi)
• Lo Zap è spento
• Il report stesso è fallito (cerca invece un evento report.failed)

Soluzione:

• Usa webhook.site come URL di prova per confermare che Surmado invii il payload
• Controlla lo stato del report con GET /v1/reports/{report_id}: se è failed, vedrai un webhook report.failed, non completed
• Accendi lo Zap e avvia un report di prova

---

Problema 2: i campi risultano vuoti in Google Sheets / Notion

Sintomo: le righe di destinazione hanno celle vuote.

Cause:

• Il percorso del campo usa un solo trattino basso invece di due (report_summary_presence_score invece di report__summary__presence_score)
• Il campo non esiste per quel prodotto (per esempio i report Site Audit non hanno presence_score; Strategy non ha alcun campo di sintesi)
• I dati di origine non hanno valorizzato quel campo (per esempio top_competitor può essere nullo se il brand non ha concorrenti identificati)

Soluzione:

• Usa il selettore dei campi di Zapier invece di digitare i percorsi a mano
• Verifica il prodotto: report__product ti dice quali campi di sintesi aspettarti
• Per AI Visibility, i campi di sintesi arrivano dall’extractor: vedi Dati strutturati e Intelligence Token per l’elenco dei campi

---

Problema 3: il recupero tramite REST API restituisce 401 Unauthorized

Sintomo: lo step GET di Webhooks by Zapier fallisce con 401.

Causa: l’header Authorization manca o è malformato.

Soluzione: controlla che l’header sia Authorization: Bearer sur_live_... (compreso il prefisso Bearer). In alternativa usa X-API-Key: sur_live_....

---

Problema 4: righe duplicate in Google Sheets

Sintomo: lo stesso report compare due volte.

Cause:

• Surmado riprova le consegne dei webhook fallite (3 tentativi con backoff): se il tuo Zap è lento, Surmado può riprovare prima che Zapier confermi la ricezione
• Hai impostato il webhook_url su due report dello stesso brand

Soluzione:

• Rispondi in fretta: il Catch Hook di Zapier è veloce per impostazione predefinita, ma un Filter o un Code step sovraccarico può ritardare la risposta oltre il timeout di 30 secondi di Surmado
• Elimina i duplicati su report__id (il Formatter di Zapier o una ricerca su Google Sheets può controllare se esiste già una riga prima di inserirla)

---

Problema 5: il Presence Score sembra 0-1 invece di 0-100

Sintomo: il presence score è 0.342 invece di 34.2.

Causa: stai usando un percorso di campo obsoleto (il vecchio formato visibility_metrics.presence_rate). Il campo di sintesi report.summary.presence_score è già normalizzato su 0-100.

Soluzione: usa direttamente report__summary__presence_score: non serve moltiplicare.

---

Buone pratiche

1. Usa nomi coerenti per gli Zap

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

Perché: sono facili da riconoscere nella dashboard di Zapier quando hai più di 50 Zap.

---

2. Aggiungi notifiche di errore

Aggiungi agli Zap critici uno step finale che ti scrive via email o Slack se uno step precedente fallisce. Le notifiche di errore integrate di Zapier sono silenziose per impostazione predefinita.

---

3. Usa le cartelle per l’organizzazione

Cartelle di Zapier (piano Professional):

• Client Reporting: tutti gli Zap della dashboard clienti
• Internal Monitoring: i tuoi report
• Alerts: alert sulla concorrenza, clienti a rischio

---

4. Un Catch Hook per prodotto

Esegui un solo Zap con Catch Hook per prodotto (AI Visibility / Site Audit / Strategy), non uno per brand. Filtra su report__product dentro lo Zap. Devi impostare webhook_url una sola volta per brand o per creazione di report.

---

5. Conserva i payload grezzi per poterli rielaborare

Registra l’intero payload del webhook in un foglio o database di “eventi grezzi”. Se la logica a valle cambia in seguito, puoi rielaborare gli eventi storici senza rieseguire i report.

---

Stima dei task di Zapier

Workflow per un singolo report:

• Monitoraggio (Catch Hook → Filter → Sheets): 3 task
• Con alert Slack: 4 task
• Notion con step Code: 4 task
• Workflow completo per agenzie con alert condizionale: 5-6 task

Dashboard per agenzie (20 clienti/mese):

• Monitoraggio di base: circa 60-80 task/mese
• Con alert e più destinazioni: circa 100-140 task/mese

Piano consigliato:

• 1-5 clienti: Starter ($20/mese, 750 task)
• 5-20 clienti: Starter funziona ancora nella maggior parte dei casi; Professional ($50/mese) aggiunge Paths e cartelle
• Oltre 20 clienti: Professional con cartelle e filtri

---

Domande frequenti

Posso far partire gli Zap senza configurare un webhook?

Sì: come ripiego, Gmail può partire sulle email di hi@surmado.com (Surmado invia anche una notifica via email quando i report si completano). Ma i webhook sono più veloci, più affidabili e portano l’intero payload di sintesi. Preferisci i webhook.

Devo pagare sia Zapier sia Surmado?

Sì. Zapier è una piattaforma di automazione separata. Surmado fornisce i report, la REST API e la consegna dei webhook. Zapier collega i due.

Posso condividere gli Zap con i clienti?

Sì (piano Professional). Usa Zapier Transfer per copiare uno Zap nell’account Zapier di un cliente. Il cliente può personalizzarlo in base alle sue esigenze.

Cosa succede se i campi di sintesi cambiano?

I formati degli Intelligence Token (SIG-, SCN-, SOL-) sono stabili. I nomi dei campi di sintesi possono crescere nel tempo (con nuovi campi), ma puntiamo a non rimuovere né rinominare quelli esistenti. Avviseremo chi usa l’API delle modifiche non compatibili.

Posso usare Zapier per analisi storiche in blocco?

In parte. Puoi riavviare a mano i report dei brand che vuoi aggiornare. Per analisi in blocco su molti report storici, usa direttamente la REST API (GET /v1/reports è paginato): vedi la Guida all’integrazione API.

Zapier funziona con le lacune di contenuto di Site Audit?

Sì. I payload di Site Audit includono report.summary.content_gaps_summary come stringa di sintesi esecutiva e report.summary.quick_wins.content_gaps come raccomandazione prioritaria. Per l’elenco completo delle lacune, interroga la REST API e leggi public_intelligence.data.audit_data.enrichment.content_gaps.

Zapier funziona con i report di Strategy?

In parte. I webhook di Strategy portano il token e il link al PDF, non una sintesi strutturata. Usali per far partire workflow basati sul completamento (inviare il PDF, creare un’attività, avvisare i dirigenti). I dati strutturati di Strategy oggi non sono esposti tramite la REST API: dipende dalla roadmap.

---

Ti serve aiuto per configurare le integrazioni con Zapier? Scrivi a hi@surmado.com con il tuo caso d’uso: possiamo fornirti modelli di Zap personalizzati o assistenza per l’integrazione.