Assigner des candidats

Une fois l’évaluation configurée, chaque assignation déclenche le parcours du candidat : l’agent le contacte par le canal choisi dans l’iframe.

Un candidat

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": "recruteur@entreprise.fr" }
  }'

La réponse 201 porte l’identifiant de la session : { "id": "…" }.

Champ	Obligatoire	Description
`assessmentId`	oui	Le `testId` reçu de l’iframe.
`applicant.email`	oui	Adresse du candidat.
`applicant.phone`	oui	Numéro au format international (E.164), par exemple `+33612345678`.
`applicant.firstName`, `applicant.lastName`	non	Prénom et nom, repris dans les messages adressés au candidat.
`applicant.planning_date`	non	Date d’appel souhaitée, au format ISO 8601.
`recruiter.email`	recommandé	Le recruteur à l’origine de l’assignation.

Le recruteur

Transmettez toujours recruiter.email. Il rattache la consommation à l’entreprise cliente, alors que l’identifiant d’entreprise n’identifie que votre ATS. Pour la prise de rendez-vous et les e-mails, Skillee utilise aussi l’agenda et la boîte mail de ce recruteur : s’il ne les a pas connectés, l’envoi est refusé et le motif vous est renvoyé.

Idempotence

Assigner deux fois la même évaluation au même candidat ne crée pas de doublon : tant qu’une session est active, l’appel répond 201 avec la session existante. Vous pouvez donc rejouer un appel dont la réponse s’est perdue.

Un lot de candidats

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": "recruteur@entreprise.fr" }
  }'

Le lot peut réussir en partie : la réponse 200 liste côte à côte les sessions créées (sessions) et les candidats refusés avec leur motif (failed). Un candidat qui a déjà une session active pour cette évaluation y figure avec le motif DUPLICATE_ACTIVE_SESSION. Si aucune session n’a pu être créée, la réponse est un 422 qui énumère les motifs ; ils sont détaillés dans les codes d’erreur.

Crédits

Chaque parcours consomme des crédits de l’entreprise cliente, à l’unité comme en lot. Sans crédits suffisants, l’assignation est refusée en 402 et le candidat n’est pas contacté.