Rivalwin × Zapier — Integración
Integración

Conecta Rivalwin
con Zapier

Automatiza la generación de informes de inteligencia competitiva directamente desde tus Zaps. Lanza análisis, recibe los resultados vía webhook y envíalos donde los necesitas — sin intervención manual.

~20 minutos de configuración
Sin app oficial — vía Webhooks by Zapier
Autenticación vía API Key

Zapier no soporta polling nativo — usa el enfoque de dos Zaps

A diferencia de n8n o Make, Zapier no tiene un módulo de bucle o Repeater. Por eso, la forma correcta de integrar la API asíncrona de Rivalwin en Zapier es con dos Zaps separados: uno que lanza el informe y otro que recibe el resultado vía webhook cuando está listo.

Zap 1
Lanzador del informe
Se dispara por un trigger (Schedule, Webhook, etc.), llama a /new_report y guarda el hash si lo necesitas.
Ventaja: Este enfoque es más eficiente que el polling: Rivalwin notifica a Zapier exactamente cuando el informe termina, sin tareas consumiendo tiempo de ejecución.
⚠️
Webhooks by Zapier requiere plan Professional o superior. En el plan gratuito no está disponible como trigger. Verifica tu plan antes de continuar.
Requisitos previos
🔑

API Key de Rivalwin

Generada desde Integraciones & API Keys en tu panel
⚙️

Cuenta Zapier Professional+

Necesario para usar Webhooks by Zapier como trigger
🏷️

rival_ref del competidor

El ID interno del rival que quieres analizar (ej: rvl_4a7e9f12)
💳

Plan con acceso a API

Comprueba que tu plan incluya acceso a la API de Rivalwin
El flujo completo en dos Zaps

Así funciona la integración de principio a fin. Ambos Zaps trabajan de forma independiente y se comunican a través del webhook.

Zap 1 — Paso 1
Trigger (Schedule / Webhook / Manual)
Se ejecuta según la programación o evento que definas.
Zap 1 — Paso 2
Webhooks by Zapier — POST /new_report
Envía los parámetros del informe a Rivalwin. Puedes ignorar la respuesta — Rivalwin se encargará de llamar al Zap 2 al terminar.
↓ · · · (1–5 minutos de procesamiento) · · · ↓
Zap 2 — Trigger
Webhooks by Zapier — Catch Hook
Rivalwin llama automáticamente a tu URL cuando el informe termina. El Zap 2 se activa con el payload completo.
Zap 2 — Pasos siguientes
Procesa y envía los datos
Filtra el status, extrae los campos del informe y envía a Slack, Google Sheets, Gmail, Notion u otro destino.
ℹ️
Tiempo de procesamiento: Los informes tardan entre 1 y 5 minutos. El Zap 2 se activará automáticamente en cuanto Rivalwin termine — no hay polling ni esperas configuradas manualmente.
Crea el Zap que lanza el informe

Este Zap es el encargado de disparar la creación del informe en Rivalwin. Puede activarse de forma programada, desde otro sistema o manualmente.

01
Trigger

Configura el trigger del Zap 1

Crea un nuevo Zap en Zapier y elige el trigger según tu caso de uso.

Schedule by Zapier
o
Webhooks — Catch Hook
o
Cualquier app trigger

Para ejecuciones automáticas semanales o diarias usa Schedule by Zapier. Si quieres lanzar el informe desde otra herramienta (CRM, Notion, Slack…), usa el trigger de esa app como punto de entrada.

02
Acción HTTP

Lanza el informe con Webhooks by Zapier — POST

Añade una acción Webhooks by Zapier > POST y configúrala para llamar al endpoint /new_report.

CampoValor
URLhttps://rivalwin.com/api/v1/meta/companies/new_report
Payload TypeJSON
Headers — X-API-KeyTu API Key de Rivalwin
Unflattenyes

Campos del body — añádelos en la sección Data del módulo Webhooks:

KeyValue
rival_refrvl_4a7e9f12
date_fromFecha hace 30 días en formato YYYY-MM-DD — ver nota abajo
date_toFecha de anteayer en formato YYYY-MM-DD — ver nota abajo
countryES
⚠️
Fechas en Zapier: Zapier no tiene funciones de fecha nativas en el módulo Webhooks. Usa un paso previo de Formatter by Zapier > Date/Time > Format para calcular today - 30 days y today - 2 days y luego mapea esos valores en los campos del Webhook.

Si prefieres enviar el body como JSON raw, activa Payload Type: JSON y usa este bloque — adaptando las fechas con Formatter antes:

JSON — Body del request
{
  "rival_ref": "rvl_4a7e9f12",
  "date_from": "{{date_from_formatter}}",
  "date_to": "{{date_to_formatter}}",
  "country": "ES"
}
💡
No necesitas guardar ni usar el hash de la respuesta — Rivalwin lo incluirá automáticamente en el payload que envíe al webhook del Zap 2 cuando termine el informe.
Crea el Zap que recibe y procesa el informe

Este Zap se activa automáticamente cuando Rivalwin termina de generar el informe y llama a tu URL de webhook. Aquí procesas los datos y los envías al destino final.

03
Trigger Webhook

Crea el trigger de Webhooks by Zapier — Catch Hook

Crea un segundo Zap. Como trigger, selecciona Webhooks by Zapier > Catch Hook. Zapier te generará una URL única — cópiala.

💡
La URL tendrá el formato https://hooks.zapier.com/hooks/catch/XXXXXXX/YYYYYYY/. Esta es la URL que pegarás en el panel de Rivalwin en el siguiente paso.
04
Configuración Rivalwin

Registra el webhook en Rivalwin

Con la URL del Catch Hook copiada, ve a tu panel de Rivalwin y configura el webhook.

  1. Ve a Integraciones & API Keys en tu panel de Rivalwin.
  2. Pega la URL de Zapier en el campo Webhook URL.
  3. Guarda los cambios.
Panel de Integraciones de Rivalwin con el campo webhook configurado ampliar

A partir de ahora, cada vez que un informe termine, Rivalwin enviará el payload completo a esa URL y activará este Zap automáticamente.

05
Test del trigger

Captura un payload de prueba

Zapier necesita recibir un payload real para detectar los campos disponibles. Haz clic en Test trigger en Zapier y luego genera un informe de prueba desde tu panel de Rivalwin o lanzando el Zap 1 manualmente.

Una vez que Zapier detecte el payload, verás todos los campos disponibles para mapear en los pasos siguientes:

Payload de ejemplo — campos principales
{
  "status": "DONE",
  "hash": "abc123def456...",
  "report": {
    "rival": { "name": "Competidor S.A." },
    "kpis": {
      "ads_total": 47,
      "impressions_upper": 2400000
    },
    "pdf_url": "https://rivalwin.com/reports/...",
    "insights": { "gpt_analysis": "El competidor..." },
    "ads": [/* array de anuncios */]
  }
}
06
Filtro de seguridad

Añade un filtro para procesar solo informes DONE

Aunque Rivalwin solo llama al webhook cuando el informe termina, añade un Filter by Zapier como primer paso para asegurarte de que solo se procesen los payloads con status = DONE. Esto protege el Zap si en el futuro Rivalwin añade notificaciones de otros estados.

DONEEl Zap continúa — procesa el informe
ERROREl Zap se detiene — no procesa datos incompletos

Configuración del filtro:

  • Campo: status (del trigger Catch Hook)
  • Condición: (Text) Exactly matches
  • Valor: DONE
💡
Si quieres recibir una alerta cuando un informe falla, crea un tercer Zap separado con un Catch Hook distinto y configura ese webhook específicamente para errores en Rivalwin.
07
Destino final

Envía los datos donde los necesitas

Después del filtro, conecta la acción destino que necesites. Mapea los campos del payload directamente desde el trigger del Catch Hook:

Slack
Google Sheets
Gmail
Notion
Airtable
Google Docs

Ejemplo de mensaje de Slack — campos mapeados directamente desde el payload del webhook:

Mensaje Slack — campo Message Text
🔍 Nuevo informe de competencia listo

*Competidor:* {{report__rival__name}}
*Anuncios activos:* {{report__kpis__ads_total}}
*Impresiones estimadas:* {{report__kpis__impressions_upper}}

*Análisis IA:* {{report__insights__gpt_analysis}}

📄 Ver PDF completo: {{report__pdf_url}}
💡
Zapier convierte los objetos anidados del JSON usando doble guión bajo como separador. report.rival.name se mapea como report__rival__name en los campos de las acciones.
Errores comunes y cómo resolverlos
Código / ProblemaErrorSolución en Zapier
401invalid_api_keyVerifica que el header X-API-Key esté configurado correctamente en el módulo Webhooks POST del Zap 1
402insufficient_creditsRevisa los créditos disponibles en tu panel de Rivalwin
403api_not_in_planTu plan de Rivalwin no incluye acceso a la API. Actualiza el plan en Rivalwin
404rival_not_foundEl rival_ref no existe. Verifica el ID en tu panel de Rivalwin
429cooldown_activeEspera al menos 10 segundos entre informes. Si el Zap procesa múltiples competidores, añade un Delay by Zapier de 15 s entre llamadas
400invalid_date_rangedate_to no puede ser hoy ni futuro. Usa Formatter by Zapier para calcular today - 2 days en formato YYYY-MM-DD
Zap 2 no se activaWebhook no llegaVerifica que la URL del Catch Hook esté correctamente pegada en Integraciones & API Keys de Rivalwin y que el Zap 2 esté publicado (ON)
Campos no disponiblesPayload no detectadoVuelve al trigger del Zap 2, haz clic en Test trigger y genera un informe real para que Zapier capture la estructura del payload