Zum Inhalt springen

KI-Interviews mit Ihrem ATS, Ihrer API oder Karriereseite verbinden.

Eine ATS-Integration für KI-Interviews, die öffentliche API mit Webhooks oder das auf Ihrer Karriereseite eingebettete Interview: was jede Variante leistet, wie Sie wählen und wie Sie sie einrichten und testen.

Aktualisiert am 17. November 2026 · 9 Min. Lesezeit

Auf dieser Seite

Kurz gesagt

  • Drei Wege: eine native ATS-Verbindung, die öffentliche API mit Webhooks oder das auf Ihrer Karriereseite eingebettete Interview. Sie können auch mehrere nutzen.
  • ATS: Verknüpfen Sie eine Stelle und eine Phase in Workable, Greenhouse, Teamtailor, Recruitee oder Breezy HR mit einem veröffentlichten Interview. Jeder Kandidat, der in diese Phase verschoben wird, erhält genau eine Einladung, und die Ergebnisse kommen als Notiz zurück.
  • API: Erstellen Sie Kandidaten und Einladungen aus Ihren eigenen Systemen mit einem API-Schlüssel mit begrenzten Berechtigungen, und erfahren Sie über signierte Webhooks, was passiert ist.
  • Einbettung: Führen Sie das Interview mit einem einzigen Skript auf Ihrer eigenen Website durch, nur von den Websites aus, die Sie zulassen.
  • Erst testen: Senden Sie ein Webhook-Testereignis, führen Sie einen Testkandidaten durch die Phase und prüfen Sie Zustell- und Aktivitätsprotokolle, bevor Sie live gehen.

Drei Wege, KI-Interviews anzubinden

Eine ATS-Integration für KI-Interviews erspart Ihren Recruitern das Kopieren und Einfügen: Kandidaten werden aus dem System eingeladen, das Sie bereits nutzen, und die Ergebnisse fließen dorthin zurück. Hat Ihr ATS keine native Verbindung oder stellen Sie über Ihr eigenes Portal ein, erledigen die öffentliche API und die Einbettung dieselbe Aufgabe mit etwas Code.

  • Native ATS-Verbindung. Workable, Greenhouse, Teamtailor, Recruitee und Breezy HR. Ohne Code: Schlüssel einfügen, eine Stelle und eine Phase verknüpfen, und das Verschieben eines Kandidaten in diese Phase versendet die Einladung.
  • Öffentliche API und Webhooks. Ihr System erstellt Kandidaten und Einladungen per REST und ruft Ergebnisse ab; Webhooks melden ihm, wenn etwas passiert.
  • Embed SDK. Ein Skript führt das Interview in einem Frame auf Ihrer Karriereseite aus. Es braucht einen Einladungslink und wird daher zusammen mit der API genutzt.
Video-Tutorial, 3:16. Greenhouse verbinden und die Phase einer Stelle mit einem Interview verknüpfen, dann Slack, ein API-Schlüssel und ein Webhook. Auf Englisch, mit Untertiteln.

Alle drei setzen einen kostenpflichtigen Tarif und einen Unternehmensadmin voraus. Es ist dasselbe Interview, das Kandidaten über einen E-Mail-Link erhalten, einschließlich der Möglichkeit, zu tippen statt zu sprechen.

ATS, API oder Einbettung: die richtige Wahl

Native ATS-VerbindungÖffentliche API und WebhooksEmbed SDK (mit der API)
Am besten fürTeams mit einem der fünf unterstützten ATSJedes andere ATS oder Ihren eigenen WorkflowEine Karriereseite oder ein Portal unter Ihrer Kontrolle
Benötigter CodeKeinerAPI-Aufrufe und ein Webhook-EmpfängerEin paar Zeilen auf der Seite, plus die API
Was die Einladung auslöstDas Verschieben eines Kandidaten in die verknüpfte PhaseIhr API-AufrufIhr API-Aufruf; der Link wird in Ihre Seite eingebunden
Ergebnisse kommen zurück alsNotiz zum Kandidaten im ATSErgebnisse, die Sie nach dem Ergebnis-Webhook abrufenDasselbe; die Seite erfährt nur, dass der Kandidat fertig ist

Beginnen Sie mit der nativen Verbindung, wenn Ihr ATS eine hat. Wählen Sie die API, wenn Sie steuern möchten, wer wann eingeladen wird. Ergänzen Sie die Einbettung, wenn Kandidaten auf Ihrer Website bleiben sollen.

ATS-Integration für KI-Interviews einrichten

ATS verbinden und eine Stelle verknüpfen

  1. Veröffentlichen Sie das Interview. Nur ein veröffentlichtes Interview lässt sich mit einer Stelle verknüpfen.
  2. Öffnen Sie Integrationen → ATS und klicken Sie auf ATS verbinden. Fügen Sie die Zugangsdaten des ATS ein (wo Sie sie finden). testee prüft sie vor dem Speichern beim ATS, speichert sie dann verschlüsselt und zeigt nur einen maskierten Hinweis an.
  3. Richten Sie den Webhook ein. Bei Workable und Breezy HR ist nichts zu tun: testee registriert ihn selbst. Für Greenhouse, Teamtailor und Recruitee legen Sie im ATS einen Webhook mit der Adresse aus der Webhook-Karte der Verbindung an und tauschen das Secret so aus, wie die Karte es beschreibt.
  4. Verknüpfen Sie eine Stelle. Der Tab Stellen listet die offenen Stellen des ATS. Öffnen Sie eine, wählen Sie das veröffentlichte Interview und die Phase, die die Einladung auslöst, und speichern Sie.
  5. Markieren Sie Stellen in New York City in der Verknüpfung, damit Einladungen Ihren Hinweis nach Local Law 144 enthalten und erst 10 Werktage später öffnen.
Eine Workable-Verbindung: ihre Einstellungen, der Webhook und die mit Interviews verknüpften Stellen.
Eine Workable-Verbindung: ihre Einstellungen, die Webhook-Karte und Stellen, die jeweils mit einem veröffentlichten Interview verknüpft sind.

Was für jeden Kandidaten passiert

  • Genau eine Einladung, egal wie oft das ATS das Ereignis sendet. Ereignisse zu Stellen oder Phasen, die Sie nicht verknüpft haben, werden ignoriert.
  • Feste Felder: E-Mail und Name des Kandidaten, Stelle und Phase sowie die Referenz des ATS. Es gibt kein Mapping zu konfigurieren.
  • Ergebnisse als Notiz: der Abdeckungswert (zur Prüfung, keine Einstellungsentscheidung), die Zusammenfassung und ein Link zu den Ergebnissen. Die Rückübertragung lässt sich pro Verbindung abschalten.
  • Fehler: Ein Ausfall wird etwa acht Stunden lang erneut versucht; eine Ablehnung, etwa wenn keine Interviewminuten mehr übrig sind, erscheint im Protokoll.
  • Mehr Zeit für einen Kandidaten, der darum gebeten hat, stellen Sie auf der Seite der Einladung im Dashboard ein, solange er noch nicht begonnen hat.

Pausieren hält Einladungen und Notizen zurück, bis Sie fortsetzen. Lehnt das ATS den Schlüssel später ab, zeigt die Verbindung „Neu verbinden nötig“ an, und Notizen warten.

API und Webhooks für KI-Interviews nutzen

Die öffentliche REST-API kann, was ein Recruiter im Dashboard tut: veröffentlichte Interviews auflisten, Kandidaten anlegen, sie einladen und Ergebnisse abrufen. Die Referenz finden Sie in der API-Dokumentation für KI-Interviews.

API-Schlüssel

  • Legen Sie einen Schlüssel an unter Integrationen → API-Schlüssel. Das Secret (aik_live_…) wird nur einmal angezeigt und als Bearer-Token gesendet, nie in einer URL.
  • Berechtigungen: Geben Sie jedem Schlüssel nur die Berechtigungen, die sein System nutzt, etwa invitations:write und results:read.
  • IP-Allowlist: bis zu 50 Adressen oder Bereiche, etwa die ausgehenden Adressen Ihrer Server.
  • Ablauf: 30 Tage, 90 Tage (Standard), 1 Jahr, ein Datum bis zu 2 Jahre im Voraus oder nie. Die Liste warnt 7 Tage vorher.
  • Ratenlimit: 120 Anfragen pro Minute und Schlüssel.
Der Tab „API-Schlüssel“ mit aktiven und widerrufenen Schlüsseln, ihren Berechtigungen und IP-Regeln.
Der Tab API-Schlüssel: Berechtigungen und IP-Regeln jedes Schlüssels, widerrufene Schlüssel bleiben zur Nachvollziehbarkeit erhalten.

Einen Kandidaten aus Ihrem System einladen

  1. GET /v1/interviews listet Ihre veröffentlichten Interviews auf.
  2. POST /v1/candidates mit Name und E-Mail. Ein zweiter Kandidat mit derselben E-Mail wird abgelehnt, speichern Sie also die ID.
  3. POST /v1/invitations mit beiden IDs. Die Antwort enthält den Link, der nur einmal angezeigt wird; testee sendet ihn dem Kandidaten außerdem per E-Mail.
  4. Senden Sie einen Idempotency-Key-Header bei jedem POST. Ein erneuter Versuch mit demselben Schlüssel nach einem Timeout legt nichts doppelt an (Schlüssel gelten 24 Stunden).
Optionales EinladungsfeldWas es bewirkt
externalIdIhre eigene ID (etwa die der Bewerbung). Sie kommt in der Einladung und in jedem Webhook zurück
returnUrlNach dem Abschluss sieht der Kandidat eine Schaltfläche zurück zu dieser https-Adresse (nicht in der Einbettung)
extraTime25, 50 oder 100 Prozent mehr Zeit für einen Kandidaten, der darum gebeten hat; ein Interview dauert höchstens 60 Minuten, mehr Zeit eingerechnet. Wird nie von der API zurückgegeben oder in Webhooks gesendet
nycNoticeDer Kandidat lebt in New York City: Die E-Mail enthält Ihren Hinweis, und das Interview öffnet 10 Werktage später
skipSignInIhre Website hat den Kandidaten bereits angemeldet: Der Link allein öffnet das Interview (siehe Einbettung)

Webhooks

Fügen Sie unter Integrationen → Webhooks einen Endpunkt hinzu: eine öffentliche https-URL und ihre Ereignisse, nämlich invitation.created, invitation.opened, invitation.resent, invitation.revoked, invitation.expired, session.started, session.completed, results.failed, review.decision_changed, candidate.erased und results.ready. Payloads enthalten nur IDs und Ihre externalId, nie Namen oder Werte; bei results.ready rufen Sie GET /v1/sessions/{id}/results ab.

  • Prüfen Sie jede Signatur: ein HMAC-SHA256 aus Zeitstempel und unverändertem Body, mit dem Secret des Endpunkts als Schlüssel. Vergleichen Sie in konstanter Zeit und lehnen Sie Zeitstempel ab, die älter als 5 Minuten sind (Code in der Webhook-Dokumentation).
  • Antworten Sie innerhalb von 10 Sekunden mit 2xx. Fehlschläge werden etwa 24 Stunden lang mit Backoff erneut versucht.
  • Rechnen Sie mit Wiederholungen und beliebiger Reihenfolge: Überspringen Sie bereits verarbeitete Ereignis-IDs und lesen Sie den aktuellen Stand über die API.

Das Interview in Ihre Karriereseite einbetten

Ein auf der Karriereseite eingebettetes Interview hält Kandidaten auf Ihrer Website: Ein Skript stellt das Interview in einen Frame und meldet, was der Kandidat tut (Embed-SDK-Dokumentation).

Das Interview einbetten

  1. Lassen Sie Ihre Website zu unter Integrationen → Einbetten: ein https-Origin ohne Pfad, bis zu 20. Anderswo lädt das Interview in keinem Frame.
  2. Erstellen Sie die Einladung auf Ihrem Server und übergeben Sie ihren Link an die Seite. Der API-Schlüssel gehört nie in die Seite.
  3. Binden Sie es ein mit TesteeEmbed.mount: ein Container, der Link und eine onEvent-Funktion. Der Tab Einbetten im Dashboard zeigt das Snippet.
  4. Verarbeiten Sie die Ereignisse: ready, login_required, started, completed, feedback_submitted und error, jeweils nur mit IDs.

Den Anmeldecode überspringen

Standardmäßig meldet sich der Kandidat im Frame mit einem 6-stelligen Code an, der ihm per E-Mail zugeht; Ihre Seite sieht ihn nie. Hat Ihre Website den Kandidaten bereits angemeldet, erstellen Sie die Einladung über die API mit skipSignIn, und der Link allein öffnet das Interview. Im Dashboard lässt sich das nicht einstellen.

  • Der Kompromiss: Der Link wird zum einzigen Schlüssel, und jeder, der ihn hat, kann das Interview absolvieren. Begrenzen Sie die Gültigkeit auf ein bis zwei Tage, erstellen Sie die Einladung kurz bevor der Kandidat beginnt, und zeigen Sie sie nur hinter Ihrer eigenen Anmeldung.
  • Zur Nachvollziehbarkeit: Die Einladung zeigt „Anmeldung übersprungen“, und die Ergebnisse vermerken, dass die Identität von der Website Ihres Unternehmens bestätigt wurde.

Testen Sie vor dem Livegang

Ein Testlauf

  1. Verwenden Sie einen Testkandidaten mit einer E-Mail-Adresse, die Sie lesen können; Vorschauen durch Teammitglieder senden keine Webhooks.
  2. Senden Sie ein Webhook-Testereignis über das Menü des Endpunkts: ein signiertes test.ping, das also auch Ihren Signaturcode prüft.
  3. Lesen Sie das Zustellprotokoll auf der Seite des Endpunkts. „Erneut zustellen“ sendet eine Zustellung noch einmal mit derselben ID und prüft so, dass Sie Wiederholungen überspringen.
  4. Verschieben Sie den Kandidaten in die verknüpfte Phase und prüfen Sie den Tab Aktivität der ATS-Verbindung: Jedes Ereignis, jede Einladung und jede Notiz ist erledigt, wird erneut versucht, fehlgeschlagen oder ignoriert.
  5. Absolvieren Sie das Interview und prüfen Sie, ob results.ready eingetroffen ist oder die Notiz im ATS erscheint. Lösungen für häufige Probleme finden Sie in der ATS-Fehlerbehebung.

Sicherheitshinweise

  • Schlüssel bleiben auf dem Server, einer pro System, nur mit den nötigen Berechtigungen, einer IP-Allowlist und einem Ablaufdatum. Widerrufen Sie einen Schlüssel, wenn Sie ein Leck vermuten.
  • Erst prüfen, dann vertrauen: Lehnen Sie Webhooks ab, deren Signatur oder Zeitstempel nicht stimmt, und lesen Sie die Daten über die API.
  • Lassen Sie nur Ihre eigenen Websites zu für die Einbettung.
  • Einladungslinks sind persönlich: Protokollieren oder teilen Sie sie nie, vor allem nicht mit skipSignIn.

Slack-Benachrichtigungen

Verbinden Sie unter Integrationen → Slack über „Zu Slack hinzufügen“ oder einen eingehenden Webhook, wählen Sie, welche Benachrichtigungen gepostet werden, etwa „Ergebnisse bereit“, und senden Sie eine Testnachricht (Slack-Dokumentation).

Zusammenfassung

  • Mit einem der fünf unterstützten ATS nutzen Sie die native Verbindung: Verknüpfen Sie jede Stelle und Phase mit einem veröffentlichten Interview.
  • Andernfalls nutzen Sie die API mit Schlüsseln mit begrenzten Berechtigungen und Ablaufdatum sowie Idempotency-Key-Headern, und prüfen Sie jeden Webhook.
  • Damit Kandidaten auf Ihrer Website bleiben, ergänzen Sie die Einbettung, und überspringen Sie den Anmeldecode nur hinter Ihrer eigenen Anmeldung.
  • Vor dem Livegang führen Sie einen Testkandidaten einmal komplett durch.

Fragen und Antworten

Lässt sich testee mit Greenhouse oder Workable integrieren?

Ja, nativ, ebenso mit Teamtailor, Recruitee und Breezy HR. Sie verknüpfen eine Stelle und eine Phase mit einem veröffentlichten Interview; jeder Kandidat, der in diese Phase verschoben wird, erhält genau eine Einladung, und die Ergebnisse kommen als Notiz zurück.

Gibt es eine API für KI-Interviews?

Ja. Die REST-API erstellt Kandidaten und Einladungen, meldet deren Status und liefert Ergebnisse, PDF-Berichte und CSV-Exporte. Signierte Webhooks informieren Ihr System, wenn etwas passiert.

Mein ATS wird nicht unterstützt. Kann ich es trotzdem anbinden?

Ja, über die API: Erstellen Sie die Einladung, wenn der Kandidat die richtige Phase erreicht, hinterlegen Sie Ihre externalId darauf und rufen Sie die Ergebnisse ab, sobald results.ready eintrifft.

Können Kandidaten das Interview auf unserer Karriereseite absolvieren?

Ja, mit dem Embed SDK: Lassen Sie Ihre Website unter Integrationen → Einbetten zu, erstellen Sie die Einladung über die API und binden Sie sie in Ihre Seite ein.

Bewegt das Ergebnis Kandidaten im ATS weiter?

Nein. testee verschiebt oder lehnt nie einen Kandidaten ab. Die Notiz enthält den Abdeckungswert, gekennzeichnet als Grundlage für die Prüfung und nicht als Einstellungsentscheidung; entscheiden muss ein Mensch.

Was gehört auf eine Checkliste für die ATS-Integration?

Welche Stellen und Phasen einladen, wer für die Schlüssel verantwortlich ist, wie Webhooks geprüft werden, was ans ATS zurückgeht, wie Fehler bemerkt werden, wie mit Kandidaten aus New York City und Anträgen auf Anpassungen umgegangen wird, und ein Testlauf.

Quellen

  1. testee-Entwicklerdokumentation: ATS-Integrationen
  2. testee-Entwicklerdokumentation: REST-API
  3. testee-Entwicklerdokumentation: Webhooks
  4. testee-Entwicklerdokumentation: Embed SDK
  5. testee-Entwicklerdokumentation: Slack
  6. Standard-Webhooks-Spezifikation
  7. RFC 2104, HMAC: Keyed-Hashing for Message Authentication

Probieren Sie esbei Ihrer nächsten Stelle aus.

Erstellen Sie in wenigen Minuten ein strukturiertes KI-Interview aus Ihrer Stellenbeschreibung.14 Tage kostenlos, keine Karte nötig.