Webhooks für Arbeitgeber

Was Webhooks können

JobsAI sendet neue Bewerbungen als gesicherte HTTPS-Anfrage (Ereignis application.received) an eine von Ihnen registrierte Adresse. Die Nachricht enthält Name, E-Mail und Telefon des Kandidaten, das Anschreiben, die Stellendaten und einen Link zum Bewerbungsdetail - dieselben Informationen wie die Benachrichtigungs-E-Mail, nur maschinenlesbar. Ideal für n8n, Zapier, Make oder Ihr eigenes ATS.

Einrichtung Schritt für Schritt

• Klicken Sie in der Firmenübersicht auf Webhooks (API). Die Funktion steht nur verifizierten Firmen zur Verfügung und wird von Inhabern und Administratoren verwaltet.
• Geben Sie die HTTPS-Adresse Ihres Systems ein und klicken Sie auf Hinzufügen.
• Speichern Sie das Signaturgeheimnis - aus Sicherheitsgründen wird es nur einmal angezeigt.
• Klicken Sie auf Verifizieren: Wir senden ein Test-Ereignis endpoint.verify, und Ihr System muss mit Status 2xx antworten.
• Zugestellt wird nur an verifizierte, aktive Adressen.

Sicherheit

• Jede Anfrage ist mit HMAC-SHA256 signiert. Der Header X-JobsAI-Signature: t=<Zeit>,v1=<Signatur> enthält eine Signatur aus <Zeit>.<Anfragekörper> mit Ihrem Geheimnis - die Prüfung garantiert, dass die Nachricht von JobsAI stammt.
• Der Header X-JobsAI-Event-Id bleibt bei wiederholter Zustellung gleich - nutzen Sie ihn zur Deduplizierung.

Zuverlässige Zustellung

• Wenn die Adresse nicht mit 2xx antwortet, unternehmen wir insgesamt höchstens 6 Versuche. Die Wartezeit zwischen den Versuchen steigt; ein Dienstausfall kann die Wiederaufnahme verzögern. Nach Ausschöpfen der Versuche markieren wir die Zustellung als fehlgeschlagen.
• Der Zustellungsverlauf zeigt jede Zustellung samt Antworten; eine fehlgeschlagene Zustellung senden Sie mit Erneut senden erneut.

Wenn sich eine Person nach dem Zurückziehen erneut bewirbt, entsteht ein neues Ereignis mit derselben Bewerbungs-ID und einem höheren Wert für application.submissionVersion. Wiederholungen desselben Ereignisses behalten dessen ID. Ausstehende Zustellungen für einen älteren Versuch oder eine zurückgezogene Bewerbung werden gestoppt; erneutes Senden umgeht diese Einschränkung nicht.

Verwenden Sie Erneut senden, nachdem Sie die Fehlerursache behoben haben. Eine laufende Zustellung kann nicht gleichzeitig erneut gestartet werden. Wir protokollieren, wer die Wiederholung angefordert hat; das ursprüngliche Ereignis und sein Inhalt bleiben erhalten. Eine erfolgreiche 2xx-Antwort bedeutet, dass Ihr System die Anfrage angenommen hat. Sie bestätigt nicht den Abschluss nachfolgender Verarbeitung in Ihrem ATS.

Weitere Anbindungen

Neben dem Empfang von Bewerbungen über Webhooks können Sie einen registrierten KI-Agenten bevollmächtigen, Stellenanzeigen für Ihr Unternehmen vorzubereiten und zu verwalten. Siehe KI-Agenten für Unternehmen.