In het kort
- Drie manieren: een native ATS-koppeling, de openbare API met webhooks, of het interview ingesloten op je vacaturesite. Je kunt er meer dan één gebruiken.
- ATS: koppel een vacature en fase in Workable, Greenhouse, Teamtailor, Recruitee of Breezy HR aan een gepubliceerd interview. Elke kandidaat die naar die fase wordt verplaatst, wordt één keer uitgenodigd, en de resultaten gaan terug als notitie.
- API: maak kandidaten en uitnodigingen aan vanuit je eigen systemen met een API-sleutel met beperkte scopes, en hoor via ondertekende webhooks wat er is gebeurd.
- Embed: draai het interview binnen je eigen site met één script, vanaf de sites die je toestaat.
- Eerst testen: stuur een testgebeurtenis naar je webhook, zet een testkandidaat door de fase en lees de leverings- en activiteitenlogboeken voordat je live gaat.
Drie manieren om AI-interviews te koppelen
Een ATS-integratie voor AI-interviews bespaart je recruiters het kopiëren en plakken: kandidaten worden uitgenodigd vanuit het systeem dat je al gebruikt, en de resultaten komen daar terug. Heeft je ATS geen native koppeling, of werf je via je eigen portal, dan doen de openbare API en de embed hetzelfde met wat code.
- Native ATS-koppeling. Workable, Greenhouse, Teamtailor, Recruitee en Breezy HR. Geen code: plak een sleutel, koppel een vacature en een fase, en wie een kandidaat naar die fase verplaatst, verstuurt de uitnodiging.
- Openbare API en webhooks. Je systeem maakt kandidaten en uitnodigingen aan via REST en haalt resultaten op; webhooks laten weten wanneer er iets gebeurt.
- Embed-SDK. Eén script draait het interview in een frame op je vacaturesite. Het heeft een uitnodigingslink nodig, dus het gaat samen met de API.
Alle drie vereisen een betaald pakket en een bedrijfsbeheerder. Het interview is hetzelfde als wat kandidaten via een link in een e-mail krijgen, inclusief de mogelijkheid om te typen in plaats van te spreken.
Kiezen tussen het ATS, de API en de embed
| Native ATS-koppeling | Openbare API en webhooks | Embed-SDK (met de API) | |
|---|---|---|---|
| Het meest geschikt voor | Teams die een van de vijf ondersteunde ATS'en gebruiken | Elk ander ATS of je eigen workflow | Een vacaturesite of portal die je zelf beheert |
| Benodigde code | Geen | API-aanroepen en een webhook-ontvanger | Een paar regels op de pagina, plus de API |
| Wat de uitnodiging verstuurt | Een kandidaat naar de gekoppelde fase verplaatsen | Je API-aanroep | Je API-aanroep; de link wordt op je pagina geladen |
| Resultaten komen terug als | Een notitie bij de kandidaat in het ATS | Resultaten die je ophaalt na de resultatenwebhook | Hetzelfde; de pagina hoort alleen dat de kandidaat klaar is |
Begin met de native koppeling als je ATS er een heeft. Kies de API als je zelf wilt bepalen wie wanneer wordt uitgenodigd. Voeg de embed toe als kandidaten op je site moeten blijven.
Een ATS-integratie voor AI-interviews instellen
Een ATS koppelen en een vacature verbinden
- Publiceer het interview. Alleen een gepubliceerd interview kan aan een vacature worden gekoppeld.
- Open Integraties → ATS en klik op ATS koppelen. Plak de inloggegevens van het ATS (waar je ze vindt). testee probeert ze eerst bij het ATS uit, slaat ze daarna versleuteld op en toont alleen een gemaskeerde hint.
- Stel de webhook in. Workable en Breezy HR hebben niets nodig: testee registreert hem zelf. Voeg voor Greenhouse, Teamtailor en Recruitee een webhook toe in het ATS met het adres op de Webhook-kaart van de koppeling, en wissel het geheim uit zoals de kaart aangeeft.
- Koppel een vacature. Het tabblad Vacatures toont de openstaande vacatures van het ATS. Open er een, kies het gepubliceerde interview en de fase die de uitnodiging verstuurt, en sla op.
- Markeer vacatures in New York City op de koppeling, zodat uitnodigingen je kennisgeving volgens Local Law 144 bevatten en 10 werkdagen later opengaan.


Wat er per kandidaat gebeurt
- Eén keer uitgenodigd, hoe vaak het ATS het event ook stuurt. Events voor vacatures of fases die je niet hebt gekoppeld, worden genegeerd.
- Vaste velden: het e-mailadres en de naam van de kandidaat, de vacature en fase, en de referentie van het ATS. Er valt geen veldkoppeling in te stellen.
- Resultaten als notitie: de dekkingsscore (ter beoordeling, geen wervingsbeslissing), de samenvatting en een link naar de resultaten. Je kunt het terugschrijven per koppeling uitzetten.
- Storingen: bij een storing wordt het ongeveer acht uur opnieuw geprobeerd; een weigering, bijvoorbeeld omdat er geen interviewminuten meer over zijn, verschijnt in het logboek.
- Extra tijd voor een kandidaat die erom heeft gevraagd, stel je in op de pagina van de uitnodiging in het dashboard, tot de kandidaat begint.
Pauzeren houdt uitnodigingen en notities vast tot je hervat. Weigert het ATS de sleutel later, dan toont de koppeling Opnieuw koppelen nodig en wachten de notities.
De API en webhooks voor AI-interviews gebruiken
De openbare REST API doet wat een recruiter in het dashboard doet: gepubliceerde interviews opvragen, kandidaten aanmaken, ze uitnodigen en resultaten ophalen. De naslag staat in de API-documentatie voor AI-interviews.
API-sleutels
- Maak een sleutel aan onder Integraties → API-sleutels. Het geheim (aik_live_…) wordt één keer getoond en als bearer-token meegestuurd, nooit in een URL.
- Scopes: geef elke sleutel alleen de rechten die het systeem gebruikt, zoals invitations:write en results:read.
- IP-allowlist: tot 50 adressen of bereiken, zoals de uitgaande adressen van je servers.
- Vervaldatum: 30 dagen, 90 dagen (de standaard), 1 jaar, een datum tot 2 jaar vooruit, of nooit. De lijst waarschuwt 7 dagen van tevoren.
- Rate limit: 120 verzoeken per minuut per sleutel.


Een kandidaat uitnodigen vanuit je eigen systeem
- GET /v1/interviews geeft je gepubliceerde interviews.
- POST /v1/candidates met de naam en het e-mailadres. Een tweede kandidaat met hetzelfde e-mailadres wordt geweigerd, dus bewaar de id.
- POST /v1/invitations met beide id's. Het antwoord bevat de link, die één keer wordt getoond; testee mailt hem ook naar de kandidaat.
- Stuur een Idempotency-Key-header mee bij elke POST. Een nieuwe poging met dezelfde sleutel na een time-out maakt niets dubbel aan (sleutels blijven 24 uur geldig).
| Optioneel veld van de uitnodiging | Wat het doet |
|---|---|
| externalId | Je eigen id (bijvoorbeeld van de sollicitatie). Die komt terug op de uitnodiging en in elke webhook |
| returnUrl | Na afloop ziet de kandidaat een knop terug naar dit https-adres (niet binnen de embed) |
| extraTime | 25, 50 of 100 procent meer tijd voor een kandidaat die erom heeft gevraagd; een interview duurt maximaal 60 minuten, inclusief extra tijd. Wordt nooit door de API teruggegeven of in webhooks meegestuurd |
| nycNotice | De kandidaat woont in New York City: de e-mail bevat je kennisgeving, en het interview gaat 10 werkdagen later open |
| skipSignIn | Je site heeft de kandidaat al ingelogd: de link alleen opent het interview (zie de embed) |
Webhooks
Voeg een endpoint toe onder Integraties → Webhooks: een openbare https-URL en de bijbehorende events, namelijk invitation.created, invitation.opened, invitation.resent, invitation.revoked, invitation.expired, session.started, session.completed, results.failed, review.decision_changed, candidate.erased en results.ready. Payloads bevatten alleen id's en je externalId, nooit namen of scores; haal bij results.ready de resultaten op met GET /v1/sessions/{id}/results.
- Controleer elke handtekening: een HMAC-SHA256 van de tijdstempel en de ruwe body, met het geheim van het endpoint als sleutel. Vergelijk in constante tijd en weiger tijdstempels die ouder zijn dan 5 minuten (code in de webhookdocumentatie).
- Antwoord binnen 10 seconden met 2xx. Mislukte leveringen worden ongeveer 24 uur lang opnieuw geprobeerd, met backoff.
- Reken op herhalingen en een willekeurige volgorde: sla een event-id over die je al hebt verwerkt, en lees de actuele status uit de API.
Het interview insluiten op je vacaturesite
Met een ingesloten interview op je vacaturesite blijven kandidaten op je site: één script zet het interview in een frame en meldt wat de kandidaat doet (documentatie van de embed-SDK).
Het interview insluiten
- Sta je site toe onder Integraties → Insluiten: een https-origin zonder pad, tot 20. Nergens anders laadt het interview in een frame.
- Maak de uitnodiging aan op je server en geef de link door aan de pagina. De API-sleutel komt nooit in de pagina.
- Laad het in met TesteeEmbed.mount: een container, de link en een onEvent-functie. Het tabblad Insluiten in het dashboard toont het fragment.
- Verwerk de events: ready, login_required, started, completed, feedback_submitted en error, elk met alleen id's.
De inlogcode overslaan
Standaard logt de kandidaat in binnen het frame met een 6-cijferige code die per e-mail wordt gestuurd; je pagina ziet die nooit. Heeft je site de kandidaat al ingelogd, maak de uitnodiging dan via de API aan met skipSignIn, en de link alleen opent het interview. Het dashboard kan dit niet instellen.
- De keerzijde: de link wordt de enige sleutel, dus iedereen die hem heeft, kan het interview afleggen. Houd de geldigheid op een dag of twee, maak de uitnodiging pas aan vlak voordat de kandidaat begint, en toon hem alleen achter je eigen login.
- Vastgelegd: de uitnodiging toont „Inloggen overgeslagen”, en de resultaten vermelden dat de identiteit is geverifieerd door de site van je bedrijf.
Test voordat je live gaat
Een testrun
- Gebruik een testkandidaat met een e-mailadres dat je kunt lezen; voorbeelden die teamleden bekijken, versturen geen webhooks.
- Verstuur een testgebeurtenis naar de webhook vanuit het menu van het endpoint: een ondertekende test.ping, dus je handtekeningcode wordt ook gecontroleerd.
- Lees het leveringslogboek op de pagina van het endpoint. Opnieuw versturen stuurt een levering nogmaals met dezelfde id, zodat je test of je herhalingen overslaat.
- Verplaats de kandidaat naar de gekoppelde fase en bekijk het tabblad Activiteit van de ATS-koppeling: elk event, elke uitnodiging en elke notitie is klaar, wordt opnieuw geprobeerd, is mislukt of is genegeerd.
- Leg het interview af en controleer of results.ready is binnengekomen, of dat de notitie in het ATS is verschenen. Oplossingen voor veelvoorkomende problemen staan in de documentatie over ATS-problemen oplossen.
Opmerkingen over beveiliging
- Sleutels blijven op de server, één per systeem, met alleen de scopes die het nodig heeft, een IP-allowlist en een vervaldatum. Trek een sleutel in als je vermoedt dat hij gelekt is.
- Eerst controleren, dan vertrouwen: weiger webhooks waarvan de handtekening of tijdstempel niet klopt, en lees de gegevens uit de API.
- Sta alleen je eigen sites toe voor de embed.
- Uitnodigingslinks zijn persoonlijk: log of deel ze nooit, zeker niet met skipSignIn.
Slack-meldingen
Koppel onder Integraties → Slack met Toevoegen aan Slack of een incoming webhook, kies welke meldingen er geplaatst worden, zoals resultaten beschikbaar, en stuur een testbericht (Slack-documentatie).
Samenvatting
- Gebruik je een van de vijf ondersteunde ATS'en, kies dan de native koppeling: koppel elke vacature en fase aan een gepubliceerd interview.
- Anders gebruik je de API met sleutels met beperkte scopes en een vervaldatum, en Idempotency-Key-headers, en controleer je elke webhook.
- Wil je kandidaten op je site houden, voeg dan de embed toe, en sla de inlogcode alleen over achter je eigen login.
- Voordat je live gaat, doorloop je één testkandidaat van begin tot eind.
Vragen en antwoorden
Werkt testee samen met Greenhouse of Workable?
Ja, met een native koppeling, en ook met Teamtailor, Recruitee en Breezy HR. Je koppelt een vacature en een fase aan een gepubliceerd interview; elke kandidaat die naar die fase wordt verplaatst, wordt één keer uitgenodigd, en de resultaten gaan terug als notitie.
Is er een API voor AI-interviews?
Ja. De REST API maakt kandidaten en uitnodigingen aan, meldt hun status en geeft resultaten, pdf-rapporten en CSV-exports terug. Ondertekende webhooks laten je systeem weten wanneer er iets gebeurt.
Mijn ATS wordt niet ondersteund. Kan ik het toch koppelen?
Ja, via de API: maak de uitnodiging aan als de kandidaat de juiste fase bereikt, zet je externalId erop, en haal de resultaten op zodra results.ready binnenkomt.
Kunnen kandidaten het interview op onze vacaturesite afleggen?
Ja, met de embed-SDK: sta je site toe onder Integraties → Insluiten, maak de uitnodiging aan met de API en laad die in op je pagina.
Zet het resultaat kandidaten door in het ATS?
Nee. testee verplaatst of wijst nooit een kandidaat af. De notitie bevat de dekkingsscore, gelabeld als ter beoordeling en niet als wervingsbesluit; een mens beslist.
Wat hoort er op een checklist voor een ATS-integratie?
Welke vacatures en fases uitnodigen, wie eigenaar is van de sleutels, hoe webhooks worden gecontroleerd, wat er teruggaat naar het ATS, hoe storingen worden opgemerkt, hoe kandidaten in New York City en verzoeken om aanpassingen worden afgehandeld, en een testrun.
Bronnen
- Documentatie voor ontwikkelaars van testee: ATS-integraties
- Documentatie voor ontwikkelaars van testee: REST API
- Documentatie voor ontwikkelaars van testee: webhooks
- Documentatie voor ontwikkelaars van testee: embed-SDK
- Documentatie voor ontwikkelaars van testee: Slack
- Specificatie Standard Webhooks
- RFC 2104, HMAC: Keyed-Hashing for Message Authentication