Iframe di configurazione

L’iframe è la schermata in cui il recruiter imposta la valutazione di un’offerta: l’agente (preselezione, informazioni aggiuntive o fissazione dei colloqui), il canale di contatto, le domande e la loro importanza. Skillee propone una prima bozza di piano a partire dal testo dell’offerta; il recruiter la modifica e poi conferma.

Visualizzare l’iframe

L’indirizzo proviene dalla chiamata POST /partners/beetween/assessment-builder-sessions (vedere l’avvio rapido). Lo carichi così com’è, senza modificarlo né memorizzarlo nella cache: contiene l’azienda e l’offerta.

<iframe
  src="https://…"
  title="Configurazione della valutazione Skillee"
  style="width: 100%; height: 760px; border: 0"
></iframe>

L’interfaccia dell’iframe segue la lingua del browser del recruiter. Per imporla, aggiunga lang all’indirizzo: &lang=en, &lang=de… (fr, en, de, es, it, pt). Questa impostazione riguarda solo la schermata: la lingua in cui l’agente parla al candidato si sceglie nell’iframe.

Recuperare l’ID della valutazione

Quando il recruiter conferma, l’iframe salva la valutazione e poi invia due messaggi alla sua pagina con postMessage. Il primo contiene solo l’ID da conservare:

// iframeUrl: l'indirizzo ricevuto all'apertura della sessione.
const SKILLEE_ORIGIN = new URL(iframeUrl).origin;

window.addEventListener('message', (event) => {
  if (event.origin !== SKILLEE_ORIGIN) return;
  if (event.data?.testId) {
    // Da salvare con l'offerta: è l'`assessmentId` delle assegnazioni.
    saveAssessmentId(event.data.testId);
  }
});

Tutti i messaggi

Messaggio	Quando	Contenuto
`{ testId }`	La valutazione è stata salvata.	L’ID della valutazione.
`{ type: 'skillee-plan:confirmed', … }`	Subito dopo `testId`.	Il piano confermato (offerta, impostazioni, domande) e la risposta del salvataggio in `result`.
`{ type: 'skillee-plan:error', error }`	La generazione o il salvataggio non è riuscito.	Un messaggio leggibile, già mostrato al recruiter nell’iframe.
`{ type: 'skillee-plan:close' }`	Il recruiter ha chiuso la schermata senza confermare.	—

Più valutazioni per offerta

Un’offerta può avere più valutazioni, ad esempio una preselezione seguita dalla fissazione di un colloquio. A ogni apertura, l’iframe mostra quelle già esistenti: il recruiter ne modifica una o ne aggiunge una nuova. Ogni valutazione mantiene il proprio testId.