Webhooks, Zapier y Make

Qué obtienes

• Eventos: score.dropped, visibility.lost, visibility.gained, scan.completed, answers.updated, site.created, site.deleted.
• Una firma HMAC en cada petición para comprobar que viene de nosotros.
• Reintentos automáticos a los 5 minutos, 30 minutos, 2 horas, 6 horas y 24 horas.
• Un registro de envíos en Integraciones con lo enviado y la respuesta de tu servidor.

Antes de empezar

• Una cuenta de OLAB Assist en el plan Agency, con la sesión del propietario.
• Una cuenta de Zapier, Make o n8n, o una dirección https propia.

Configuración paso a paso

1. 1

   Crea un webhook receptor

   Zapier: nuevo Zap → disparador Webhooks by Zapier → Catch Hook. Make: nuevo escenario → Webhooks → Custom webhook. n8n: un nodo Webhook con método POST. Copia la dirección que te da.

2. 2

   Añádelo en OLAB Assist

   Integraciones → Webhooks: pega la dirección, elige el formato JSON, marca los eventos y pulsa Añadir webhook. Copia el secreto de firma, que se muestra una vez.

3. 3

   Envía una prueba

   Pulsa Enviar prueba. Tu herramienta recibe un evento ping y aprende los campos.

4. 4

   Añade la acción

   Por ejemplo Asana → Create Task con el título “Bajó la puntuación de {{data.site.domain}}” y el enlace de data.report_url. Filtra por type si un webhook recibe varios eventos.

5. 5

   Actívalo

   Publica el Zap o el escenario. A partir de ahora cada evento que coincida lo ejecuta.

{
  "id": "evt_4Hh2…",
  "type": "score.dropped",
  "api_version": "v1",
  "created_at": "2026-10-05T10:00:00.000Z",
  "data": {
    "site": { "id": "k3Jd9x2Lq", "domain": "example.com", "app_url": "…" },
    "previous_score": 86, "score": 71,
    "drop_points": 15, "drop_pct": 17.4,
    "report_url": "https://olabassist.com/r/…"
  }
}

Consejos

• Usa un webhook por destino. Cada uno tiene sus eventos, umbral y secreto.
• Usa el id del evento para ignorar duplicados: un evento reintentado conserva su id.
• Desarrolladores: verifica OLAB-Signature como se explica en la documentación.

Solución de problemas

Preguntas