Saltar al contenido principal

Guía de integración con Zapier

Respuesta rápida: Automatiza los informes de Surmado con Zapier. Apunta webhook_url de Surmado a un trigger Catch Hook de Zapier. Zapier recibe el payload de informe completado (con las métricas del resumen ya extraídas) y lo envía a Google Sheets / Slack / Notion / correo. Para obtener datos más profundos, haz después una consulta a la API REST con tu clave de API. Incluye cinco flujos de trabajo comunes: seguimiento trimestral, alertas de competencia, paneles en Notion, resúmenes de Strategy y reportes multicliente para agencias.

Tiempo de lectura: 18 minutos

En esta guía:

  • Arma una automatización de seguimiento trimestral recibiendo el webhook report.completed de Surmado, leyendo report.summary.presence_score y los campos relacionados, y agregando una fila a Google Sheets (3 tareas de Zapier por Job)
  • Crea alertas de competencia para posicionamiento débil con Filter by Zapier sobre report.summary.competitive_rank y publicando en Slack solo cuando la posición sea mayor que 3 (4 tareas cuando se activa)
  • Configura la integración con una base de datos de Notion para los informes de Site Audit usando report.summary.seo_score, performance_score, accessibility_score y critical_issues_count, más el objeto quick_wins (4 tareas por Job)
  • Envía resúmenes de Strategy a la dirección: los webhooks de Strategy no incluyen resumen, pero recibes report.pdf_url (un enlace mágico de 30 días) que puedes incluir directamente en un correo (3 tareas por Job)
  • Arma un panel multicliente para agencias que llene una hoja maestra de Google Sheets con las métricas de todos los clientes, usando report.summary.business_name del payload como filtro de cliente (3-4 tareas por informe de cliente)

Costo: el plan Starter de Zapier ($20/mes) admite estos flujos de trabajo.

Requisitos previos

Lo que necesitas

  1. Cuenta de Zapier (plan Starter como mínimo para Zaps de varios pasos)
  2. Cuenta de Surmado con acceso a la API (incluido en todos los planes: Pay As You Go, Pro y Pro+)
  3. Una clave de API de Surmado (sur_live_...): créala en app.surmado.com en Settings → API Keys
  4. Cuenta de la app de destino (Google Sheets, Slack, Notion, etc.)

Requisitos de plan de Zapier

Plan gratuito:

  • 100 tareas/mes
  • Solo Zaps de un paso
  • No es suficiente para los flujos de Surmado (necesitan varios pasos)

Plan Starter ($20/mes):

  • 750 tareas/mes
  • Zaps de varios pasos (obligatorio)
  • Mínimo recomendado

Plan Professional ($50/mes):

  • Zaps ilimitados
  • Paths (lógica condicional)
  • Recomendado para agencias con varios clientes

El patrón de integración

Los cinco flujos de trabajo de abajo siguen la misma estructura:

  1. Trigger: Webhooks by Zapier, “Catch Hook”. Zapier te da una URL única.
  2. Configura Surmado para enviar por POST los informes completados a esa URL incluyendo webhook_url al crear el informe.
  3. Lee el payload entrante. Zapier aplana el JSON anidado con __ (doble guion bajo), así que report.summary.presence_score se convierte en report__summary__presence_score en el selector de campos de Zapier.
  4. (Opcional) Consulta a la API REST si necesitas campos que no están en el resumen. Llama a GET https://api.surmado.com/v1/reports/{{report__id}} con el encabezado Authorization: Bearer sur_live_YOUR_KEY.
  5. Actúa: escribe en Google Sheets, publica en Slack, crea una página de Notion, etc.

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

Los informes de Strategy ("product": "solutions") llegan sin objeto summary: usa report.pdf_url y report.token.

Flujo 1: seguimiento trimestral en Google Sheets

Caso de uso del seguimiento trimestral

Cada vez que se completa un informe de AI Visibility, agrega las métricas del resumen a una hoja de Google Sheets para llevar un seguimiento en el tiempo.

Configuración del seguimiento trimestral

Paso 1: crea la hoja de Google Sheets

Nombre de la hoja: AI Visibility Tracking

Columnas:

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

Paso 2: crea el Zap con el trigger Catch Hook

Trigger: Webhooks by Zapier → Catch Hook

Zapier te da una URL como https://hooks.zapier.com/hooks/catch/12345/abcdef/. Cópiala.

Paso 3: configura Surmado para enviar el webhook

Al crear un informe de AI Visibility por la API, incluye 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/"
  }'

Genera un informe para que Zapier capture un payload de muestra. (También puedes usar primero webhook.site para ver la forma del payload antes de conectar Zapier.)

Paso 4: Filter, procesa solo los informes de AI Visibility completados

Acción: Filter by Zapier

Condiciones (deben cumplirse todas):

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

Paso 5: agrega la fila a Google Sheets

Acción: Google Sheets → Create Spreadsheet Row

Asignación de columnas:

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

Paso 6: prueba y activa

Prueba: Genera un informe real de AI Visibility con la URL del webhook. Confirma que aparezca la fila.

Activa: Enciende el Zap.

Resumen del flujo de seguimiento 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

Tareas de Zapier por Job: 3 tareas.

Flujo 2: alertas de competencia en Slack

Caso de uso de las alertas de competencia

Cuando un informe de AI Visibility muestra que estás por debajo del puesto #3, publica una alerta en Slack.

Configuración de las alertas de competencia

Pasos 1-3: igual que en el Flujo 1

(Catch Hook → configura webhook_url en los informes → captura un payload de muestra)

Paso 4: Filter, alerta solo cuando la posición sea mayor que 3

Acción: Filter by Zapier

Condiciones (deben cumplirse todas):

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

Paso 5: envía el mensaje a Slack

Acción: Slack → Send Channel Message

Canal: #marketing (o el canal de tu equipo)

Mensaje:

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

Resumen del flujo de alertas de competencia

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

Tareas de Zapier cuando se activa: 4 tareas (el filtro cuenta como una tarea).

Flujo 3: resultados de Site Audit en una base de datos de Notion

Caso de uso de Site Audit

Crea una página en una base de datos de Notion por cada informe de Site Audit completado, con los puntajes y las mejoras rápidas principales.

Configuración de Site Audit

Paso 1: crea la base de datos de Notion

Nombre de la base de datos: Site Audit Reports

Propiedades:

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

Pasos 2-3: misma configuración del Catch Hook

Crea un Catch Hook y luego configura los informes de Site Audit para que envíen por POST a esa 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/"
  }'

Paso 4: Filter, procesa solo los Site Audit completados

Condiciones:

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

Paso 5: da formato a las mejoras rápidas con Code by Zapier

Acción: Code by Zapier → Run Python

Input Data:

  • quick_wins: {{report__summary__quick_wins}} (pasa el 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.'}

Paso 6: crea la página de Notion

Acción: Notion → Create Database Item

Base de datos: Site Audit Reports

Asignación de propiedades:

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

Contenido de la 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.

Resumen del flujo de 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

Tareas de Zapier por Job: 4 tareas.

Flujo 4: resumen de Strategy completado

Caso de uso del resumen de Strategy

Cuando se entrega un informe de Strategy, envía un correo a la dirección con el enlace al PDF.

Nota sobre los webhooks de Strategy

Los webhooks de Strategy ("product": "solutions") no incluyen un objeto summary: la salida estructurada del informe de Strategy no está expuesta por ahora en la API REST. Lo que recibes es: report.id, report.token, report.pdf_url y report.data_url. Usa el enlace al PDF en tu resumen.

Configuración del resumen de Strategy

Pasos 1-3: misma configuración del Catch Hook

Crea los informes de 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/"
  }'

Paso 4: Filter, solo los informes de Strategy completados

Condiciones:

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

Paso 5: envía el correo con Gmail

Acción: 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>

Resumen del flujo de Strategy

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

Tareas de Zapier por Job: 3 tareas.

Flujo 5: panel multicliente para agencias

Caso de uso del panel para agencias

Una agencia ejecuta AI Visibility para 20 clientes cada mes. Llena una hoja maestra de Google Sheets con las métricas de cada cliente de forma automática.

Configuración del panel para agencias

Paso 1: crea la hoja maestra

Nombre de la hoja: Client Dashboard

Columnas:

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

Paso 2: un solo Catch Hook para todos los clientes

Crea un único Zap con Catch Hook. Usa el mismo webhook_url en los informes de todos los clientes. Como el payload incluye report.summary.business_name (tomado de la marca que registraste), Zapier puede enrutar por cliente dentro del mismo Zap.

Crea cada cliente como una marca independiente una sola 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"}'

Luego reutiliza el brand_slug que se devuelve al crear los informes.

Paso 3: Filter por report.completed y signal

(Igual que en el Flujo 1.)

Paso 4: calcula el estado con Formatter

Acción: Formatter by Zapier → Numbers → Lookup Table

Input: {{report__summary__presence_score}}

Lookup:

  • 0 a 30: En riesgo
  • 30.01 a 60: Necesita mejoras
  • 60.01 a 100: Líder

Salida: texto del estado.

Paso 5: agrega la fila a la hoja maestra

Acción: Google Sheets → Create Spreadsheet Row

Asignación de columnas:

  • 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: (del Paso 4)

Paso 6: alerta condicional en Slack para clientes en riesgo

Acción: Filter by Zapier

Condición: report__summary__presence_score (Number) Less than 30

Acción: Slack → Send Channel Message

Mensaje:

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

Resumen del flujo del panel para agencias

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

Tareas de Zapier por informe de cliente: 3-4 tareas. Para 20 clientes al mes: unas 70-90 tareas en total (dentro del plan Starter con margen).

Patrones avanzados

Patrón 1: obtén datos más profundos por la API REST

El resumen del webhook cubre la mayoría de las necesidades, pero si quieres desgloses por plataforma (por ejemplo, puntajes de presencia en ChatGPT frente a Claude), obtén el objeto completo public_intelligence:

Acción: Webhooks by Zapier → GET

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

Headers:

  • Authorization: Bearer sur_live_YOUR_API_KEY

Forma de la respuesta (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 },
      "...": "..."
    }
  }
}

En Zapier, esto se aplana a public_intelligence__data__platform_variance__chatgpt__presence_score, etc.

Consulta Datos estructurados e Intelligence Tokens para ver el esquema completo.

Patrón 2: comparación histórica

Caso de uso: Compara el informe nuevo con el del trimestre anterior.

Configuración:

  1. Catch Hook + filtro por signal
  2. Google Sheets → Lookup Spreadsheet Row (busca el token anterior de esta marca)
  3. Webhooks by Zapier → GET al endpoint REST del informe anterior
  4. Code by Zapier → calcula la diferencia (actual - anterior)
  5. Agrega la comparación a la hoja o envíala por correo

Patrón 3: envío a varios destinos

Caso de uso: Los mismos datos a Google Sheets + Notion + Airtable.

Configuración: Un solo Catch Hook → filtro → agrega acciones paralelas de “crear fila/página/registro” para cada destino. Un solo payload de webhook alimenta todos.

Patrón 4: verificación de la firma del webhook (opcional)

Surmado firma cada webhook con X-Surmado-Signature (HMAC-SHA256 sobre el cuerpo JSON canonicalizado). En flujos de alto riesgo, verifica la firma en un paso de Code by Zapier antes de actuar. Consulta la Guía de integración de la API para ver el algoritmo de verificación.

Solución de problemas

Problema 1: el Catch Hook no se dispara

Síntoma: El Zap queda en silencio cuando se completa un informe de Surmado.

Causas:

  • No se incluyó webhook_url en la llamada que crea el informe
  • La URL de Zapier no usa HTTPS (Surmado exige HTTPS; Zapier siempre la usa, pero revisa que no haya errores de escritura)
  • El Zap está apagado
  • El informe falló (busca en su lugar un evento report.failed)

Solución:

  • Usa webhook.site como URL de prueba para confirmar que Surmado envía el payload
  • Revisa el estado del informe con GET /v1/reports/{report_id}: si es failed, recibirás un webhook report.failed, no completed
  • Enciende el Zap y ejecuta un informe de prueba

Problema 2: los campos aparecen vacíos en Google Sheets / Notion

Síntoma: Las filas de destino tienen celdas en blanco.

Causas:

  • La ruta del campo usa un guion bajo en lugar de dos (report_summary_presence_score en vez de report__summary__presence_score)
  • El campo no existe en ese producto (por ejemplo, los informes de Site Audit no tienen presence_score; Strategy no tiene ningún campo de resumen)
  • La inteligencia de origen no llenó ese campo (por ejemplo, top_competitor puede ser null si la marca no tiene competidores identificados)

Solución:

  • Usa el selector de campos de Zapier en lugar de escribir las rutas a mano
  • Verifica el producto: report__product te indica qué campos de resumen esperar
  • En AI Visibility, los campos del resumen vienen del extractor. Consulta Datos estructurados e Intelligence Tokens para ver la lista de campos

Problema 3: la consulta a la API REST devuelve 401 Unauthorized

Síntoma: El paso GET de Webhooks by Zapier falla con 401.

Causa: Falta el encabezado Authorization o tiene un formato incorrecto.

Solución: Confirma que el encabezado sea Authorization: Bearer sur_live_... (con el prefijo Bearer). También puedes usar X-API-Key: sur_live_... como alternativa.

Problema 4: filas duplicadas en Google Sheets

Síntoma: El mismo informe aparece dos veces.

Causas:

  • Surmado reintenta las entregas fallidas de webhook (3 intentos con espera creciente): si tu Zap es lento, Surmado puede reintentar antes de que Zapier confirme la recepción
  • Configuraste el webhook_url en dos informes de la misma marca

Solución:

  • Responde rápido: el Catch Hook de Zapier es rápido por defecto, pero un paso Filter o Code sobrecargado puede retrasar la respuesta más allá del tiempo de espera de 30 segundos de Surmado
  • Elimina duplicados con report__id (Formatter de Zapier o una búsqueda en Google Sheets pueden revisar si ya existe la fila antes de insertar)

Problema 5: el puntaje de presencia parece estar entre 0 y 1 en lugar de 0 a 100

Síntoma: El puntaje de presencia se lee 0.342 en lugar de 34.2.

Causa: Estás usando una ruta de campo obsoleta (el formato heredado visibility_metrics.presence_rate). El campo de resumen report.summary.presence_score ya está normalizado de 0 a 100.

Solución: Usa report__summary__presence_score directamente, sin multiplicar.

Buenas prácticas

1. Usa nombres de Zap consistentes

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

Por qué: así es fácil identificarlos en el panel de Zapier cuando tengas más de 50 Zaps.

2. Agrega notificaciones de error

Agrega un último paso a los Zaps críticos que te envíe un correo o un mensaje de Slack si falla un paso anterior. Las notificaciones de error integradas de Zapier están silenciadas por defecto.

3. Usa carpetas para organizar

Carpetas de Zapier (plan Professional):

  • Client Reporting: todos los Zaps del panel de clientes
  • Internal Monitoring: tus propios informes
  • Alerts: alertas de competencia, clientes en riesgo

4. Un Catch Hook por producto

Ejecuta un Zap con Catch Hook por producto (AI Visibility / Site Audit / Strategy), no uno por marca. Filtra por report__product dentro del Zap. Solo necesitas configurar webhook_url una vez por marca o creación de informe.

5. Guarda los payloads sin procesar para poder reproducirlos

Registra el payload completo del webhook en una hoja o base de datos de “eventos sin procesar”. Si más adelante cambia tu lógica posterior, puedes reproducir eventos históricos sin volver a ejecutar los informes.

Estimación de tareas de Zapier

Flujos de un solo informe:

  • Seguimiento (Catch Hook → Filter → Sheets): 3 tareas
  • Con alerta de Slack: 4 tareas
  • Notion con paso de código: 4 tareas
  • Flujo completo de agencia con alerta condicional: 5-6 tareas

Paneles de agencia (20 clientes al mes):

  • Seguimiento básico: ~60-80 tareas/mes
  • Con alertas y varios destinos: ~100-140 tareas/mes

Plan recomendado:

  • 1-5 clientes: Starter ($20/mes, 750 tareas)
  • 5-20 clientes: Starter sigue funcionando en la mayoría de los casos; Professional ($50/mes) agrega Paths + Folders
  • Más de 20 clientes: Professional con carpetas y filtros

Preguntas frecuentes

¿Puedo activar Zaps sin configurar un webhook?

Sí. Como alternativa, Gmail puede activarse con los correos de hi@surmado.com (Surmado también avisa por correo cuando se completan los informes). Pero los webhooks son más rápidos, más confiables y traen el payload completo con el resumen. Prefiere los webhooks.

¿Tengo que pagar tanto Zapier como Surmado?

Sí. Zapier es una plataforma de automatización aparte. Surmado ofrece los informes, la API REST y la entrega por webhook. Zapier conecta ambos.

¿Puedo compartir Zaps con mis clientes?

Sí (plan Professional). Usa Zapier Transfer para copiar un Zap a la cuenta de Zapier de un cliente. Ellos pueden personalizarlo según sus necesidades.

¿Qué pasa si cambian los campos del resumen?

Los formatos de los Intelligence Tokens (SIG-, SCN-, SOL-) son estables. Los nombres de los campos del resumen pueden crecer con el tiempo (se agregan campos nuevos), pero buscamos no quitar ni renombrar los existentes. Avisaremos a quienes usan la API si hay cambios que rompan la compatibilidad.

¿Puedo usar Zapier para un análisis histórico masivo?

En parte. Puedes volver a generar manualmente informes de las marcas que quieras actualizar. Para un análisis masivo de muchos informes históricos, usa directamente la API REST (GET /v1/reports está paginado): consulta la Guía de integración de la API.

¿Zapier funciona con los vacíos de contenido de Site Audit?

Sí. Los payloads de Site Audit incluyen report.summary.content_gaps_summary como un resumen ejecutivo en texto, y report.summary.quick_wins.content_gaps como una recomendación priorizada. Para la lista completa de vacíos, consulta la API REST y lee public_intelligence.data.audit_data.enrichment.content_gaps.

¿Zapier funciona con los informes de Strategy?

En parte. Los webhooks de Strategy traen el token y el enlace al PDF, no un resumen estructurado. Úsalos para activar flujos basados en la finalización (enviar el PDF, crear una tarea, avisar a la dirección). Los datos estructurados de Strategy no están expuestos hoy en la API REST: depende de la hoja de ruta.

¿Necesitas ayuda para configurar integraciones con Zapier? Escribe a hi@surmado.com con tu caso de uso. Podemos ofrecerte plantillas de Zap a medida o ayuda con la integración.

Continúa aprendiendo con estas guías relacionadas

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.

Leer artículo
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.

Leer artículo
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.

Leer artículo