Hoe werkt de ATS-koppeling van Selection Lab met Emply, Jobylon en Salesforce?

De koppeling draait op drie gebeurtenissen. Het ATS stuurt een uitnodigingstrigger zodra een kandidaat de assessmentfase bereikt, Selection Lab stuurt na afronding een callback terug met status, matchscore en rapport-URL, en een mappinglaag vertaalt die uitkomst naar de juiste ATS-status, inclusief afwijzing. Wie weet in welke laag een probleem zit, lost het het snelst op.

Een assessmentplatform dat niet strak met je ATS koppelt, levert handwerk op precies het verkeerde moment. Een recruiter met 50 of meer lopende sollicitaties wil dat statusupdates, scores en afwijzingen automatisch doorlopen. Dit referentiedocument beschrijft op systeemniveau hoe de koppeling van Selection Lab met Emply, Jobylon en Salesforce werkt. Wat de uitnodiging triggert, wat er terugkomt als een kandidaat het assessment heeft afgerond en hoe een afwijzing terugkomt als status in het ATS. Werk je met Recruitee of SmartRecruiters, lees dan statusmapping van assessmentresultaten in Recruitee en SmartRecruiters.

Elke koppeling bestaat uit drie losse gebeurtenissen.

1. Uitnodigingstrigger (inkomend bij Selection Lab). Het ATS registreert een fasewissel of webhook-event en geeft Selection Lab opdracht om de kandidaat een assessmentuitnodiging te sturen.
2. Callback na afronding (uitgaand vanuit Selection Lab). Zodra een kandidaat klaar is, weigert of de termijn laat verlopen, zet Selection Lab de resultaten terug op het ATS-record.
3. Uitkomst- en afwijsmapping (beslislaag). Het ATS past een ingestelde regel toe die de resultaatstatus van Selection Lab vertaalt naar de juiste kandidaatstatus, inclusief het afwijsbericht.

Weten in welke laag een probleem thuishoort, is de snelste manier om configuratiefouten te isoleren.

Begrippen in dit document

Emply, welke velden en welke trigger sturen de uitnodiging

Velden die Emply meestuurt bij een uitnodiging

Zodra een kandidaat in Emply naar een fase gaat die een Selection Lab-assessment triggert, stuurt Emply een gestructureerde payload naar het webhook-endpoint van Selection Lab. Hieronder staan de velden die in een goed ingerichte Emply-koppeling aanwezig horen te zijn. Velden met de markering [nog te bevestigen] moet je controleren in je eigen Emply-omgeving, omdat de publieke helpdocumentatie van Emply het volledige payload-schema niet publiceert.

Wat er gebeurt als optionele velden ontbreken. Ontbreekt locale, dan valt Selection Lab terug op de taal die in het assessmentprofiel is ingesteld. Ontbreekt phone terwijl het kanaal op WhatsApp staat, dan mislukt de uitnodiging zonder melding, tenzij e-mail als terugvalkanaal is ingesteld. Controleer dat terugvalgedrag in je Selection Lab-accountinstellingen.

Configuratiestappen voor de Emply-trigger

De trigger loopt via een webhook of een connector-synchronisatie. Het exacte mechanisme is nog te bevestigen, check of jouw Emply-omgeving met webhook push of met een pollende connector werkt. De configuratie gaat zo.

1. Ga in de Emply-admin naar de integratie- of connectorinstellingen voor je assessmentleverancier.
2. Kies de fase die een uitnodiging moet triggeren (bijvoorbeeld "Assessment").
3. Koppel die fase aan het webhook-endpoint van Selection Lab en vul de API-credentials in (Bearer token of OAuth client credentials, afhankelijk van je Selection Lab-tenant).
4. Kies het assessmentprofiel voor kandidaten die deze fase bereiken. Is de mapping van vacature naar profiel dynamisch, controleer dan of Emply de requisition_id meestuurt zodat Selection Lab het juiste profiel zelf kan bepalen.
5. Leg de toestemmingsflow vast. Vraagt Emply al vóór de assessmentfase toestemming om data met derden te delen, stuur die vlag dan mee in de payload. Zo niet, dan vraagt Selection Lab zelf toestemming voordat resultaten teruggaan.

Wat er gebeurt bij een authenticatiefout. Is de API-credential verlopen of verkeerd ingesteld, dan krijgt Emply een HTTP 4xx terug. Afhankelijk van de connectorconfiguratie verdwijnt de uitnodiging dan stil of komt hij in een retry-wachtrij. Controleer de integratielogs in Emply en in het adminpaneel van Selection Lab om aflevering te bevestigen.

Het retry-gedrag bij mislukte aflevering (aantal pogingen, wachttijd, dead-letter) is nog te bevestigen met je integratie-engineer bij Selection Lab.

Emply, wat er terugkomt na afronding van het assessment

Zodra een kandidaat het assessment afrondt of verlaat, stuurt Selection Lab een callback naar Emply. Die payload bevat de volgende onderdelen.

Waarden van de afrondingsstatus

Score- en rapportvelden

Toestemming en privacy

Het privacymodel van Selection Lab laat de resultaten eerst aan de kandidaat zien. Daarna wordt opnieuw om toestemming gevraagd voordat de resultaten teruggaan naar het ATS. Heeft een kandidaat het assessment afgerond maar die tweede toestemming nog niet gegeven, dan kunnen report_url en component_scores in de callback worden achtergehouden of als null terugkomen totdat de toestemming is vastgelegd. Persoonsgegevens staan opgeslagen in Frankfurt, in lijn met de Europese eisen aan dataresidentie.

Hoe Emply die toestemmingsdrempel precies afhandelt (de hele callback blokkeren of een gedeeltelijke payload sturen met een consent_pending-vlag) is nog te bevestigen bij je accountmanager van Selection Lab.

Emply, statusmapping en afwijzing

Mappingtabel voor de uitkomst

De exacte fase- en statusnamen in Emply zijn picklist-waarden uit jouw configuratie. De mapping in de integratie-instellingen van Selection Lab moet die tekst letterlijk overnemen. Een afwijking ("Afgewezen" tegenover "afgewezen" of "AFGEWEZEN") laat de callback stil mislukken of een 422 teruggeven.

Kanalen voor het afwijsbericht

Bij een afwijzing kan Selection Lab de kandidaat op twee manieren informeren.

• E-mail, een automatisch bericht op basis van de ingestelde afwijstemplate
• WhatsApp, een afwijsbericht via de SmartChat-flow van Selection Lab, als de kandidaat via WhatsApp is binnengekomen en er een telefoonnummer is

De timing (direct of vertraagd) en de exacte templatevariabelen zijn nog te bevestigen in je Selection Lab-accountconfiguratie.

Voorbeeldpayloads

Uitnodigingspayload (Emply naar Selection Lab)

{
  "event": "assessment.invite",
  "application_id": "APP-00123",
  "candidate_id": "CAND-78901",
  "requisition_id": "REQ-456",
  "first_name": "Jane",
  "last_name": "Smith",
  "email": "[email protected]",
  "phone": "+31612345678",
  "locale": "nl",
  "consent_flag": true
}

Callback na afronding (Selection Lab naar Emply)

{
  "event": "assessment.completed",
  "application_id": "APP-00123",
  "candidate_id": "CAND-78901",
  "completion_status": "completed",
  "match_score": 74,
  "component_scores": {
    "cognitive": 68,
    "personality": 81,
    "hard_skills": 72
  },
  "report_url": "https://app.selectionlab.com/reports/APP-00123",
  "report_available": true,
  "completed_at": "2026-08-30T09:14:22Z"
}

Veldnamen en de sleutels in component_scores hangen af van je actieve assessmentprofiel. Bovenstaande is illustratief, controleer het exacte schema in de integratiespecificatie van Selection Lab.

Veelvoorkomende Emply-problemen

• Statuswaarde komt niet overeen. Geeft Selection Lab een status terug die niet letterlijk in de Emply-picklist staat, dan mislukt de update. Exporteer je Emply-faselijst en controleer elke waarde tegen de mappingtabel in de Selection Lab-admin.
• application_id ontbreekt. Zonder correlatiesleutel weet Selection Lab niet welk Emply-record bijgewerkt moet worden. Controleer in de connectorconfiguratie of Emply dit veld bij elke uitnodiging meestuurt.
• Resultaten geblokkeerd door toestemming. Heeft een kandidaat het assessment afgerond maar zie je niets in Emply, check dan of de tweede toestemming nog openstaat. Het adminpaneel van Selection Lab toont de toestemmingsstatus per kandidaat.
• Verlopen credentials. Roteer de API-credentials en werk ze tegelijk bij in de Emply-connector en in de integratie-instellingen van Selection Lab.

Jobylon, Pipeline Actions als trigger

Jobylon documenteert assessmentkoppelingen via Pipeline Actions. Volgens de supportdocumentatie van Jobylon (27 januari 2026) richt je partnerintegraties in op fase-niveau. Ga naar Pipeline Actions, maak een actie aan naast de status die je wilt automatiseren, kies "Partner Integrations" als actietype, selecteer je assessmentleverancier en sla op. Daarna gaat automatisch een assessment uit zodra een kandidaat naar die status verhuist.

De Jobylon-koppeling is dus gebeurtenisgedreven door een statuswissel, niet door een handmatige actie van de recruiter. Buiten de Pipeline Actions is aan recruiterkant geen aparte webhookconfiguratie nodig. De uitnodiging gaat uit op het moment dat het ATS de fasewissel registreert.

Selection Lab past direct in dat model. Bereikt een kandidaat de ingestelde fase, dan ontvangt Selection Lab het uitnodigingsevent en verstuurt de assessmentuitnodiging. Recruiters zien het volledige rapport en de losse scores in het kandidaatrecord in Jobylon zodra de resultaten terug zijn.

Wat de publieke documentatie van Jobylon niet beschrijft

Het supportartikel van Jobylon over partnerintegraties publiceert het volgende niet.

• Het exacte payload-schema van de uitnodiging (welke kandidaatvelden naar de partner gaan)
• De exacte veldnamen van resultaat en status die de partner terugstuurt
• De kanaallogica voor afwijsberichten (e-mail, WhatsApp of alleen in het ATS)
• Hoe je op scoredrempels automatisch van fase wisselt op het retourpad

Vraag de integratiespecificatie voor Selection Lab en Jobylon op bij je accountmanager van Selection Lab, of kijk in de Jobylon-admin onder Settings en Integrations voor detail op veldniveau.

Voor het retourpad (resultaten terug in Jobylon) geldt hetzelfde callbackpatroon als bij Emply. Afrondingsstatus, matchscore, onderdeelscores en rapport-URL komen op het kandidaatrecord. De pipeline van Jobylon kan daarna kandidaten automatisch verplaatsen op basis van scoredrempels, met de eigen score-gebaseerde automatisering.

Salesforce, objectmapping en picklist-beperkingen

Het datamodel van Salesforce voor recruitment (native Salesforce Recruiting of een managed package zoals Salesforce for Recruiting) werkt met strikt getypeerde picklist-velden op objecten als Application, Assessment of eigen tussenobjecten. Dat legt strengere eisen op aan de resultaatmapping dan Emply of Jobylon.

Hoe de resultaten op Salesforce-objecten landen

De Salesforce-koppeling van Selection Lab zet de resultaten op een aangewezen object, meestal een custom Assessment__c of vergelijkbaar object, of een bestaand Application- of Candidate Stage-object, afhankelijk van je org-configuratie. De velden zijn inhoudelijk hetzelfde als in de Emply-callback. Afrondingsstatus, scores, rapport-URL en tijdstempel. De exacte API-veldnamen en doelobjecten hangen af van het schema van jouw Salesforce-org.

De belangrijkste beperking. Elke statuswaarde die je vanuit een Selection Lab-status mapt, moet een actieve picklist-waarde zijn in je org. Staat completed_with_low_score niet als geldige waarde in je veld Application_Status__c, dan mislukt de update met een validatiefout van Salesforce.

Afwijsmapping als vertaallaag

In Salesforce is afwijsmapping een vertaling in twee stappen.

1. Selection Lab levert een canonieke afrondingsstatus (bijv. completed, declined, expired) plus een geslaagd-of-gezakt-oordeel op basis van de scoredrempel.
2. De integratielaag (een Salesforce Flow, een Apex-trigger of de Selection Lab-connector) vertaalt die canonieke status naar de picklist-waarde die je voor afwijzing hebt ingesteld (bijv. "Rejected - Assessment", "No Longer in Consideration").

Werk je met Salesforce Experience Cloud en doen kandidaten het assessment via een portaal, dan moeten de rechten van externe gebruikers op de betreffende objecten het lezen van status en rapport-URL toestaan. Dit is een veelvoorkomende oorzaak van tickets met "resultaten niet zichtbaar" bij Salesforce-implementaties.

Voor afwijsmapping met automatisch getriggerde uitnodigingen in Salesforce geldt hetzelfde patroon als bij Emply. Een ingestelde drempel zet de afwijsstatus, en het berichtkanaal (e-mail, WhatsApp) volgt uit de contactgegevens van de kandidaat en de templateconfiguratie in Selection Lab.

Beslismatrix voor alle drie de ATS'en

Welk ATS je ook gebruikt, normaliseer eerst de canonieke statussen van Selection Lab voordat je naar ATS-specifieke waarden schrijft. De matrix hieronder geldt voor Emply, Jobylon en Salesforce.

Het principe achter deze matrix is eerst normaliseren, dan mappen. Zet ATS-specifieke picklist-waarden nooit hard in de callbacklogica. Houd in je integratieconfiguratie een mappingtabel bij die de canonieke statussen van Selection Lab vertaalt naar jouw ATS-teksten. Hernoemt Emply een fase, dan pas je de tabel één keer aan in plaats van de integratie zelf.

Checklist en troubleshooting

Checklist vóór livegang

• Correlatiesleutels bevestigd, application_id en candidate_id zitten in elke uitnodigingspayload
• Assessmentprofiel gekozen en gekoppeld aan het juiste vacature- of functietype
• Webhook-endpoint geregistreerd en credentials actief (test met een ping of healthcheck)
• Toestemmingsflow bevestigd, is de toestemming die Emply vooraf verzamelt voldoende of geldt de tweede toestemming van Selection Lab na het assessment
• Picklist-waarden van het ATS geëxporteerd en gecontroleerd tegen de mappingtabel van Selection Lab
• Afwijstemplates beoordeeld en goedgekeurd (kanaal, timing, variabelen)
• Terugvalkanaal ingesteld voor kandidaten zonder telefoonnummer (WhatsApp vereist een E.164-nummer)

Troubleshooting uitnodigingen

Troubleshooting resultaten

Monitoring in de operatie

Log op drie punten. (1) De dispatchlog van de ATS-connector of webhook om te zien dat de uitnodigingsevents zijn afgevuurd, (2) de eventlog in de Selection Lab-admin om te zien dat uitnodigingen zijn ontvangen en afgeleverd, en (3) de updatelog van het ATS om te zien dat de callbacks zijn toegepast. Bij Salesforce geven Apex-debuglogs of Platform Event-logs het meeste detail.

Reconciliatie. Draai wekelijks een rapport dat kandidaten in de fase "Assessment" vergelijkt met kandidaten die een afgerond Selection Lab-resultaat hebben. Elk verschil wijst op een mislukte aflevering of een resultaat dat door toestemming wordt geblokkeerd. De meeste ATS'en kunnen dit met een simpel pipelinefilter, het rapportagepaneel van Selection Lab levert een bijpassende export.

Blijven afleveringen mislukken, vraag dan bij Selection Lab een export van de audittrail op met tijdstempels, HTTP-responscodes en retry-pogingen. Dat is de snelste manier om te zien of de fout aan de kant van de ATS-connector zit of in de afleverpipeline van Selection Lab. Wil je de koppeling met jouw ATS zien werken? Vraag een demo aan.

Veelgestelde vragen