Iframe de configuration

L’iframe est l’écran où le recruteur règle l’évaluation d’une offre : l’agent (préqualification, informations complémentaires ou prise de rendez-vous), le canal de contact, les questions et leur importance. Skillee propose un premier plan à partir du texte de l’offre ; le recruteur l’ajuste puis valide.

Afficher l’iframe

L’adresse vient de l’appel POST /partners/beetween/assessment-builder-sessions (voir le démarrage rapide). Chargez-la telle quelle, sans la modifier ni la mettre en cache : elle porte l’entreprise et l’offre.

<iframe
  src="https://…"
  title="Configuration de l'évaluation Skillee"
  style="width: 100%; height: 760px; border: 0"
></iframe>

L’interface de l’iframe suit la langue du navigateur du recruteur. Pour l’imposer, ajoutez lang à l’adresse : &lang=en, &lang=de… (fr, en, de, es, it, pt). Ce réglage ne concerne que l’écran : la langue dans laquelle l’agent parle au candidat se choisit dans l’iframe.

Récupérer l’identifiant de l’évaluation

Quand le recruteur valide, l’iframe enregistre l’évaluation puis envoie deux messages à votre page avec postMessage. Le premier ne contient que l’identifiant à conserver :

// iframeUrl : l'adresse reçue à l'ouverture de la session.
const SKILLEE_ORIGIN = new URL(iframeUrl).origin;

window.addEventListener('message', (event) => {
  if (event.origin !== SKILLEE_ORIGIN) return;
  if (event.data?.testId) {
    // À enregistrer avec l'offre : c'est l'`assessmentId` des assignations.
    saveAssessmentId(event.data.testId);
  }
});

Astuce

Vérifiez toujours event.origin : votre page ne doit accepter que les messages de l’iframe qu’elle a chargée. Prenez l’origine de l’iframeUrl reçue plutôt qu’une valeur écrite en dur.

Tous les messages

Message	Quand	Contenu
{ testId }	L’évaluation est enregistrée.	L’identifiant de l’évaluation.
{ type: 'skillee-plan:confirmed', … }	Juste après testId.	Le plan validé (offre, réglages, questions) et la réponse de l’enregistrement dans result.
{ type: 'skillee-plan:error', error }	La génération ou l’enregistrement a échoué.	Un message lisible, déjà affiché au recruteur dans l’iframe.
{ type: 'skillee-plan:close' }	Le recruteur a fermé l’écran sans valider.	—

Plusieurs évaluations par offre

Une offre peut porter plusieurs évaluations, par exemple une préqualification puis une prise de rendez-vous. À chaque ouverture, l’iframe affiche celles qui existent déjà : le recruteur en modifie une ou en ajoute une nouvelle. Chaque évaluation garde son propre testId.