TalentApproved

3 API-kald til levering af ATS-vurderingsscorer til HR og teknik

3 API-kald til levering af ATS-vurderingsscorer til HR og teknik

Foretræk en native assessment API, når dit ansøgersporingssystem tilbyder en. Når det ikke gør det, kan du falde tilbage på en system-of-record-integration eller en samlet Assessment API. Uanset hvad skal du planlægge for tre centrale handlinger: liste tilgængelige testpakker, igangsætte en vurdering for en kandidat og synkronisere resultater tilbage via webhooks. Rigere funktioner eller adgang til integrationen overhovedet kan ligge bag et betalt niveau eller et partnerniveau.

TL;DR:

  • Native assessment API'er giver den bedste rekrutteringsoplevelse ved at gøre det muligt at filtrere og rangere kandidater baseret på strukturerede scores inden for ATS'en.
  • Når der ikke er nogen assessment API tilgængelig, vedhæfter fallback-integrationer resultater som noter eller filer, hvilket begrænser muligheden for at filtrere eller sortere kandidatresultater.
  • Den anbefalede integrationssekvens involverer at liste pakker, igangsætte vurderinger og indfange resultater via webhooks, med fokus på sikker identifikation og korrekt håndtering af svarkoder.
  • Arbejdsgivere skal validere og dokumentere vurderingsværktøjer for fairness og juridisk overholdelse inden ibrugtagning, og sikre at resultater opbevares med et revisionsspor og at samtykke er registreret.
  • Grundig test af integrationen i et stagingmiljø og sporing af webhook-succes hjælper med at forhindre fejl og forældreløse resultater i den aktive ansættelsespipeline.
Talent Approved
Vurder kompetencer ud over CV'et
Talent Approved hjælper arbejdsgivere med at oprette skræddersyede kompetencevurderinger, gennemgå strukturerede resultater og træffe mere velinformerede ansættelsesbeslutninger.
Udforsk Talent Approved

Indholdsfortegnelse

Native API'er, fallback-integrationer og samlede Assessment API'er

Tre integrationsmønstre dækker næsten alle ansættelsesstakke, og hvert enkelt ændrer, hvad dine rekrutterere ser inde i ATS'en.

En native assessment API er den reneste mulighed. Den eksponerer testpakker, ordrer og strukturerede resultater direkte inde i ATS-posten, hvilket betyder, at rekrutterere kan filtrere og rangere kandidater efter score på samme måde, som de filtrerer efter fase eller kilde. Ashbys udviklerdokumentation beskriver dette som standardformen: list pakker, start en vurdering, skriv resultater tilbage via en webhook.

Når ATS'en ikke har dedikerede assessment-endepunkter, falder teams tilbage på fase-ændringslyttere og vedhæfter resultater som noter, links eller filupload. Dette bevarer grundlæggende dækning, men fjerner struktureret scoring, så rekrutterere mister muligheden for at sortere eller filtrere efter resultat inde i ATS'en, ifølge Kombos integrationsvejledning.

En samlet Assessment API befinder sig mellem de to. Den standardiserer pakker, ordrewebhooks og resultat-tilbageskrivning på tværs af mange ATS-platforme på én gang, så en leverandør integrerer én gang og når frem til dusinvis af systemer frem for at bygge og vedligeholde et separat stik for hvert enkelt, som beskrevet i oversigten over Unified Assessment API.

  • Native API: bedste rekrutteringsoplevelse, knyttet til én ATS.
  • Fallback-integration: bredest dækning, svageste in-ATS-scoring.
  • Samlet API: lavere langsigtet vedligeholdelse for leverandører, der betjener flere ATS'er.

Opbygning af integrationen: en trinvis tjekliste

Før du skriver nogen kode, skal du bekræfte, at ATS'en faktisk eksponerer en assessment API, og hente udviklerdokumentationen. Mange platforme publicerer kun generelle kandidat- eller ansøgningsendepunkter, og at behandle disse som assessment-endepunkter er en almindelig tidlig fejl.

  1. Kortlæg identifikatorer først. Brug applikations-ID'et eller kandidat-UUID'en på hvert kald, så resultater knyttes til den rigtige post i stedet for at blive forældreløse — en faldgrube fremhævet i JobCannons integrationsvejledning.
  2. Vælg et godkendelses­mønster. De fleste platforme bruger API-nøgler, partnernøgler eller OAuth, og hver kræver sin egen sikre opbevaring og rotationspolitik.
  3. Følg standardkaldssekvensen. List pakker med assessment.list, igangsæt testen med assessment.start, og lyt derefter efter en webhook, der udløses ved afslutning, og skriv resultatet tilbage.
  4. Håndter de dokumenterede svarkoder. Ashby API-referencen for assessment.start angiver 200, 409 og 422 som typiske svar, og din integration skal have en defineret adfærd for hver enkelt.
  5. Definer din resultatnyttelast. Planlæg for samlede scores, delscores, tidsstempler, vedhæftninger og eventuelle brugerdefinerede attributter, som dit team ønsker at filtrere på senere.
  6. Planlæg for hastighedsgrænser. Anmod om kvoteforøgelser inden høj-volume ansættelsesperioder, så en bølge af kandidatinvitationer ikke udløser 429-fejl midt i en kampagne.

Pro Tip: Gem applikations-ID'et ved siden af hver udgående og indgående nyttelast, selv i logs, så en mislykket webhook nemt kan spores tilbage til en specifik kandidat.

Arbejdsgivere, ikke leverandører, bærer den juridiske vægt af ansættelsesprøvning. EEOC's vejledning om ansættelsesprøver og udvælgelsesprocedurer gør det klart, at udvælgelsesværktøjer skal valideres og være jobrelaterede, og at arbejdsgivere fortsat er ansvarlige for disparate impact, selv når en tredjepart har bygget testen. Bed enhver vurderings­leverandør om valideringsdokumentation, inden du integrerer deres værktøj i en aktiv ansættelses­pipeline. Vores egen artikel om EEOC-testretningslinjer gennemgår UGESP-krav mere detaljeret.

  • Anmod om validerings- og adverse-impact-dokumentation fra enhver vurderingsleverandør inden go-live.
  • Opbevar vurderingsresultater med et klart revisionsspor og en defineret opbevaringsperiode — ikke på ubestemt tid.
  • Spørg leverandører, hvordan de logger samtykke til proctoring eller webcam-overvågning, og om en konsekvensanalyse vedrørende databeskyttelse finder anvendelse.
  • Dokumenter din valideringsgennemgang, kør en pilot-fairness-kontrol på tidlige resultater, og opbevar dette bevis.

Vores playbook om adverse impact-testning dækker, hvordan du kører den pilotanalyse, og hvad du skal rette, når tallene ser ujævne ud.

Valg mellem native integration, samlet API og brugerdefineret bygning

Inden du binder ingeniørtid, skal du gennemgå en kort tjekliste med dine HR- og tekniske ledere sammen.

  • Bekræft, hvilke funktioner ATS'en understøtter native i forhold til dem, der kræver en løsning.
  • Spørg enhver vurderingsleverandør, om de allerede understøtter din ATS, og om partner-onboarding medfører et gebyr eller et abonnementskrav, da nogle platforme afskærmer integrationsmoduler bag højere niveauer, ifølge Coderbytes sammenligning af vurderingsplatformsintegrationer.
  • Verificer, at tilbageskrivning inkluderer strukturerede scores og ikke blot et link eller en vedhæftning, så rekrutterere kan filtrere efter resultat.
  • Definer webhook-pålidelighed og gentagelsesforventninger på forhånd, og navngiv hvem der ejer overvågningen på begge sider.
  • Bekræft, at leverandøren kan levere valideringsdokumentation, anti-snyd-kontroller og en databehandlingsaftale.

Pro Tip: Bed om et sandboxmiljø, inden du underskriver noget. En leverandør, der ikke kan demonstrere en test-webhook, der udløses fra ende til anden, er ikke klar til din produktionspipeline.

Test af integrationen fra ende til anden og tidlig opdagelse af fejl

Et stagingmiljø bør simulere den fulde livscyklus, inden nogen reel kandidat rører det: opret en testordre, udløs webhooken manuelt, og bekræft, at resultatet gengives korrekt inde i ATS'ens brugergrænseflade — ikke kun i en databasepost.

  1. Kør stagingtest, der dækker pakkelisting, ordreafgivelse og resultat-tilbageskrivning mod realistiske eksempeldata.
  2. Spor webhook-succesrater og fejltendenser, og byg en afstemningsrapport, der markerer forældreløse resultater, inden de hober sig op.
  3. Brug korrelations-ID'er på hver anmodning, så en supportbillet kan spores på tværs af begge systemer på minutter, ikke timer.
  4. Byg idempotent gentagelseslogik, så en gensendt webhook aldrig opretter et duplikatresultat, og hold et backfill-script klar til eventuelle mistede hændelser.
  5. Skriv en kort operationel playbook, der navngiver, hvem der får besked ved webhook-fejl, og hvordan man sikkert genstarter en fastlåst ordre.

Hvor Talent Approved passer ind i en ATS-integration

Talent Approved's platform inkluderer en funktion, der genererer rollespecifikke vurderinger fra jobopslag eller kompetence­lister, sideløbende med anti-snyd-overvågning og AI-genererede resuméer, der fremskynder gennemgangen. På integrationssiden følger Talent Approved den samme list-, udløse- og tilbageskrivningslivscyklus, der er beskrevet ovenfor, og kortlægning af applikations-ID'et eller kandidat-UUID'en på hvert kald holder resultater korrekt knyttet til den rigtige ATS-post. Prismodellen er betal-per-brug, et gebyr på $5 per gennemført kandidat, uden abonnement påkrævet. Teams, der implementerer integrationen, kan også gennemgå vores guide til, hvordan øjeblikkelige vurderinger fungerer, og vores EEOC-compliance-ressourcer for implementerings- og valideringsdetaljer.

Hvor Talent Approved passer ind i en ATS-integration — oversigtsdiagram

Hvad HR-teams tager fejl af ved ATS-integration

Hvad HR-teams tager fejl af ved ATS-integration — oversigtsdiagram

De fleste teams behandler enhver ATS API ens og bliver derefter overraskede, når deres "assessment-integration" viser sig at være en fase-ændringslytter uden nogen struktureret scoring tilknyttet. Løsningen er ikke flere ingeniørtimer. Det er at verificere, allerede på dag ét, om en reel assessment API overhovedet eksisterer.

Start med en lille pilot på en enkelt åben stilling, inden du rører din fulde ansættelses­pipeline. Hold øje med to ting på én gang: om rekrutterere faktisk bruger score-filtreringen, og om tidlige resultater viser et fairness-hul på tværs af kandidatgrupper. Når en native assessment API eller en afprøvet samlet API er tilgængelig, skal du vælge den. Rekrutteringsoplevelse og juridisk forsvarlighed er begge afhængige af strukturerede, filtrerbare resultater — ikke af en løsning boltet på en generelt tilgængelig API.

— Jimmie

Udviklerdokumentation og compliance-vejledning værd at bogmærke

Hold Ashby assessments-integrationsdokumentationen, oversigten over Unified Assessment API og EEOC's testvejledning tæt ved hånden. For teknisk support på integrationssiden specialiserer firmaer som Ampersand sig i API- og webhook-implementeringsarbejde.

Kilder

FAQ

Hvad betyder ATS-integration?

ATS-integration betyder at forbinde et ansøgersporingssystem med et andet værktøj, såsom en vurderingsplatform, så data flytter automatisk mellem dem i stedet for at blive kopieret i hånden. For vurderinger specifikt betyder det at liste testpakker, igangsætte en test for en kandidat og skrive scoren tilbage til kandidatens ATS-post.

Hvad er de bedste ATS-systemer?

Der er ingen enkelt officiel rangering af de bedste ATS-platforme, og det rigtige valg afhænger af virksomhedsstørrelse, ansættelsesvolumen og påkrævede integrationer. Frem for at nævne specifikke leverandører bør HR-teams evaluere enhver ATS ud fra, om den eksponerer en dokumenteret assessment API, som beskrevet i Ashbys udviklerdokumenter, frem for at stole på generelle popularitetslister.

Hvad er forskellen mellem en ATS og et CRM?

En ATS styrer ansættelses­arbejdsgangen for åbne stillinger og sporer kandidater fra ansøgning til tilbud. Et rekrutterings-CRM styrer derimod langsigtede relationer med potentielle kandidater, herunder personer, der ikke aktivt søger, hvilket er en anden opgave end at spore aktive ansøgere gennem en pipeline.

Hvad står ATS for?

ATS står for applicant tracking system, det software HR-teams bruger til at slå stillinger op, indsamle ansøgninger og flytte kandidater gennem ansættelsesfaser. Når det understøtter en dedikeret assessment API, kan det også igangsætte kompetenceprøver og modtage strukturerede resultater direkte på kandidatposten, i henhold til den integrationslivscyklus, der er beskrevet i Ashbys API-reference.