Webhooks, Zapier und Make

Was du bekommst

• Events: score.dropped, visibility.lost, visibility.gained, scan.completed, answers.updated, site.created, site.deleted.
• Eine HMAC-Signatur bei jeder Anfrage, damit du prüfen kannst, dass sie von uns kommt.
• Automatische Neuversuche nach 5 Minuten, 30 Minuten, 2 Stunden, 6 Stunden und 24 Stunden.
• Ein Zustellprotokoll auf der Seite „Integrationen“, das zeigt, was gesendet wurde und wie dein Endpunkt geantwortet hat.

Bevor du startest

• Ein OLAB Assist-Account im Paket Agency, angemeldet als Account-Inhaber.
• Ein Account bei Zapier, Make oder n8n oder ein eigener https-Endpunkt.

Schritt für Schritt einrichten

1. 1

   Catch Hook erstellen

   Zapier: neuer Zap → Trigger Webhooks by Zapier → Catch Hook. Make: neues Szenario → Webhooks → Custom webhook. n8n: ein Webhook-Node mit der Methode POST. Kopiere die Adresse, die du erhältst.

2. 2

   In OLAB Assist hinzufügen

   Integrationen → Webhooks: Füge die Adresse ein, stell das Format auf JSON, hak die gewünschten Events an und klick auf Webhook anlegen. Kopiere das Signatur-Secret, das nur einmal angezeigt wird.

3. 3

   Test senden

   Klick auf Test senden. Dein Tool erhält ein ping-Event und lernt die Felder kennen.

4. 4

   Aktion hinzufügen

   Zum Beispiel Asana → Create Task mit dem Titel „Score gefallen auf {{data.site.domain}}“ und dem Report-Link aus data.report_url. Füge einen Filter auf type hinzu, wenn ein Hook mehrere Events empfängt.

5. 5

   Aktivieren

   Veröffentliche den Zap oder das Szenario. Ab jetzt löst jedes passende Event ihn aus.

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

Tips

• Nutze einen Webhook pro Ziel. Jeder hat eigene Events, einen eigenen Schwellenwert und ein eigenes Secret.
• Nutze die id des Events, um Duplikate zu ignorieren: Ein erneut gesendetes Event behält seine id.
• Für Entwickler: Prüf OLAB-Signature wie in der Entwicklerdokumentation beschrieben.

Troubleshooting

Questions