Ir para o conteúdo principal

Guia de integração com o Zapier

Resposta rápida: automatize os relatórios da Surmado com o Zapier. Aponte o webhook_url da Surmado para um gatilho Catch Hook do Zapier. O Zapier recebe o payload de conclusão (com as métricas do resumo já extraídas) e o encaminha para Google Sheets / Slack / Notion / e-mail. Para dados mais detalhados, faça depois uma consulta à API REST com a sua chave de API. Há cinco fluxos de trabalho comuns: acompanhamento trimestral, alertas de concorrência, painéis no Notion, resumos de Strategy e relatórios multicliente para agências.

Tempo de leitura: 18 minutos

Neste guia:

  • Monte uma automação de acompanhamento trimestral recebendo o webhook report.completed da Surmado, lendo report.summary.presence_score e os campos relacionados, e adicionando uma linha ao Google Sheets (3 tarefas do Zapier por Job)
  • Crie alertas de concorrência para posicionamento fraco com Filter by Zapier em report.summary.competitive_rank, publicando no Slack só quando a posição for maior que 3 (4 tarefas quando é acionado)
  • Configure a integração com um banco de dados do Notion para os relatórios do Site Audit usando report.summary.seo_score, performance_score, accessibility_score e critical_issues_count, além do objeto quick_wins (4 tarefas por Job)
  • Envie resumos de Strategy para a liderança: os webhooks de Strategy não incluem resumo, mas você recebe report.pdf_url (um link mágico de 30 dias) que pode ser incluído direto em um e-mail (3 tarefas por Job)
  • Monte um painel multicliente para agências que preencha uma planilha mestra do Google Sheets com as métricas de todos os clientes, usando report.summary.business_name do payload como filtro de cliente (3-4 tarefas por relatório de cliente)

Custo: o plano Starter do Zapier ($20/mês) comporta esses fluxos de trabalho.

Pré-requisitos

O que você precisa

  1. Conta no Zapier (plano Starter no mínimo para Zaps de várias etapas)
  2. Conta na Surmado com acesso à API (incluído em todos os planos: PAYG, Pro e Pro+)
  3. Uma chave de API da Surmado (sur_live_...): crie em app.surmado.com em Settings → API Keys
  4. Conta no app de destino (Google Sheets, Slack, Notion etc.)

Requisitos de plano do Zapier

Plano gratuito:

  • 100 tarefas/mês
  • Só Zaps de uma etapa
  • Não é suficiente para os fluxos da Surmado (eles precisam de várias etapas)

Plano Starter ($20/mês):

  • 750 tarefas/mês
  • Zaps de várias etapas (obrigatório)
  • Mínimo recomendado

Plano Professional ($50/mês):

  • Zaps ilimitados
  • Paths (lógica condicional)
  • Recomendado para agências com vários clientes

O padrão de integração

Os cinco fluxos de trabalho abaixo seguem a mesma estrutura:

  1. Gatilho: Webhooks by Zapier, “Catch Hook”. O Zapier fornece uma URL exclusiva.
  2. Configure a Surmado para enviar por POST os relatórios concluídos a essa URL, incluindo webhook_url ao criar o relatório.
  3. Leia o payload recebido. O Zapier achata o JSON aninhado com __ (dois sublinhados), então report.summary.presence_score vira report__summary__presence_score no seletor de campos do Zapier.
  4. (Opcional) Consulta à API REST se você precisar de campos que não estão no resumo. Chame GET https://api.surmado.com/v1/reports/{{report__id}} com o cabeçalho Authorization: Bearer sur_live_YOUR_KEY.
  5. Aja: escreva no Google Sheets, publique no Slack, crie uma página no Notion etc.

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

Relatórios de Strategy ("product": "solutions") chegam sem o objeto summary: use report.pdf_url e report.token.

Fluxo 1: acompanhamento trimestral no Google Sheets

Caso de uso do acompanhamento trimestral

Cada vez que um relatório de AI Visibility é concluído, adicione as métricas do resumo a uma planilha do Google Sheets para acompanhar a evolução ao longo do tempo.

Configuração do acompanhamento trimestral

Passo 1: crie a planilha do Google Sheets

Nome da planilha: AI Visibility Tracking

Colunas:

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

Passo 2: crie o Zap com o gatilho Catch Hook

Gatilho: Webhooks by Zapier → Catch Hook

O Zapier fornece uma URL como https://hooks.zapier.com/hooks/catch/12345/abcdef/. Copie-a.

Passo 3: configure a Surmado para enviar o webhook

Ao criar um relatório de AI Visibility pela API, inclua 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/"
  }'

Dispare um relatório para que o Zapier capture um payload de exemplo. (Você também pode usar antes o webhook.site para ver a estrutura antes de configurar o Zapier.)

Passo 4: filtro para processar só relatórios de AI Visibility concluídos

Ação: Filter by Zapier

Condições (todas devem ser atendidas):

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

Passo 5: adicione ao Google Sheets

Ação: Google Sheets → Create Spreadsheet Row

Mapeamento de colunas:

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

Passo 6: teste e ative

Teste: dispare um relatório real de AI Visibility com a URL do webhook. Confirme que a linha aparece.

Ative: ligue o Zap.

Resumo do fluxo de acompanhamento trimestral

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

Tarefas do Zapier por Job: 3 tarefas.

Fluxo 2: alertas de concorrência no Slack

Caso de uso dos alertas de concorrência

Quando um relatório de AI Visibility mostrar que você está abaixo da posição #3, publique um alerta no Slack.

Configuração dos alertas de concorrência

Passos 1-3: iguais ao Fluxo 1

(Catch Hook → configure o webhook_url nos relatórios → capture um payload de exemplo)

Passo 4: filtro para alertar só quando a posição for maior que 3

Ação: Filter by Zapier

Condições (todas devem ser atendidas):

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

Passo 5: envie a mensagem no Slack

Ação: Slack → Send Channel Message

Canal: #marketing (ou o canal da sua equipe)

Mensagem:

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

Resumo do fluxo de alertas de concorrência

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

Tarefas do Zapier quando é acionado: 4 tarefas (o filtro conta como uma tarefa).

Fluxo 3: resultados do Site Audit em um banco de dados do Notion

Caso de uso do Site Audit

Crie uma página de banco de dados do Notion para cada relatório de Site Audit concluído, com as pontuações e as principais correções rápidas.

Configuração do Site Audit

Passo 1: crie o banco de dados do Notion

Nome do banco de dados: Site Audit Reports

Propriedades:

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

Passos 2-3: mesma configuração do Catch Hook

Crie um Catch Hook e depois configure os relatórios de Site Audit para enviar POST a essa 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/"
  }'

Passo 4: filtro para processar só Site Audits concluídos

Condições:

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

Passo 5: formate as correções rápidas com Code by Zapier

Ação: Code by Zapier → Run Python

Input Data:

  • quick_wins: {{report__summary__quick_wins}} (passa o objeto como JSON)

Código:

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

Passo 6: crie a página no Notion

Ação: Notion → Create Database Item

Banco de dados: Site Audit Reports

Mapeamento de propriedades:

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

Conteúdo da página:

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

Resumo do fluxo do 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

Tarefas do Zapier por Job: 4 tarefas.

Fluxo 4: resumo de conclusão do Strategy

Caso de uso do resumo de Strategy

Quando um relatório de Strategy for entregue, envie um e-mail para a liderança com o link do PDF.

Observação sobre os webhooks de Strategy

Os webhooks de Strategy ("product": "solutions") não incluem o objeto summary: a saída estruturada do relatório de Strategy não está exposta na API REST no momento. O que você recebe é: report.id, report.token, report.pdf_url e report.data_url. Use o link do PDF no seu resumo.

Configuração do resumo de Strategy

Passos 1-3: mesma configuração do Catch Hook

Crie relatórios de Strategy com um 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/"
  }'

Passo 4: filtro para processar só relatórios de Strategy concluídos

Condições:

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

Passo 5: envie o e-mail pelo Gmail

Ação: 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>

Resumo do fluxo de resumo de Strategy

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

Tarefas do Zapier por Job: 3 tarefas.

Fluxo 5: painel multicliente para agências

Caso de uso do painel para agências

Uma agência executa o AI Visibility para 20 clientes por mês. Preencha uma planilha mestra do Google Sheets com as métricas de cada cliente de forma automática.

Configuração do painel para agências

Passo 1: crie a planilha mestra

Nome da planilha: Client Dashboard

Colunas:

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

Passo 2: um Catch Hook para todos os clientes

Crie um único Zap com Catch Hook. Use o mesmo webhook_url nos relatórios de todos os clientes. Como o payload inclui report.summary.business_name (da marca que você registrou), o Zapier consegue direcionar por cliente dentro do mesmo Zap.

Crie cada cliente como uma marca separada, uma única vez:

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

Depois reutilize o brand_slug retornado ao criar os relatórios.

Passo 3: filtro em report.completed e signal

(Igual ao Fluxo 1.)

Passo 4: calcule o status com o Formatter

Ação: Formatter by Zapier → Numbers → Lookup Table

Entrada: {{report__summary__presence_score}}

Tabela de consulta:

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

Saída: texto do status.

Passo 5: adicione à planilha mestra

Ação: Google Sheets → Create Spreadsheet Row

Mapeamento de colunas:

  • 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: (do Passo 4)

Passo 6: alerta condicional no Slack para clientes em risco

Ação: Filter by Zapier

Condição: report__summary__presence_score (Number) Less than 30

Ação: Slack → Send Channel Message

Mensagem:

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

Resumo do fluxo do painel para agências

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

Tarefas do Zapier por relatório de cliente: 3-4 tarefas. Para 20 clientes/mês: cerca de 70-90 tarefas no total (bem dentro do plano Starter).

Padrões avançados

Padrão 1: busque dados mais detalhados pela API REST

O resumo do webhook atende à maioria das necessidades, mas se você quiser detalhamentos por plataforma (por exemplo, Presence Score no ChatGPT e no Claude), busque o objeto completo public_intelligence:

Ação: Webhooks by Zapier → GET

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

Cabeçalhos:

  • Authorization: Bearer sur_live_YOUR_API_KEY

Formato da resposta (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 },
      "...": "..."
    }
  }
}

No Zapier, esses campos são achatados para public_intelligence__data__platform_variance__chatgpt__presence_score e assim por diante.

Veja o esquema completo em Dados estruturados e Intelligence Tokens.

Padrão 2: comparação histórica

Caso de uso: compare o novo relatório com o do trimestre anterior.

Configuração:

  1. Catch Hook + filtro para signal
  2. Google Sheets → Lookup Spreadsheet Row (encontre o token anterior desta marca)
  3. Webhooks by Zapier → GET no endpoint REST do relatório anterior
  4. Code by Zapier → calcule a diferença (atual - anterior)
  5. Adicione a comparação à planilha ou envie por e-mail

Padrão 3: envio para vários destinos

Caso de uso: os mesmos dados para Google Sheets + Notion + Airtable.

Configuração: um Catch Hook → filtro → ações paralelas de “criar linha/página/registro” para cada destino. Um único payload de webhook alimenta todos eles.

Padrão 4: verificação de assinatura do webhook (opcional)

A Surmado assina todo webhook com X-Surmado-Signature (HMAC-SHA256 sobre o corpo JSON canonizado). Em fluxos de alto risco, verifique a assinatura em uma etapa Code by Zapier antes de agir. Veja o algoritmo de verificação no Guia de integração da API.

Solução de problemas

Problema 1: o Catch Hook não dispara

Sintoma: o Zap fica em silêncio quando um relatório da Surmado é concluído.

Causas:

  • o webhook_url não foi incluído na chamada de criação do relatório
  • a URL do Zapier não usa HTTPS (a Surmado exige HTTPS; o Zapier sempre usa, mas confira se há erros de digitação)
  • o Zap está desligado
  • o próprio relatório falhou (procure um evento report.failed)

Correção:

  • Use o webhook.site como URL de teste para confirmar que a Surmado está enviando o payload
  • Verifique o status do relatório com GET /v1/reports/{report_id}: se for failed, você verá um webhook report.failed, não completed
  • Ligue o Zap e execute um relatório de teste

Problema 2: os campos aparecem vazios no Google Sheets / Notion

Sintoma: as linhas de destino têm células em branco.

Causas:

  • o caminho do campo usa um sublinhado simples em vez de dois (report_summary_presence_score em vez de report__summary__presence_score)
  • o campo não existe nesse produto (por exemplo, os relatórios de Site Audit não têm presence_score; o Strategy não tem nenhum campo de resumo)
  • a inteligência de origem não preencheu esse campo (por exemplo, top_competitor pode ser nulo se a marca não tiver concorrentes identificados)

Correção:

  • Use o seletor de campos do Zapier em vez de digitar os caminhos manualmente
  • Verifique o produto: report__product indica quais campos de resumo esperar
  • No AI Visibility, os campos de resumo vêm do extrator: veja a lista de campos em Dados estruturados e Intelligence Tokens

Problema 3: a consulta à API REST retorna 401 Unauthorized

Sintoma: a etapa GET do Webhooks by Zapier falha com 401.

Causa: cabeçalho Authorization ausente ou malformado.

Correção: confirme que o cabeçalho é Authorization: Bearer sur_live_... (incluindo o prefixo Bearer). Ou use X-API-Key: sur_live_... como alternativa.

Problema 4: linhas duplicadas no Google Sheets

Sintoma: o mesmo relatório aparece duas vezes.

Causas:

  • a Surmado tenta de novo as entregas de webhook que falharam (3 tentativas com intervalo crescente): se o seu Zap for lento, a Surmado pode tentar de novo antes de o Zapier confirmar o recebimento
  • você configurou o webhook_url em dois relatórios da mesma marca

Correção:

  • Responda rápido: o Catch Hook do Zapier é rápido por padrão, mas um Filter ou Code sobrecarregado pode atrasar a resposta além do tempo limite de 30 segundos da Surmado
  • Elimine duplicatas por report__id (o Formatter do Zapier ou uma busca no Google Sheets pode verificar se a linha já existe antes de inserir)

Problema 5: o Presence Score aparece como 0-1 em vez de 0-100

Sintoma: o Presence Score aparece como 0.342 em vez de 34.2.

Causa: você está usando um caminho de campo antigo (o formato legado visibility_metrics.presence_rate). O campo de resumo report.summary.presence_score já vem normalizado de 0 a 100.

Correção: use report__summary__presence_score diretamente, sem multiplicar.

Boas práticas

1. Use nomes consistentes para os Zaps

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

Por quê: fica fácil identificá-los no painel do Zapier quando você tem mais de 50 Zaps.

2. Adicione notificações de erro

Adicione uma etapa final aos Zaps críticos que envie um e-mail ou uma mensagem no Slack se uma etapa anterior falhar. As notificações de erro nativas do Zapier são silenciosas por padrão.

3. Use pastas para organizar

Pastas do Zapier (plano Professional):

  • Client Reporting: todos os Zaps do painel de clientes
  • Internal Monitoring: seus próprios relatórios
  • Alerts: alertas de concorrência, clientes em risco

4. Um Catch Hook por produto

Use um Zap com Catch Hook por produto (AI Visibility / Site Audit / Strategy), não um por marca. Filtre por report__product dentro do Zap. Você só precisa configurar o webhook_url uma vez por marca/criação de relatório.

5. Guarde os payloads brutos para reprocessar

Registre o payload completo do webhook em uma planilha ou banco de dados de “eventos brutos”. Se a sua lógica posterior mudar, você poderá reprocessar eventos históricos sem executar os relatórios de novo.

Estimativa de tarefas do Zapier

Fluxos de um único relatório:

  • Acompanhamento (Catch Hook → Filter → Sheets): 3 tarefas
  • Com alerta no Slack: 4 tarefas
  • Notion com etapa de código: 4 tarefas
  • Fluxo completo de agência com alerta condicional: 5-6 tarefas

Painéis de agência (20 clientes/mês):

  • Acompanhamento básico: ~60-80 tarefas/mês
  • Com alertas e vários destinos: ~100-140 tarefas/mês

Plano recomendado:

  • 1-5 clientes: Starter ($20/mês, 750 tarefas)
  • 5-20 clientes: o Starter ainda atende a maioria; o Professional ($50/mês) adiciona Paths + Pastas
  • Mais de 20 clientes: Professional com pastas e filtros

Perguntas frequentes

Posso acionar Zaps sem configurar um webhook?

Sim: como alternativa, o Gmail pode ser acionado por e-mails de hi@surmado.com (a Surmado também avisa por e-mail quando os relatórios são concluídos). Mas os webhooks são mais rápidos, mais confiáveis e trazem o payload completo do resumo. Prefira webhooks.

Preciso pagar o Zapier e a Surmado?

Sim. O Zapier é uma plataforma de automação separada. A Surmado fornece os relatórios, a API REST e a entrega de webhooks. O Zapier conecta os dois.

Posso compartilhar Zaps com clientes?

Sim (plano Professional). Use o Zapier Transfer para copiar um Zap para a conta do cliente no Zapier. Ele pode personalizar conforme as próprias necessidades.

E se os campos do resumo mudarem?

Os formatos de Intelligence Token (SIG-, SCN-, SOL-) são estáveis. Os nomes dos campos do resumo podem crescer com o tempo (novos campos adicionados), mas a intenção é não remover nem renomear os campos existentes. Avisaremos os usuários da API sobre mudanças incompatíveis.

Posso usar o Zapier para análise histórica em massa?

Em parte. Você pode reacionar manualmente os relatórios das marcas que quiser atualizar. Para análise em massa de muitos relatórios históricos, use a API REST diretamente (GET /v1/reports é paginado): veja o Guia de integração da API.

O Zapier funciona com as lacunas de conteúdo do Site Audit?

Sim. Os payloads do Site Audit incluem report.summary.content_gaps_summary como um texto de resumo executivo e report.summary.quick_wins.content_gaps como uma recomendação priorizada. Para a lista completa de lacunas, consulte a API REST e leia public_intelligence.data.audit_data.enrichment.content_gaps.

O Zapier funciona com relatórios de Strategy?

Em parte. Os webhooks de Strategy trazem o token e o link do PDF, não um resumo estruturado. Use-os para acionar fluxos baseados na conclusão (enviar o PDF, criar uma tarefa, avisar a liderança). Os dados estruturados do Strategy não estão expostos na API REST hoje: depende do roadmap.

Precisa de ajuda para configurar integrações com o Zapier? Escreva para hi@surmado.com com o seu caso de uso: podemos oferecer modelos de Zap personalizados ou suporte na integração.

Continue aprendendo com estes guias relacionados

SEO Técnico

Structured Data & Intelligence Tokens

Every Surmado report includes structured JSON for programmatic access. Learn how to integrate AI Visibility, Site Audit, and Strategy data into your tools, dashboards, and automation workflows.

Ler artigo
SEO Técnico

Surmado API Integration Guide

Everything an external developer needs to create an API key, generate reports, and plug Surmado into automated workflows.

Ler artigo
SEO Técnico

The llms.txt Standard: A Complete Technical Guide for Developers

Learn how to implement llms.txt to help AI platforms discover and cite your business. Technical implementation guide with code examples, best practices, and testing strategies.

Ler artigo