Assegnare i candidati

Una volta configurata la valutazione, ogni assegnazione avvia il percorso del candidato: l’agente lo contatta tramite il canale scelto nell’iframe.

Un candidato

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@azienda.it" }
  }'

La risposta 201 contiene l’ID della sessione: { "id": "…" }.

Campo	Obbligatorio	Descrizione
`assessmentId`	sì	Il `testId` ricevuto dall’iframe.
`applicant.email`	sì	Indirizzo e-mail del candidato.
`applicant.phone`	sì	Numero in formato internazionale (E.164), ad esempio `+33612345678`.
`applicant.firstName`, `applicant.lastName`	no	Nome e cognome, ripresi nei messaggi indirizzati al candidato.
`applicant.planning_date`	no	Data di chiamata desiderata, in formato ISO 8601.
`recruiter.email`	consigliato	Il recruiter che ha originato l’assegnazione.

Il recruiter

Trasmetta sempre recruiter.email. Collega il consumo all’azienda cliente, mentre l’ID azienda identifica solo il suo ATS. Per la fissazione dei colloqui e le e-mail, Skillee utilizza anche il calendario e la casella di posta di questo recruiter: se non li ha collegati, l’invio viene rifiutato e le viene restituito il motivo.

Idempotenza

Assegnare due volte la stessa valutazione allo stesso candidato non crea duplicati: finché una sessione è attiva, la chiamata risponde 201 con la sessione esistente. Può quindi ripetere una chiamata la cui risposta è andata persa.

Un lotto di candidati

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@azienda.it" }
  }'

Il lotto può riuscire in parte: la risposta 200 elenca, una accanto all’altra, le sessioni create (sessions) e i candidati rifiutati con il relativo motivo (failed). Un candidato che ha già una sessione attiva per questa valutazione vi compare con il motivo DUPLICATE_ACTIVE_SESSION. Se non è stato possibile creare alcuna sessione, la risposta è un 422 che elenca i motivi; sono descritti in dettaglio nei codici di errore.

Crediti

Ogni percorso consuma crediti dell’azienda cliente, sia per singolo candidato sia in lotto. Senza crediti sufficienti, l’assegnazione viene rifiutata con 402 e il candidato non viene contattato.