Avvio rapido

Un’integrazione segue sempre lo stesso percorso: il suo ATS apre una sessione di configurazione, il recruiter imposta la valutazione in un iframe, poi lei assegna questa valutazione ai candidati. Skillee conduce la conversazione e restituisce il risultato al suo strumento.

Prima di iniziare

Serve l’ID azienda (company_id) che Skillee le fornisce all’attivazione: 32 caratteri esadecimali, ad esempio abc123def4567890abc123def4567890.

Le chiamate si effettuano su https://api-charlee2.skillee.ai. L’host storico https://api-charlie.skillee.ai serve la stessa applicazione: un’integrazione esistente non deve modificare nulla.

Autenticazione

Ogni chiamata include l’ID azienda nell’header Authorization:

Authorization: Bearer abc123def4567890abc123def4567890

Alcuni endpoint accettano company_id anche nel corpo o come parametro di query. Quando l’ID è presente in entrambi i punti, i due valori devono essere identici, altrimenti la chiamata viene rifiutata con 401. Un valore che non è composto da 32 caratteri esadecimali viene rifiutato con 400.

Attenzione

L’ID azienda è un segreto: chiami l’API solo dal suo server, mai dal browser del recruiter.

Il percorso

1. Aprire la sessione di configurazione. Il suo server invia l’offerta a Skillee e riceve l’indirizzo dell’iframe. La chiamata è idempotente: la stessa offerta corrisponde sempre allo stesso processo di selezione.

   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": "Addetto alla preparazione ordini",
       "jobDescription": "Tempo indeterminato a Lione, orario diurno, esperienza come carrellista gradita…"
     }'

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

2. Visualizzare l’iframe. Il recruiter sceglie l’agente, il canale e le domande, poi conferma. L’iframe invia quindi alla sua pagina l’ID della valutazione, il testId. Vedere Iframe di configurazione.

3. Salvare il testId con l’offerta nel suo ATS. Identifica la valutazione per tutte le assegnazioni future.

4. Assegnare la valutazione a un candidato. Skillee lo contatta immediatamente.

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

   { "id": "…" }

   Vedere Assegnare i candidati per i lotti, l’idempotenza e i crediti.

I risultati

Skillee restituisce al suo ATS l’avanzamento di ogni candidato: in attesa, risposto (con il punteggio e il report) o non riuscito (con il motivo). Questo invio passa attraverso la connessione che il nostro team configura con lei all’attivazione; non c’è nulla da interrogare da parte sua.

Senza iframe

Se costruisce una propria schermata di configurazione, chiami direttamente POST /partners/charlee/v2/list/assessments per leggere le valutazioni esistenti di un’offerta, poi POST /partners/charlee/v2/create/interview per crearne o modificarne una. La risposta di quest’ultima contiene l’interview_id, che svolge il ruolo del testId. Entrambi gli endpoint sono descritti nel riferimento API.

Per approfondire

Iframe di configurazione

Assegnare i candidati

Codici di errore

Riferimento API