Webhooks — Übersicht

Warum das zählt

Webhooks übertragen Ereignisdaten an Ihre Systeme, sobald etwas passiert — ein Kandidat bewirbt sich, ein Interview wird geplant, eine Stellenanzeige geht online. Anstatt eine API abzufragen, empfangen Ihre Integrationen sofortige HTTP-Callbacks mit dem vollständigen Event-Payload.

Was Sie benötigen

• Ein Kit-Konto mit Admin-Zugriff
• Einen HTTPS-Endpunkt, der POST-Anfragen empfangen kann

Einrichtung

Navigieren Sie zu Integrationen > Webhooks, klicken Sie auf Neuer Webhook und füllen Sie Folgendes aus:

Feld	Erforderlich	Beschreibung
URL	Ja	Der HTTPS-Endpunkt, der Ereignisse empfangen soll
Beschreibung	Nein	Eine Bezeichnung zur Identifizierung dieses Webhooks
Ereignisse	Ja	Welche Ereignistypen abonniert werden sollen

Wählen Sie einzelne Ereignisse aus oder abonnieren Sie ganze Kategorien. Klicken Sie auf Webhook erstellen, um zu speichern. Kit erzeugt ein Signiergeheimnis, mit dem Sie Payloads verifizieren.

Verfügbare Ereignisse

Kit löst Webhooks in acht Kategorien aus. Dies sind genau die Ereignistypen, die Sie im Webhook-Editor abonnieren können. Die vollständige Payload-Struktur jedes Ereignisses finden Sie in der Webhook-Ereignis-Referenz.

Bewerbungsereignisse

Ereignis	Wird ausgelöst, wenn
application.submitted	Ein Kandidat eine Bewerbung einreicht
application.rejected	Eine Bewerbung abgelehnt wird
application.rejection_reverted	Eine zuvor abgelehnte Bewerbung wieder aufgenommen wird
application.advanced	Eine Bewerbung zur nächsten Phase vorrückt
application.withdrawn	Ein Kandidat seine Bewerbung zurückzieht
application.offer_extended	Einem Kandidaten ein Angebot unterbreitet wird

Angebotsereignisse

Ereignis	Wird ausgelöst, wenn
offer.accepted	Ein Admin ein Angebot im Namen des Kandidaten annimmt
offer.declined	Ein Admin ein Angebot im Namen des Kandidaten ablehnt

Interview-Ereignisse

Ereignis	Wird ausgelöst, wenn
interview.scheduled	Ein Interview geplant wird
interview.confirmed	Ein Kandidat das Interview bestätigt
interview.completed	Ein Interview als abgeschlossen markiert wird
interview.cancelled	Ein Interview abgesagt wird
interview.no_show	Ein Kandidat als nicht erschienen markiert wird

Code-Aufgaben-Ereignisse

Ereignis	Wird ausgelöst, wenn
code_assignment.submitted	Ein Kandidat seine Code-Aufgabe einreicht
code_assignment.auto_submitted	Eine Code-Aufgabe bei Ablauf der Frist automatisch eingereicht wird

Bewertungsereignisse

Ereignis	Wird ausgelöst, wenn
review.submitted	Ein Teammitglied eine Bewertung einreicht

Stellenanzeigenereignisse

Ereignis	Wird ausgelöst, wenn
job_posting.published	Eine Stellenanzeige veröffentlicht wird
job_posting.paused	Eine Stellenanzeige pausiert wird
job_posting.closed	Eine Stellenanzeige geschlossen wird
job_posting.reopened	Eine Stellenanzeige wieder geöffnet wird

CSIRT-Meldungsereignisse

Ereignis	Wird ausgelöst, wenn
csirt.report.submitted	Ein Forscher eine Schwachstellenmeldung einreicht
csirt.report.triaged	Eine Meldung gesichtet wird
csirt.report.validated	Eine Meldung validiert wird
csirt.report.resolved	Eine Meldung behoben wird
csirt.report.fix_verified	Der Fix einer Meldung verifiziert wird
csirt.report.paid	Eine Prämie ausgezahlt wird
csirt.report.dismissed	Eine Meldung zurückgewiesen wird
csirt.report.informative	Eine Meldung als informativ abgeschlossen wird — gültig, aber ohne Handlungsbedarf

CSIRT-Webhooks verfolgen den Status einer Meldung entlang ihres Lebenszyklus. Vorgänge, die den Status nicht ändern – die Bewertung des Schweregrads, die Zuweisung an ein Teammitglied, die Genehmigung einer Prämie –, lösen keinen eigenen Webhook aus. Abonnieren Sie stattdessen die umliegenden Statusereignisse.

csirt.report.dismissed und csirt.report.informative schließen eine Meldung beide ab und sind nicht austauschbar: Eine abgelehnte Meldung wurde zurückgewiesen, eine informative dagegen ist ein gültiger Befund ohne Handlungsbedarf, für den weiterhin ein freiwilliger Bonus gezahlt werden kann. Wenn Ihre Integration „abgeschlossen“ mit „ungültig“ gleichsetzt, abonnieren Sie beide Ereignisse getrennt.

Outreach-Ereignisse

Ereignis	Wird ausgelöst, wenn
outreach.prospect.drafted	Eine Nachricht für einen Kontakt entworfen wird
outreach.message.approved	Eine Outreach-Nachricht genehmigt wird
outreach.message.sent	Eine Outreach-Nachricht gesendet wird
outreach.message.bounced	Eine Outreach-Nachricht als unzustellbar zurückkommt (Bounce)
outreach.message.failed	Eine Outreach-Nachricht nicht gesendet werden kann

Webhooks verwalten

Jeder Webhook zeigt seinen Status, die abonnierten Ereignisse und den jüngsten Lieferverlauf.

• Pausieren — Lieferungen stoppen. Ereignisse, die während der Pause ausgelöst werden, werden nicht in die Warteschlange gestellt.
• Fortsetzen — Einen pausierten oder automatisch deaktivierten Webhook wieder aktivieren. Setzt den Fehlerzähler zurück.
• Bearbeiten — URL, Beschreibung oder abonnierte Ereignisse ändern.
• Geheimnis rotieren — Ein neues Signiergeheimnis generieren. Aktualisieren Sie Ihren Endpunkt, bevor Sie rotieren.
• Löschen — Den Webhook und seinen Lieferverlauf dauerhaft entfernen.

Ihren Endpunkt testen

Klicken Sie bei einem beliebigen Webhook auf Test-Ping senden, um ein test.ping-Ereignis an Ihren Endpunkt zu senden. So prüfen Sie die Konnektivität und die Signaturvalidierung, bevor Sie echte Ereignisse abonnieren.

Der Tab Lieferungen zeigt Anfrage-Header, Antwortstatus und Timing für jeden Lieferversuch.

Auf einen Blick

• Navigieren Sie zu Integrationen > Webhooks
• Fügen Sie Ihre HTTPS-Endpunkt-URL hinzu
• Wählen Sie die Ereignisse aus, die Sie empfangen möchten
• Kopieren Sie Ihr Signiergeheimnis
• Senden Sie einen Test-Ping, um die Konnektivität zu überprüfen
• Implementieren Sie die Signaturverifizierung in Ihrem Endpunkt
• Geben Sie einen 2xx-Statuscode zurück, um den Empfang zu bestätigen