Schnellstart

Eine Integration folgt immer demselben Ablauf: Ihr ATS öffnet eine Konfigurationssitzung, der Recruiter stellt die Bewertung in einem Iframe ein, dann weisen Sie diese Bewertung den Bewerbern zu. Skillee führt den Austausch und sendet das Ergebnis an Ihr Tool zurück.

Bevor Sie beginnen

Sie benötigen die Unternehmens-ID (company_id), die Skillee Ihnen bei der Aktivierung übergibt: 32 Hexadezimalzeichen, zum Beispiel abc123def4567890abc123def4567890.

Die Aufrufe gehen an https://api-charlee2.skillee.ai. Der historische Host https://api-charlie.skillee.ai bedient dieselbe Anwendung: Eine bestehende Integration muss nichts ändern.

Authentifizierung

Jeder Aufruf trägt die Unternehmens-ID im Header Authorization:

Authorization: Bearer abc123def4567890abc123def4567890

Einige Routen akzeptieren company_id auch im Body oder als Query-Parameter. Ist die ID an beiden Stellen vorhanden, müssen beide Werte identisch sein, sonst wird der Aufruf mit 401 abgelehnt. Ein Wert, der nicht aus 32 Hexadezimalzeichen besteht, wird mit 400 abgelehnt.

Achtung

Die Unternehmens-ID ist ein Geheimnis: Rufen Sie die API nur von Ihrem Server aus auf, niemals aus dem Browser des Recruiters.

Der Ablauf

1. Die Konfigurationssitzung öffnen. Ihr Server sendet das Stellenangebot an Skillee und erhält die Adresse des Iframes. Der Aufruf ist idempotent: Dasselbe Stellenangebot führt immer zum selben Recruiting-Prozess.

   curl https://api-charlee2.skillee.ai/partners/beetween/assessment-builder-sessions \
     -H "Authorization: Bearer $COMPANY_ID" \
     -H "Content-Type: application/json" \
     -d '{
       "offerId": "OFFER-2026-001",
       "jobTitle": "Kommissionierer",
       "jobDescription": "Unbefristet in Lyon, Tagschicht, Staplerschein von Vorteil…"
     }'

   { "iframeUrl": "https://…" }

2. Das Iframe anzeigen. Der Recruiter wählt den Agenten, den Kanal und die Fragen aus und bestätigt dann. Das Iframe sendet daraufhin die ID der Bewertung an Ihre Seite, die testId. Siehe Konfigurations-Iframe.

3. Die testId speichern, zusammen mit dem Stellenangebot in Ihrem ATS. Sie bezeichnet die Bewertung für alle künftigen Zuweisungen.

4. Die Bewertung einem Bewerber zuweisen. Skillee kontaktiert ihn sofort.

   curl https://api-charlee2.skillee.ai/partners/beetween/assessments \
     -H "Authorization: Bearer $COMPANY_ID" \
     -H "Content-Type: application/json" \
     -d '{
       "assessmentId": "<testId>",
       "applicant": {
         "firstName": "Marie",
         "lastName": "Dupont",
         "email": "marie.dupont@example.com",
         "phone": "+33612345678"
       },
       "recruiter": { "email": "recruiter@firma.de" }
     }'

   { "id": "…" }

   Siehe Bewerber zuweisen für Batches, Idempotenz und Credits.

Die Ergebnisse

Skillee meldet Ihrem ATS den Fortschritt jedes Bewerbers: ausstehend, beantwortet (mit Score und Bericht) oder fehlgeschlagen (mit Grund). Diese Rückmeldung läuft über die Verbindung, die unser Team bei der Aktivierung mit Ihnen einrichtet; Sie müssen auf Ihrer Seite nichts abfragen.

Ohne Iframe

Wenn Sie Ihren eigenen Konfigurationsbildschirm bauen, rufen Sie direkt POST /partners/charlee/v2/list/assessments auf, um die bestehenden Bewertungen eines Stellenangebots zu lesen, und dann POST /partners/charlee/v2/create/interview, um eine Bewertung zu erstellen oder zu ändern. Die Antwort dieser zweiten Route enthält die interview_id, die die Rolle der testId übernimmt. Beide Routen sind in der API-Referenz beschrieben.

Weiterführende Themen

Konfigurations-Iframe

Bewerber zuweisen

Fehlercodes

API-Referenz