TalentApproved

3 API-kall for å levere ATS-vurderingsresultater til HR og teknisk team

3 API-kall for å levere ATS-vurderingsresultater til HR og teknisk team

Foretrekk en innebygd vurdering-API når ditt søkerhåndteringssystem tilbyr en. Når det ikke gjør det, fall tilbake på en system-of-record-integrasjon eller en samlet vurdering-API. Uansett, planlegg for tre kjernefunksjoner: liste tilgjengelige testpakker, utløse en vurdering for en kandidat, og synkronisere resultater tilbake via webhooks. Rikere funksjoner eller tilgang til integrasjonen i det hele tatt kan ligge bak et betalt nivå eller partnernivå.

TL;DR:

  • Innebygde vurdering-APIer gir den beste rekrutteringsopplevelsen ved å tillate filtrering og rangering av kandidater basert på strukturerte poengsum innenfor ATS-en.
  • Når ingen vurdering-API er tilgjengelig, legger reserveintegrasjoner til resultater som notater eller filer, noe som begrenser muligheten til å filtrere eller sortere kandidatresultater.
  • Den anbefalte integrasjonsrekkefølgen innebærer å liste pakker, utløse vurderinger og fange opp resultater via webhooks, med fokus på sikker identifikasjon og riktig håndtering av svarkoder.
  • Arbeidsgivere må validere og dokumentere vurderingsverktøy for rettferdighet og juridisk samsvar før bruk, og sørge for at resultater lagres med et revisjonsspor og at samtykke er registrert.
  • Å teste integrasjonen grundig i et testmiljø og spore webhook-suksess bidrar til å forhindre feil og foreldreløse resultater i den aktive ansettelsesprosessen.
Talent Approved
Vurder ferdigheter utover CV-en
Talent Approved hjelper arbeidsgivere med å lage skreddersydde ferdighetsvurderinger, gjennomgå strukturerte resultater og ta mer informerte ansettelsesavgjørelser.
Utforsk Talent Approved

Innholdsfortegnelse

Innebygde APIer, reserveintegrasjoner og samlede vurdering-APIer

Tre integrasjonsmønstre dekker nesten alle ansettelsessystemer, og hvert av dem endrer hva rekruttererne ser inne i ATS-en.

En innebygd vurdering-API er det reneste alternativet. Den eksponerer testpakker, bestillinger og strukturerte resultater direkte inne i ATS-posten, noe som betyr at rekrutterere kan filtrere og rangere kandidater etter poengsum på samme måte som de filtrerer etter trinn eller kilde. Ashbys utviklerdokumentasjon beskriver dette som standardformen: liste pakker, starte en vurdering, skrive resultater tilbake via en webhook.

Når ATS-en ikke har dedikerte vurderingssluttpunkter, faller team tilbake på lyttere for trinnendringer og legger til resultater som notater, lenker eller filopplastinger. Dette bevarer grunnleggende dekning, men fjerner strukturert poenggivning, slik at rekrutterere mister muligheten til å sortere eller filtrere etter resultat inne i ATS-en, ifølge Kombos integrasjonsguide.

En samlet vurdering-API befinner seg mellom de to. Den standardiserer pakker, bestillingswebhooks og resultat-tilbakeskriving på tvers av mange ATS-plattformer på én gang, slik at en leverandør integrerer én gang og når dusinvis av systemer i stedet for å bygge og vedlikeholde en separat kobling for hver, som beskrevet i oversikten over samlet vurdering-API.

  • Innebygd API: beste rekrutteringsopplevelse, knyttet til én ATS.
  • Reserveintegrasjon: bredest dekning, svakest strukturert poenggivning i ATS-en.
  • Samlet API: lavere langsiktig vedlikehold for leverandører som betjener flere ATS-er.

Bygge integrasjonen: en steg-for-steg sjekkliste

Før du skriver noen kode, bekreft at ATS-en faktisk eksponerer en vurdering-API og hent ut utviklerdokumentasjonen. Mange plattformer publiserer bare generelle kandidat- eller søknadsendepunkter, og å behandle disse som vurderingsendepunkter er en vanlig tidlig feil.

  1. Kartlegg identifikatorer først. Bruk applikasjons-ID eller kandidat-UUID på hvert kall slik at resultater knyttes til riktig post i stedet for å bli foreldreløse, en fallgruve påpekt i JobCannons integrasjonsrettledning.
  2. Velg et autentiseringsmønster. De fleste plattformer bruker API-nøkler, partnernøkler eller OAuth, og hver krever sin egen sikre lagring og rotasjonspolicy.
  3. Følg standard kallsekvens. List pakker med assessment.list, utløs testen med assessment.start, og lytt deretter etter en webhook som utløses ved fullføring og skriv resultatet tilbake.
  4. Håndter de dokumenterte svarkodene. Ashby API-referansen for assessment.start lister opp 200, 409 og 422 som typiske svar, og integrasjonen din trenger en definert oppførsel for hver av dem.
  5. Definer nyttelasten for resultater. Planlegg for totale poengsum, delpoengsum, tidsstempler, vedlegg og eventuelle egendefinerte attributter teamet ditt ønsker å filtrere på senere.
  6. Planlegg for hastighetsbegrensninger. Be om økt kvote før perioder med høyt ansettelsesvolum slik at en bølge av kandidatinvitasjoner ikke utløser 429-feil midt i en kampanje.

Prototips: Lagre applikasjons-ID-en ved siden av alle utgående og inngående nyttelaster, selv i logger, slik at en mislykket webhook er enkel å spore tilbake til en spesifikk kandidat.

Arbeidsgivere, ikke leverandører, bærer det juridiske ansvaret for ansettelsestesting. EEOCs veiledning om ansettelsestester og utvelgelsesprosedyrer gjør det klart at utvelgelsesverktøy må valideres og være jobrelaterte, og at arbeidsgivere forblir ansvarlige for uforholdsmessig innvirkning selv når en tredjepart har bygget testen. Be enhver vurderingsleverandør om valideringsdokumentasjon før du integrerer verktøyet deres i en aktiv ansettelsesprosess. Vår egen artikkel om EEOCs testretningslinjer går gjennom UGESP-kravene mer detaljert.

  • Be om validerings- og negativ-effekt-dokumentasjon fra enhver vurderingsleverandør før lansering.
  • Lagre vurderingsresultater med et tydelig revisjonsspor og en definert oppbevaringsperiode, ikke på ubestemt tid.
  • Spør leverandører hvordan de logger samtykke for proctoring eller webkameraovervåking, og om en konsekvensutredning for personvern gjelder.
  • Dokumenter din valideringsgjennomgang, kjør en pilot-rettferdighetssjekk på tidlige resultater, og behold dette beviset i arkivet.

Vår spillebok for testing av negativ effekt dekker hvordan du kjører den pilotanalysen og hva du bør rette opp når tallene ser ujevne ut.

Velge mellom innebygd integrasjon, samlet API og egendefinert bygg

Før du forplikter tekniske ressurser, gå gjennom en kort sjekkliste sammen med HR- og ingeniørlederne dine.

  • Bekreft hvilke funksjoner ATS-en støtter innebygd, og hvilke som krever en omvei.
  • Spør enhver vurderingsleverandør om de allerede støtter din ATS, og om partneronboarding medfører en avgift eller et abonnementskrav, siden noen plattformer låser integrasjonsmoduler bak høyere nivåer, ifølge Coderbytes sammenligning av vurderingsplattformintegrasjoner.
  • Bekreft at tilbakeskriving inkluderer strukturerte poengsum, ikke bare en lenke eller et vedlegg, slik at rekrutterere kan filtrere etter resultat.
  • Definer webhook-pålitelighet og forventninger til gjenforsøk på forhånd, og navngi hvem som eier overvåkingen på begge sider.
  • Bekreft at leverandøren kan gi valideringsdokumentasjon, anti-juksekontroller og en databehandlingsavtale.

Prototips: Be om et sandkassemiljø før du signerer noe. En leverandør som ikke kan demonstrere at en test-webhook utløses ende til ende, er ikke klar for produksjonspipelinen din.

Teste integrasjonen ende til ende og oppdage feil tidlig

Et testmiljø bør simulere hele livssyklusen før noen reell kandidat berører det: opprett en testbestilling, utløs webhooken manuelt, og bekreft at resultatet vises korrekt i ATS-brukergrensesnittet, ikke bare i en databasepost.

  1. Kjør testmiljøtester som dekker pakkelisting, bestillingsoppretting og resultat-tilbakeskriving mot realistiske eksempeldata.
  2. Spor webhook-suksessrater og feilutvikling, og bygg en avstemmingsrapport som flagger foreldreløse resultater før de hoper seg opp.
  3. Bruk korrelasjons-ID-er på hver forespørsel slik at en støttehenvendelse kan spores på tvers av begge systemer på minutter, ikke timer.
  4. Bygg idempotent gjenforsøkslogikk slik at en gjensendt webhook aldri skaper et duplikatresultat, og ha et tilbakefyllingsskript klart for eventuelle tapte hendelser.
  5. Skriv en kort driftsplaybook som navngir hvem som varsles ved webhook-feil og hvordan man trygt kan kjøre en fast bestilling på nytt.

Hvor Talent Approved passer inn i en ATS-integrasjon

Talent Approveds plattform inkluderer en funksjon som genererer rollespesifikke vurderinger fra stillingsbeskrivelser eller ferdighetslister, sammen med anti-juksaovervåking og AI-genererte sammendrag som fremskynder gjennomgangen. På integrasjonssiden følger Talent Approved den samme liste-, utløs- og tilbakeskriv-livssyklusen som er beskrevet ovenfor, og å kartlegge applikasjons-ID-en eller kandidat-UUID-en på hvert kall holder resultater korrekt koblet til riktig ATS-post. Prismodellen er betal-per-bruk, en avgift på $5 per fullført kandidat, med ingen abonnement påkrevd. Team som implementerer integrasjonen kan også se vår guide til hvordan øyeblikkelige vurderinger fungerer og våre EEOC-samsvarsressurser for implementerings- og valideringsdetaljer.

Hvor Talent Approved passer inn i en ATS-integrasjon — oversiktsdiagram

Hva HR-team gjør feil med ATS-integrasjon

Hva HR-team gjør feil med ATS-integrasjon — oversiktsdiagram

De fleste team behandler alle ATS-APIer likt, og blir deretter overrasket når «vurderingsintegrasjonen» deres viser seg å være en trinnendringslytter uten strukturert poenggivning tilknyttet. Løsningen er ikke flere ingeniørtimer. Det er å verifisere, på dag én, om det faktisk finnes en ekte vurdering-API i det hele tatt.

Start med et lite pilotprosjekt på én enkelt åpen stilling før du berører hele ansettelsespipelinen din. Hold øye med to ting på én gang: om rekrutterere faktisk bruker poengfiltrering, og om tidlige resultater viser et rettferdighetsavvik på tvers av kandidatgrupper. Når en innebygd vurdering-API eller en bevist samlet API er tilgjengelig, velg den. Rekrutteringsopplevelse og juridisk forsvarbarhet avhenger begge av strukturerte, filtrerbare resultater, ikke en omvei festet til en generell API.

— Jimmie

Utviklerdokumentasjon og samsvarsrettledning verdt å bokmerke

Hold Ashbys integrasjonsdokumentasjon for vurderinger, oversikten over samlet vurdering-API og EEOCs testrettledning lett tilgjengelig. For teknisk støtte på integrasjonssiden spesialiserer firmaer som Ampersand seg på API- og webhook-implementeringsarbeid.

Kilder

FAQ

Hva betyr ATS-integrasjon?

ATS-integrasjon betyr å koble et søkerhåndteringssystem til et annet verktøy, for eksempel en vurderingsplattform, slik at data flyttes automatisk mellom dem i stedet for å kopieres manuelt. For vurderinger spesifikt betyr det å liste testpakker, utløse en test for en kandidat og skrive poengsummen tilbake til kandidatens ATS-post.

Hva er de beste ATS-systemene?

Det finnes ingen enkelt offisiell rangering av de beste ATS-plattformene, og det riktige valget avhenger av bedriftsstørrelse, ansettelsesvolum og nødvendige integrasjoner. I stedet for å nevne spesifikke leverandører bør HR-team evaluere enhver ATS etter om den eksponerer en dokumentert vurdering-API, som beskrevet i Ashbys utviklerdokumentasjon, heller enn å stole på generelle popularitetslister.

Hva er forskjellen mellom en ATS og et CRM?

En ATS styrer ansettelsesarbeidsflyten for åpne stillinger og sporer kandidater fra søknad til tilbud. Et rekruttering-CRM styrer i stedet langsiktige relasjoner med potensielle kandidater, inkludert personer som ikke aktivt søker, noe som er en annen oppgave enn å spore aktive søkere gjennom en pipeline.

Hva står ATS for?

ATS står for applicant tracking system, programvaren HR-team bruker til å legge ut stillinger, samle søknader og flytte kandidater gjennom ansettelsestrinnen. Når det støtter en dedikert vurdering-API, kan det også utløse ferdighetstester og motta strukturerte resultater direkte på kandidatposten, i henhold til integrasjonslivssyklusen beskrevet i Ashbys API-referanse.