Bewerber zuweisen

Sobald die Bewertung konfiguriert ist, löst jede Zuweisung den Ablauf für den Bewerber aus: Der Agent kontaktiert ihn über den im Iframe gewählten Kanal.

Ein Bewerber

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" }
  }'

Die Antwort 201 enthält die ID der Sitzung: { "id": "…" }.

Feld	Pflicht	Beschreibung
`assessmentId`	ja	Die vom Iframe erhaltene `testId`.
`applicant.email`	ja	E-Mail-Adresse des Bewerbers.
`applicant.phone`	ja	Nummer im internationalen Format (E.164), zum Beispiel `+33612345678`.
`applicant.firstName`, `applicant.lastName`	nein	Vor- und Nachname, werden in den Nachrichten an den Bewerber verwendet.
`applicant.planning_date`	nein	Gewünschtes Anrufdatum im Format ISO 8601.
`recruiter.email`	empfohlen	Der Recruiter, von dem die Zuweisung ausgeht.

Der Recruiter

Übermitteln Sie immer recruiter.email. Damit wird der Verbrauch dem Kundenunternehmen zugeordnet, während die Unternehmens-ID nur Ihr ATS identifiziert. Für die Terminvereinbarung und die E-Mails nutzt Skillee außerdem den Kalender und das Postfach dieses Recruiters: Hat er sie nicht verbunden, wird der Versand abgelehnt und Ihnen der Grund zurückgemeldet.

Idempotenz

Wird dieselbe Bewertung demselben Bewerber zweimal zugewiesen, entsteht kein Duplikat: Solange eine Sitzung aktiv ist, antwortet der Aufruf mit 201 und der bestehenden Sitzung. Sie können also einen Aufruf wiederholen, dessen Antwort verloren gegangen ist.

Ein Batch von Bewerbern

curl https://api-charlee2.skillee.ai/partners/charlee/v2/launch/interview \
  -H "Authorization: Bearer $COMPANY_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "interview_id": "<testId>",
    "applicants": [
      { "firstName": "Marie", "lastName": "Dupont", "email": "marie.dupont@example.com", "phone": "+33612345678" },
      { "firstName": "Karim", "lastName": "Benali", "email": "karim.benali@example.com", "phone": "+33698765432" }
    ],
    "recruiter": { "email": "recruiter@firma.de" }
  }'

Der Batch kann teilweise erfolgreich sein: Die Antwort 200 listet nebeneinander die erstellten Sitzungen (sessions) und die abgelehnten Bewerber mit ihrem Grund (failed) auf. Ein Bewerber, der für diese Bewertung bereits eine aktive Sitzung hat, erscheint dort mit dem Grund DUPLICATE_ACTIVE_SESSION. Konnte keine Sitzung erstellt werden, ist die Antwort ein 422, der die Gründe aufzählt; sie sind in den Fehlercodes beschrieben.

Credits

Jeder Ablauf verbraucht Credits des Kundenunternehmens, einzeln wie im Batch. Ohne ausreichende Credits wird die Zuweisung mit 402 abgelehnt und der Bewerber nicht kontaktiert.