Iframe de configuración

El iframe es la pantalla en la que el reclutador ajusta la evaluación de una oferta: el agente (precalificación, información adicional o programación de entrevistas), el canal de contacto, las preguntas y su importancia. Skillee propone un primer plan a partir del texto de la oferta; el reclutador lo ajusta y, después, lo valida.

Mostrar el iframe

La dirección procede de la llamada POST /partners/beetween/assessment-builder-sessions (consulte el inicio rápido). Cárguela tal cual, sin modificarla ni almacenarla en caché: contiene la empresa y la oferta.

<iframe
  src="https://…"
  title="Configuración de la evaluación de Skillee"
  style="width: 100%; height: 760px; border: 0"
></iframe>

La interfaz del iframe sigue el idioma del navegador del reclutador. Para imponerlo, añada lang a la dirección: &lang=en, &lang=de… (fr, en, de, es, it, pt). Este ajuste solo afecta a la pantalla: el idioma en el que el agente habla al candidato se elige en el iframe.

Obtener el identificador de la evaluación

Cuando el reclutador valida, el iframe guarda la evaluación y, a continuación, envía dos mensajes a su página con postMessage. El primero solo contiene el identificador que debe conservar:

// iframeUrl: la dirección recibida al abrir la sesión.
const SKILLEE_ORIGIN = new URL(iframeUrl).origin;

window.addEventListener('message', (event) => {
  if (event.origin !== SKILLEE_ORIGIN) return;
  if (event.data?.testId) {
    // Guardar junto con la oferta: es el `assessmentId` de las asignaciones.
    saveAssessmentId(event.data.testId);
  }
});

Todos los mensajes

Mensaje	Cuándo	Contenido
`{ testId }`	La evaluación se ha guardado.	El identificador de la evaluación.
`{ type: 'skillee-plan:confirmed', … }`	Justo después de `testId`.	El plan validado (oferta, ajustes, preguntas) y la respuesta del guardado en `result`.
`{ type: 'skillee-plan:error', error }`	La generación o el guardado ha fallado.	Un mensaje legible, ya mostrado al reclutador en el iframe.
`{ type: 'skillee-plan:close' }`	El reclutador ha cerrado la pantalla sin validar.	—

Varias evaluaciones por oferta

Una oferta puede tener varias evaluaciones, por ejemplo una precalificación y, después, una programación de entrevistas. En cada apertura, el iframe muestra las que ya existen: el reclutador modifica una o añade una nueva. Cada evaluación conserva su propio testId.