Konfigurations-Iframe

Das Iframe ist der Bildschirm, auf dem der Recruiter die Bewertung eines Stellenangebots einstellt: den Agenten (Vorqualifizierung, Zusatzinformationen oder Terminvereinbarung), den Kontaktkanal, die Fragen und ihre Wichtigkeit. Skillee schlägt auf Grundlage des Stellentexts einen ersten Plan vor; der Recruiter passt ihn an und bestätigt.

Das Iframe anzeigen

Die Adresse stammt aus dem Aufruf POST /partners/beetween/assessment-builder-sessions (siehe Schnellstart). Laden Sie sie so, wie sie ist, ohne sie zu verändern oder zwischenzuspeichern: Sie enthält das Unternehmen und das Stellenangebot.

<iframe
  src="https://…"
  title="Konfiguration der Skillee-Bewertung"
  style="width: 100%; height: 760px; border: 0"
></iframe>

Die Oberfläche des Iframes folgt der Browsersprache des Recruiters. Um sie festzulegen, hängen Sie lang an die Adresse an: &lang=en, &lang=de… (fr, en, de, es, it, pt). Diese Einstellung betrifft nur die Oberfläche: Die Sprache, in der der Agent mit dem Bewerber spricht, wird im Iframe gewählt.

Die ID der Bewertung abrufen

Wenn der Recruiter bestätigt, speichert das Iframe die Bewertung und sendet dann zwei Nachrichten per postMessage an Ihre Seite. Die erste enthält nur die ID, die Sie aufbewahren müssen:

// iframeUrl: die beim Öffnen der Sitzung erhaltene Adresse.
const SKILLEE_ORIGIN = new URL(iframeUrl).origin;

window.addEventListener('message', (event) => {
  if (event.origin !== SKILLEE_ORIGIN) return;
  if (event.data?.testId) {
    // Mit dem Stellenangebot speichern: Das ist die `assessmentId` der Zuweisungen.
    saveAssessmentId(event.data.testId);
  }
});

Alle Nachrichten

Nachricht	Wann	Inhalt
`{ testId }`	Die Bewertung ist gespeichert.	Die ID der Bewertung.
`{ type: 'skillee-plan:confirmed', … }`	Direkt nach `testId`.	Der bestätigte Plan (Stellenangebot, Einstellungen, Fragen) und die Antwort des Speichervorgangs in `result`.
`{ type: 'skillee-plan:error', error }`	Die Generierung oder das Speichern ist fehlgeschlagen.	Eine lesbare Meldung, die dem Recruiter bereits im Iframe angezeigt wird.
`{ type: 'skillee-plan:close' }`	Der Recruiter hat den Bildschirm ohne Bestätigung geschlossen.	—

Mehrere Bewertungen pro Stellenangebot

Ein Stellenangebot kann mehrere Bewertungen haben, zum Beispiel eine Vorqualifizierung und danach eine Terminvereinbarung. Bei jedem Öffnen zeigt das Iframe die bereits vorhandenen an: Der Recruiter ändert eine davon oder fügt eine neue hinzu. Jede Bewertung behält ihre eigene testId.