Webhooks

Webhooks senden automatisch Benachrichtigungen an externe Systeme, wenn bestimmte Events in arkmetis auftreten – z.B. wenn ein Crawl abgeschlossen ist oder ein Alert ausgelöst wird.

Webhook einrichten

1. Öffne Einstellungen → Webhooks in deinem Projekt
2. Klicke auf "Webhook erstellen"
3. Gib die URL ein, an die Events gesendet werden sollen
4. Wähle die Events, die du abonnieren möchtest:
   • crawl.completed – Crawl erfolgreich abgeschlossen
   • crawl.failed – Crawl fehlgeschlagen
   • alert.triggered – Alert-Regel ausgelöst
   • report.generated – Report fertig generiert
   • geo_score.updated – GEO-Score aktualisiert
   • new_issues.found – Neue Issues beim Crawl gefunden
   • project.created – Neues Projekt erstellt
   • project.deleted – Projekt gelöscht
5. Klicke auf "Speichern"

Nach dem Erstellen wird ein Webhook Secret angezeigt (40 Zeichen). Speichere es sicher ab – es wird nur einmal angezeigt. Mit dem Secret kannst du die Echtheit eingehender Webhooks verifizieren.

Webhook testen

Klicke auf "Test senden" neben einem Webhook. arkmetis sendet ein Test-Event an die konfigurierte URL, damit du die Integration prüfen kannst.

Webhook verwalten

• Aktivieren/Deaktivieren – Schalte den Webhook an oder aus, ohne ihn zu löschen
• URL ändern – Aktualisiere die Ziel-URL
• Events ändern – Passe die abonnierten Events an
• Löschen – Entfernt den Webhook und die gesamte Zustellungshistorie

Zustellungshistorie

Für jeden Webhook siehst du die letzten 50 Zustellungsversuche:

• Zeitstempel – Wann wurde gesendet?
• Event-Typ – Welches Event?
• Status – Erfolgreich oder fehlgeschlagen?
• Response – Die Antwort des Empfängers

Fehler-Handling: Bei wiederholten Fehlern wird der Fehlerzähler erhöht. Wenn du einen Webhook reaktivierst, wird der Zähler zurückgesetzt.

Kosten

Webhooks sind kostenlos und im Funktionsumfang des Team-Plans enthalten.

Häufige Fragen

Wofür brauche ich Webhooks? Typische Anwendungen: Slack-Benachrichtigung wenn ein Crawl fertig ist, Ticket in Jira erstellen wenn neue Issues gefunden werden, Dashboard aktualisieren wenn ein Report generiert wird.

Mein Webhook bekommt keine Daten – was ist falsch? Prüfe die Zustellungshistorie – dort siehst du ob der Webhook gesendet wurde und welche Antwort dein Server gegeben hat. Häufige Ursache: Firewall blockiert eingehende Requests.

Kann ich das Webhook Secret nachträglich sehen? Nein. Das Secret wird nur einmal nach der Erstellung angezeigt. Wenn du es verloren hast, lösche den Webhook und erstelle einen neuen.

Wie verifiziere ich eingehende Webhooks? arkmetis signiert jeden Webhook mit dem Secret (HMAC-SHA256). Prüfe die Signatur im X-Signature-Header gegen den Body deines empfangenen Payloads.