Webhooks — Übersicht

Warum es wichtig ist

Webhooks übertragen Ereignisdaten an Ihre Systeme, sobald etwas passiert — ein Kandidat bewirbt sich, ein Interview wird geplant, eine Stellenanzeige wird veröffentlicht. Anstatt eine API abzufragen, empfangen Ihre Integrationen sofortige HTTP-Callbacks mit der vollständigen Ereignisnutzlast.

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 generiert ein Signiergeheimnis, mit dem Sie Nutzlasten verifizieren.

Verfügbare Ereignisse

Kit löst Webhooks in sechs Kategorien aus:

Bewerbungsereignisse

Ereignis	Wird ausgelöst wenn
application.submitted	Ein Kandidat eine Bewerbung einreicht
application.rejected	Eine Bewerbung abgelehnt 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 Administrator ein Angebot annimmt
offer.declined	Ein Administrator ein Angebot ablehnt
offer.candidate_accepted	Ein Kandidat ein Angebot annimmt
offer.candidate_declined	Ein Kandidat ein Angebot ablehnt
offer.revised	Ein Angebot mit neuen Konditionen überarbeitet wird

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-Assignment-Ereignisse

Ereignis	Wird ausgelöst wenn
code_assignment.submitted	Ein Kandidat sein Code Assignment einreicht
code_assignment.auto_submitted	Ein Code Assignment bei Ablauf der Frist automatisch eingereicht wird

Überprüfungsereignisse

Ereignis	Wird ausgelöst wenn
review.submitted	Ein Teammitglied eine Überprüfung 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

Webhooks verwalten

Jeder Webhook zeigt seinen Status, abonnierte Ereignisse und den aktuellen 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 auf Test-Ping senden bei einem Webhook, um ein test.ping-Ereignis an Ihren Endpunkt zu senden. Verwenden Sie es, um die Konnektivität und Signaturvalidierung zu überprüfen, bevor Sie echte Ereignisse abonnieren.

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

Kurz-Checkliste

• 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