Iframe de configuração

O iframe é o ecrã onde o recrutador define a avaliação de uma oferta: o agente (pré-qualificação, informações complementares ou marcação de entrevistas), o canal de contacto, as perguntas e a respetiva importância. A Skillee propõe um primeiro plano a partir do texto da oferta; o recrutador ajusta-o e valida.

Apresentar o iframe

O endereço vem da chamada POST /partners/beetween/assessment-builder-sessions (ver o início rápido). Carregue-o tal como está, sem o modificar nem o guardar em cache: inclui a empresa e a oferta.

<iframe
  src="https://…"
  title="Configuração da avaliação Skillee"
  style="width: 100%; height: 760px; border: 0"
></iframe>

A interface do iframe segue o idioma do navegador do recrutador. Para o impor, acrescente lang ao endereço: &lang=en, &lang=de… (fr, en, de, es, it, pt). Esta definição diz respeito apenas ao ecrã: o idioma em que o agente fala com o candidato escolhe-se no iframe.

Obter o identificador da avaliação

Quando o recrutador valida, o iframe guarda a avaliação e envia depois duas mensagens à sua página com postMessage. A primeira contém apenas o identificador a conservar:

// iframeUrl: o endereço recebido ao abrir a sessão.
const SKILLEE_ORIGIN = new URL(iframeUrl).origin;

window.addEventListener('message', (event) => {
  if (event.origin !== SKILLEE_ORIGIN) return;
  if (event.data?.testId) {
    // A guardar com a oferta: é o `assessmentId` das atribuições.
    saveAssessmentId(event.data.testId);
  }
});

Todas as mensagens

Mensagem	Quando	Conteúdo
`{ testId }`	A avaliação foi guardada.	O identificador da avaliação.
`{ type: 'skillee-plan:confirmed', … }`	Logo a seguir a `testId`.	O plano validado (oferta, definições, perguntas) e a resposta do registo em `result`.
`{ type: 'skillee-plan:error', error }`	A geração ou o registo falhou.	Uma mensagem legível, já apresentada ao recrutador no iframe.
`{ type: 'skillee-plan:close' }`	O recrutador fechou o ecrã sem validar.	—

Várias avaliações por oferta

Uma oferta pode ter várias avaliações, por exemplo uma pré-qualificação seguida de uma marcação de entrevista. Em cada abertura, o iframe apresenta as que já existem: o recrutador modifica uma delas ou acrescenta uma nova. Cada avaliação mantém o seu próprio testId.