Módulo de webhook de Make.com

Conecte los eventos de Zenovay a escenarios de Make.com (antes Integromat): conéctelos a Google Sheets, Airtable, HubSpot, Microsoft 365, Salesforce y más de 1500 aplicaciones adicionales.

El módulo Webhooks → Custom webhook de Make.com es el que capta los eventos de Zenovay.

---

1. Crear el webhook de Make.com

1. En Make.com, cree un nuevo escenario.
2. Haga clic en el botón + → busque "Webhooks" → seleccione Webhooks → Custom webhook.
3. Haga clic en Add para crear un nuevo hook de webhook:
   • Webhook name: Zenovay events (o cualquier nombre que recuerde)
   • IP restrictions: déjelo vacío a menos que desee restringir las IPs de Zenovay (no publicamos una lista de IPs estable: verifique mediante la firma)
   • JSON pass-through: déjelo desactivado (Make.com analizará el body automáticamente)
4. Haga clic en Save y Copy address to clipboard: tendrá el aspecto https://hook.eu2.make.com/abcdef123456.

---

2. Añadir el webhook en Zenovay

1. En app.zenovay.com, vaya a Settings → Webhooks.
2. Seleccione el sitio web que debe disparar los eventos.
3. Haga clic en Add webhook.
4. Complete los campos:
   • Name: Make.com — <nombre del escenario> (por ejemplo, Make.com — Sync to Google Sheets)
   • URL: pegue la dirección del webhook de Make.com del Paso 1
   • Events: seleccione los que el escenario debe responder
5. Haga clic en Create webhook.
6. Haga clic en Send test event (el icono de avión de papel).

---

3. Capturar los datos de muestra en Make.com

1. De vuelta en el módulo de webhook de Make.com, haga clic en Run once en la parte inferior.
2. Make.com escucha el próximo evento entrante. Haga clic en Send test event de nuevo en Zenovay.
3. Make.com captura el payload y muestra los campos disponibles. Haga clic en Save.
4. Añada el(los) siguiente(s) módulo(s): por ejemplo, Google Sheets → Add a Row, y mapee los campos del payload de Zenovay.

---

4. Verificar la firma de Zenovay (recomendado)

Make.com NO verifica firmas HMAC de forma nativa. Para escenarios donde la integridad de la firma es importante, añada un módulo Tools → Set Variables con este filtro:

// In a "Filter" between the webhook and your action modules
{{contains(headers["x-zenovay-signature"]; "sha256=")}}

Para la verificación HMAC completa, necesitaría:

1. Actualizar a un módulo de código personalizado (plan Make.com Premium / Pro), o
2. Anteponer Make.com 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 });

    await fetch(MAKE_WEBHOOK_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.

---

5. Recetas comunes de escenarios

---

Resolución de problemas

• El webhook recibió los datos pero el escenario no se ejecutó: el escenario debe estar activo (interruptor en la esquina inferior izquierda del editor del escenario).
• Los tipos de campo son incorrectos (por ejemplo, un número llega como texto): desactive JSON pass-through en el módulo de webhook para que Make.com analice los tipos automáticamente.
• Límite de operaciones alcanzado: Make.com cuenta cada paso del escenario como una operación. El plan gratuito = 1.000/mes. Filtre los eventos activos (como traffic_spike) en la configuración del webhook de Zenovay para mantenerse dentro del límite.

---

Relacionado

• Receta de catch-hook de Zapier
• Receta de trigger de webhook de n8n
• Referencia de webhook y esquema de payload