Agency-Funktion

Enthalten im Agency-Plan.

Befunde direkt in deine Systeme liefern

Schickt Score-Abfälle, Erholungen und abgeschlossene Crawls per HTTP an eigene Endpunkte – signiert, sodass der Empfänger die Quelle prüfen kann.

4 Prüfungen Ergebnis in Sekunden Webhooks öffnen Pläne ansehen

Eine E-Mail funktioniert – bis sie im Stapel der anderen 40 untergeht. Wer auf Score-Veränderungen reagieren will, braucht die Meldung dort, wo tatsächlich gearbeitet wird: im Chat-Kanal des Teams, im Ticket-System oder in der eigenen Auswertungs-Pipeline.

Webhooks liefern Ereignisse als HTTP-Anfrage an einen beliebigen Endpunkt – Slack, Discord oder die eigene API. Jede Zustellung ist mit einem Secret signiert, sodass der Empfänger prüfen kann, dass die Nachricht wirklich von VitoScore kommt.

Was geprüft wird

Drei Ereignistypen

„Score-Abfall unter Schwellwert", „Score erholt sich wieder" und „Crawl-Analyse abgeschlossen" – pro Webhook frei kombinierbar.

Signierte Zustellung

Eine HMAC-SHA256-Signatur im Header X-VitoScore-Signature belegt die Herkunft jeder Anfrage – Verifizierung ist mit dem eigenen Secret möglich.

Beliebige Ziele

Slack, Discord oder eigene APIs: Erlaubt sind ausschliesslich http- und https-Endpunkte, die URL wird vor dem Speichern validiert.

Kontrolle

Webhooks lassen sich pausieren, aktivieren und löschen; der letzte Auslösezeitpunkt wird angezeigt.

So läuft die Prüfung

  1. 1

    Endpunkt anlegen

    Ziel-URL und die Ereignisse wählen, die zugestellt werden sollen.

  2. 2

    Secret übernehmen

    Das generierte Secret dient dem Endpunkt zur Signatur-Prüfung – es wird genau einmal angezeigt.

  3. 3

    Automatisch geliefert

    Beim nächsten Ereignis trifft die signierte Payload am Endpunkt ein – ohne weiteres Zutun.

Warum das für die Sichtbarkeit zählt

Score-Meldungen verlieren ihren Wert, wenn sie mit Verzögerung gelesen werden. Ein Abfall, der am Montag eintritt und erst am Donnerstag auffällt, hat die halbe Woche lang Rankingschaden verursacht. Im Team-Chat ist das Ereignis in dem Moment da, in dem es passiert.

Dazu kommt die Automatisierung: Ein Posteingangs-Hauptquartier, das auf Signaturen prüft, kann aus einem Score-Drop automatisch ein Ticket eröffnen, einen Kollegen erwähnen oder einen Kontrolllauf anstossen – ohne dass jemand die Loop überwacht.

Häufige Fragen

Welche Ereignisse gibt es?

Drei: „Score-Abfall unter Schwellwert" (score_drop), „Score erholt sich wieder" (score_recover) und „Crawl-Analyse abgeschlossen" (crawl_done). Pro Webhook wird festgelegt, welche davon zugestellt werden.

Wie verifiziert der Endpunkt die Nachricht?

Über den Header X-VitoScore-Signature. Er enthält das HMAC-SHA256-Signatur des Request-Bodys, berechnet mit dem geheimem Secret des Webhooks – der Empfänger macht die Rechnung nach.

Kann ich einen Webhook testen?

Es gibt kein Test-Ereignis – die Zustellung erfolgt bei einem echten Ereignis. Das Formular zeigt eine Beispiel-Payload, gegen die der Endpunkt vorab entwickelt werden kann.

Wohin darf ich senden?

An jede http- oder https-URL. Damit ist der Weg zu Slack- und Discord-Webhook-URLs offen, aber auch zu beliebigen eigenen Endpunkten – internen Adressen werden nicht zugestellt.

Weitere Werkzeuge