Catch-hook de Zapier

Conecte los eventos de Zenovay a cualquiera de las más de 5.000 aplicaciones compatibles de Zapier: Notion, Airtable, HubSpot, Linear, Trello, Gmail, y muchas más.

Esta receta usa el trigger Webhooks by Zapier → Catch Hook de Zapier.

---

1. Crear un Zap con un trigger Catch Hook

1. En Zapier, haga clic en Create Zap.
2. Para el trigger, seleccione Webhooks by Zapier → elija Catch Hook.
3. Omita el aviso "Pick off a Child Key" (déjelo en blanco: queremos el payload completo del evento).
4. Zapier muestra una Custom Webhook URL como https://hooks.zapier.com/hooks/catch/12345678/abcdef/: cópiela.

---

2. Añadir el webhook en Zenovay

1. En app.zenovay.com, vaya a Settings → Webhooks.
2. Seleccione el sitio web que debe disparar eventos en este zap.
3. Haga clic en Add webhook.
4. Complete los campos:
   • Name: Zapier — <qué hace el zap> (por ejemplo, Zapier — Add to Notion)
   • URL: pegue la URL del Catch Hook de Zapier del Paso 1
   • Events: seleccione los eventos a los que debe reaccionar el zap
5. Haga clic en Create webhook.
6. Haga clic en Send test event (el icono de avión de papel).

---

3. Probar el trigger en Zapier

1. De vuelta en Zapier, haga clic en Test trigger. Zapier debería mostrar ahora el payload del evento de prueba de Zenovay.
2. Haga clic en Continue with selected record.
3. Construya el resto del zap (los pasos de acción) usando los campos del payload de Zenovay. Las opciones más comunes son:
   • event_type (por ejemplo, traffic_spike, goal_completed)
   • website_id
   • data.* (payload específico del evento)
   • timestamp

---

4. Recetas comunes de zaps

---

5. Verificar la firma de Zenovay (avanzado)

El Catch Hook de Zapier no verifica firmas HMAC de forma nativa. Para zaps en producción donde la verificación de la firma es importante (por ejemplo, cumplimiento normativo), anteponga el zap con un Cloudflare Worker que verifique y reenvíe:

import { createHmac } from 'crypto';

export default {
  async fetch(req) {
    const rawBody = await req.text();
    const signature = req.headers.get('x-zenovay-signature') || '';
    const provided = signature.replace(/^sha256=/, '');
    const expected = createHmac('sha256', YOUR_WEBHOOK_SECRET)
      .update(rawBody)
      .digest('hex');

    if (provided !== expected) return new Response('invalid signature', { status: 401 });

    // Forward to Zapier
    await fetch(ZAPIER_CATCH_HOOK_URL, {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: rawBody,
    });
    return new Response('ok');
  },
};

Su secreto de webhook se muestra en Settings → Webhooks → haga clic en el icono del ojo en la tarjeta del webhook.

---

Resolución de problemas

• Zapier dice "We didn't find a request": haga clic en Send test event en Zenovay DESPUÉS de hacer clic en Test trigger en Zapier: Zapier escucha durante aproximadamente 10 minutos.
• El zap se dispara repetidamente con los mismos datos: el Catch Hook de Zapier NO deduplica. Si desea idempotencia, filtre en idempotency_key que Zenovay envía en el payload (o en el paso de acción, use un paso Filter by Zapier que comprueba contra un registro existente).
• Campos largos truncados: Zapier trunca las muestras de respuesta en el editor, pero el payload completo se entrega en tiempo de ejecución.

---

Relacionado

• Receta de webhook de Slack
• Receta de módulo de webhook de Make.com
• Referencia de webhook y esquema de payload