Zapier Catch-Hook

Verbinden Sie Zenovay-Ereignisse mit allen 5.000+ von Zapier unterstützten Apps — Notion, Airtable, HubSpot, Linear, Trello, Gmail und mehr.

Dieses Rezept verwendet den Webhooks by Zapier → Catch Hook-Trigger.

---

1. Einen Zap mit Catch-Hook-Trigger erstellen

1. Klicken Sie in Zapier auf Create Zap.
2. Wählen Sie als Trigger Webhooks by Zapier → Catch Hook.
3. Überspringen Sie die Aufforderung "Pick off a Child Key" (leer lassen — wir möchten den vollständigen Ereignis-Payload).
4. Zapier zeigt eine Custom Webhook URL wie https://hooks.zapier.com/hooks/catch/12345678/abcdef/ — kopieren Sie diese.

---

2. Den Webhook in Zenovay hinzufügen

1. Gehen Sie in app.zenovay.com zu Settings → Security → API keys und scrollen Sie zum Abschnitt Webhooks.
2. Wählen Sie die Website, die Ereignisse in diesen Zap senden soll.
3. Klicken Sie auf Add webhook.
4. Füllen Sie aus:
   • Name: Zapier — <was der Zap tut> (z. B. Zapier — Add to Notion)
   • URL: Fügen Sie die Zapier Catch-Hook-URL aus Schritt 1 ein
   • Events: Wählen Sie die Ereignisse, auf die der Zap reagieren soll
5. Klicken Sie auf Create webhook.
6. Klicken Sie auf Send test event.

---

3. Den Trigger in Zapier testen

1. Klicken Sie in Zapier auf Test trigger. Zapier sollte jetzt den Zenovay-Test-Ereignis-Payload anzeigen.
2. Klicken Sie auf Continue with selected record.
3. Bauen Sie den restlichen Zap (die Aktionsschritte) mit Feldern aus dem Zenovay-Payload — häufig genutzte Felder:
   • event_type (z. B. traffic_spike, goal_completed)
   • website_id
   • data.* (ereignisspezifischer Payload)
   • timestamp

---

4. Häufige Zap-Rezepte

---

5. Zenovays Signatur verifizieren (fortgeschritten)

Zapiers Catch-Hook verifiziert HMAC-Signaturen nicht nativ. Für Produktions-Zaps, bei denen die Signaturverifizierung wichtig ist (z. B. aus Compliance-Gründen), schalten Sie einen Cloudflare Worker vor den Zap, der die Signatur prüft und weiterleitet:

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');
  },
};

Ihr Webhook-Secret wird unter Settings → Security → API keys angezeigt — erweitern Sie die Webhook-Karte, um das Geheimnis anzuzeigen.

---

Fehlerbehebung

• Zapier "We didn't find a request": Klicken Sie auf Send test event in Zenovay, NACHDEM Sie auf Test trigger in Zapier geklickt haben — Zapier hört ca. 10 Minuten lang zu.
• Zap löst für die gleichen Daten wiederholt aus: Zapiers Catch-Hook dedupliziert NICHT. Wenn Sie Idempotenz wünschen, filtern Sie den idempotency_key, den Zenovay im Payload sendet (oder verwenden Sie im Aktionsschritt einen "Filter by Zapier"-Schritt, der gegen einen vorhandenen Datensatz prüft).
• Lange Felder abgeschnitten: Zapier kürzt Antwort-Samples im Editor, aber der vollständige Payload wird zur Laufzeit geliefert.

---

Verwandtes

• Slack-Webhook-Rezept
• Make.com-Webhook-Modul-Rezept
• Webhook-Referenz & Payload-Schema