TalentApproved

3 API-kutsua ATS-arviointipisteiden toimittamiseen HR:lle ja kehittäjille

3 API-kutsua ATS-arviointipisteiden toimittamiseen HR:lle ja kehittäjille

Suosi natiiviasiointiliittymää (assessment API) silloin, kun hakijaseurantajärjestelmäsi tarjoaa sellaisen. Kun sellaista ei ole saatavilla, turvaudu järjestelmäpohjaiseen integraatioon tai yhtenäiseen Assessment API:iin. Suunnittele joka tapauksessa kolme keskeistä toimintoa: saatavilla olevien testipakettien listaaminen, arvioinnin käynnistäminen ehdokkaalle ja tulosten synkronointi takaisin webhookien kautta. Rikkaammat ominaisuudet tai pääsy integraatioon ylipäätään saattavat edellyttää maksullista tai kumppanuustasoa.

TL;DR:

  • Natiiviarviointi-API:t tarjoavat parhaan rekrytoijakokemuksen, koska ne mahdollistavat ehdokkaiden suodattamisen ja järjestämisen rakenteellisten pisteiden perusteella ATS:n sisällä.
  • Kun arviointi-API:a ei ole saatavilla, varavaihtoehtoiset integraatiot liittävät tulokset muistiinpanoina tai tiedostoina, mikä rajoittaa mahdollisuutta suodattaa tai lajitella ehdokastuloksia.
  • Suositeltu integraatiojärjestys sisältää pakettien listaamisen, arviointien käynnistämisen ja tulosten vastaanottamisen webhookien kautta, painottaen turvallista tunnistamista ja vastauskoodeista asianmukaisesti huolehtimista.
  • Työnantajien on validoitava ja dokumentoitava arviointityökalut oikeudenmukaisuuden ja lakisääteisen vaatimustenmukaisuuden osalta ennen käyttöönottoa, varmistaen, että tulokset tallennetaan auditointipolun kera ja suostumus on kirjattu.
  • Integraation perusteellinen testaaminen staging-ympäristössä ja webhookien onnistumisen seuraaminen auttavat ehkäisemään virheitä ja irtonaisia tuloksia tuotantohakemusputkessa.
Talent Approved
Arvioi taitoja ansioluettelon ulkopuolelta
Talent Approved auttaa työnantajia luomaan räätälöityjä taitoarviointeja, tarkastelemaan rakenteellisia tuloksia ja tekemään tietoon perustuvia rekrytointipäätöksiä.
Tutustu Talent Approvediin

Sisällysluettelo

Natiivirajapinnat, varaintegraatiot ja yhtenäiset Assessment API:t

Kolme integraatiomallia kattaa lähes jokaisen rekrytointijärjestelmäkokonaisuuden, ja jokainen muuttaa sitä, mitä rekrytoijat näkevät ATS:n sisällä.

Natiivi Assessment API on selkein vaihtoehto. Se paljastaa testipakettit, tilaukset ja rakenteelliset tulokset suoraan ATS-tietueessa, mikä tarkoittaa, että rekrytoijat voivat suodattaa ja järjestää ehdokkaita pisteiden perusteella samalla tavoin kuin he suodattavat vaiheen tai lähteen mukaan. Ashbyn kehittäjädokumentaatio kuvaa tätä standardimuotona: listaa paketit, käynnistä arviointi, kirjoita tulokset takaisin webhookin kautta.

Kun ATS:ssä ei ole omistettuja arviointipäätepisteitä, tiimit turvautuvat vaiheen muutoksen kuuntelijoihin ja liittävät tulokset muistiinpanoina, linkkeinä tai tiedostolatauksina. Tämä säilyttää perustason kattavuuden, mutta poistaa rakenteellisen pisteytyksen, joten rekrytoijat menettävät mahdollisuuden lajitella tai suodattaa tuloksen perusteella ATS:n sisällä, kuten Kombon integraatio-opas toteaa.

Yhtenäinen Assessment API sijoittuu näiden kahden väliin. Se standardoi paketit, tilauswebhookit ja tulosten takaisinkirjoituksen useilla ATS-alustoilla kerralla, joten toimittaja integroituu kerran ja tavoittaa kymmeniä järjestelmiä sen sijaan, että rakentaisi ja ylläpitäisi erillistä liitintä jokaiselle, kuten Unified Assessment API:n yleiskatsauksessa kuvataan.

  • Natiivi API: paras rekrytoijakokemus, sidottu yhteen ATS:ään.
  • Varaintegraatio: laajin kattavuus, heikoin ATS-sisäinen pisteytys.
  • Yhtenäinen API: pienempi pitkän aikavälin ylläpito useita ATS:iä palveleville toimittajille.

Integraation rakentaminen: vaiheittainen tarkistuslista

Ennen koodin kirjoittamista varmista, että ATS todella tarjoaa Assessment API:n, ja hanki kehittäjädokumentaatio. Monet alustat julkaisevat vain yleisiä ehdokas- tai hakemuspäätepisteitä, ja niiden käsitteleminen arviointipäätepisteinä on yleinen varhainen virhe.

  1. Kartoita tunnisteet ensin. Käytä hakemuksen ID:tä tai ehdokkaan UUID:ta jokaisessa kutsussa, jotta tulokset liittyvät oikeaan tietueeseen sen sijaan, että ne jäisivät irtonaisiksi — tähän ansaan huomautetaan JobCannonin integraatio-ohjeissa.
  2. Valitse autentikointimalli. Useimmat alustat käyttävät API-avaimia, kumppaniavaimia tai OAuthia, ja jokainen vaatii oman turvallisen tallennuksen ja kierrätyskäytännön.
  3. Seuraa standardisoitua kutsujärjestystä. Listaa paketit komennolla assessment.list, käynnistä testi komennolla assessment.start, kuuntele sitten webhook, joka laukeaa valmistumisen yhteydessä, ja kirjoita tulos takaisin.
  4. Käsittele dokumentoidut vastauskoodit. Ashbyn API-viite assessment.start-komennolle listaa tyypillisinä vastauksina 200, 409 ja 422, ja integraatiosi tarvitsee määritellyn toimintamallin jokaiselle.
  5. Määrittele tulospaketti. Suunnittele kokonaispisteet, osapisteet, aikaleimat, liitteet ja mahdolliset mukautetut attribuutit, joiden perusteella tiimisi haluaa myöhemmin suodattaa.
  6. Suunnittele nopeusrajoitukset etukäteen. Pyydä kiintiökorotuksia ennen suuren volyymin rekrytointikausia, jotta ehdokaskutsujen piikki ei laukaise 429-virheitä kampanjan puolivälissä.

Vinkki: Tallenna hakemuksen ID jokaisen lähtevän ja saapuvan paketin yhteydessä, myös lokeihin, jotta epäonnistunut webhook on helppo jäljittää tiettyyn ehdokkaaseen.

Työnantajat, eivät toimittajat, kantavat työllistämistestauksen oikeudellisen vastuun. EEOC:n ohjeet työllistämistestejä ja valintamenettelyjä koskien tekevät selväksi, että valintavälineiden on oltava validoituja ja työhön liittyviä, ja että työnantajat pysyvät vastuussa epäsuhtaisesta vaikutuksesta, vaikka kolmas osapuoli olisi rakentanut testin. Pyydä arvioitsijapalvelun toimittajalta validointidokumentaatio ennen kuin integroit heidän työkalunsa tuotantohakemusputkeen. Oma EEOC-testausohjeitamme käsittelevä artikkelimme käy läpi UGESP-vaatimukset yksityiskohtaisemmin.

  • Pyydä validointi- ja haitallisen vaikutuksen dokumentaatio kaikilta arviointitoimittajilta ennen käyttöönottoa.
  • Tallenna arviointitulokset selkeällä auditointipolulla ja määritellyllä säilytysajalla, ei toistaiseksi voimassa olevana.
  • Kysy toimittajilta, miten he kirjaavat suostumuksen valvontaan tai web-kameraseurantaan, ja sovelletaanko tietosuojan vaikutustenarviointi.
  • Dokumentoi validointikatsauksesi, suorita pilottioikeudenmukaisuustarkistus varhaisista tuloksista ja säilytä todisteet arkistossa.

Meidän haitallisen vaikutuksen testauksen käsikirjamme käsittelee, miten pilottianalyysi suoritetaan ja mitä korjata, kun luvut näyttävät epätasaisilta.

Valinta natiivi-integraation, yhtenäisen API:n ja mukautetun toteutuksen välillä

Ennen kehitysajan sitomista käy läpi lyhyt tarkistuslista HR- ja kehitysjohtajesi kanssa yhdessä.

  • Vahvista, mitkä ominaisuudet ATS tukee natiivisti ja mitkä vaativat kiertotien.
  • Kysy arviointitoimittajilta, tukevatko he jo ATS:äsi, ja aiheuttaako kumppanin käyttöönotto maksun tai tilausvaatimuksen, sillä jotkin alustat rajoittavat integrointimoduuleja korkeampien tasojen taakse, Coderbyte'n arviointialustaintegraatioiden vertailun mukaan.
  • Varmista, että takaisinkirjoitus sisältää rakenteelliset pisteet, ei pelkästään linkin tai liitteen, jotta rekrytoijat voivat suodattaa tuloksen perusteella.
  • Määrittele webhookin luotettavuus ja uudelleenyritysodotukset etukäteen, ja nimeä, kuka omistaa seurannan molemmilla puolilla.
  • Varmista, että toimittaja pystyy toimittamaan validointidokumentaation, huijaustenestotoiminnot ja tietojenkäsittelysopimuksen.

Vinkki: Pyydä sandbox-ympäristöä ennen minkään allekirjoittamista. Toimittaja, joka ei pysty demonstroimaan testiwebhookin laukeamista päästä päähän, ei ole valmis tuotantoputkeesi.

Integraation päästä päähän testaaminen ja vikojen havaitseminen ajoissa

Staging-ympäristön tulisi simuloida koko elinkaarta ennen kuin yksikään todellinen ehdokas koskee siihen: luo testitilaus, laukaise webhook manuaalisesti ja varmista, että tulos näkyy oikein ATS:n käyttöliittymässä, ei pelkästään tietokannassa.

  1. Suorita staging-testit, jotka kattavat pakettien listaamisen, tilauksen luomisen ja tulosten takaisinkirjoituksen realistisia näytetietoja vastaan.
  2. Seuraa webhookin onnistumisprosentteja ja virhetrendejä, ja rakenna täsmäytysraportti, joka merkitsee irtonaiset tulokset ennen kuin niitä kertyy liikaa.
  3. Käytä korrelaatio-ID:itä jokaisessa pyynnössä, jotta tukipyyntö voidaan jäljittää molemmissa järjestelmissä minuuteissa, ei tunneissa.
  4. Rakenna idempotenttiset uudelleenyrityslogiikka, jotta uudelleenlähetetty webhook ei koskaan luo kaksoistulosta, ja pidä takaisintäyttöskripti valmiina mahdollisten puuttuvien tapahtumien varalta.
  5. Kirjoita lyhyt toiminnallinen käsikirja, jossa nimetään, kuka saa ilmoituksen webhookin epäonnistumisesta ja miten juuttuneen tilauksen voi turvallisesti ajaa uudelleen.

Missä Talent Approved sopii ATS-integraatioon

Talent Approved -alusta sisältää ominaisuuden, joka luo roolikohtaisia arviointeja työnkuvauksista tai taitolistoista, huijaustenestoseurannan ja tekoälyllä tuotetut yhteenvedot, jotka nopeuttavat arviointia. Integraatiopuolella Talent Approved noudattaa samaa listaus-, käynnistys- ja takaisinkirjoituselinkaarta, joka on kuvattu edellä, ja hakemuksen ID:n tai ehdokkaan UUID:n yhdistäminen jokaiseen kutsuun pitää tulokset oikein liitettyinä oikeaan ATS-tietueeseen. Hinnoittelumalli on maksa käytön mukaan — 5 dollarin maksu per suoritettu ehdokas, ilman tilaustarvetta. Integraatiota toteuttavat tiimit voivat myös tutustua oppaaseemme siitä, miten pikaarvioinnit toimivat, sekä EEOC-vaatimustenmukaisuusresurssejamme toteutus- ja validointitietoja varten.

Missä Talent Approved sopii ATS-integraatioon — yleiskatsauskaavio

Mitä HR-tiimit tekevät väärin ATS-integraatiossa

Mitä HR-tiimit tekevät väärin ATS-integraatiossa — yleiskatsauskaavio

Useimmat tiimit kohtelevat jokaista ATS API:a samalla tavoin, ja yllättyvät sitten, kun heidän "arviointiintegraationsa" osoittautuu vaiheen muutoksen kuuntelijaksi ilman rakenteellisia pisteitä. Korjaus ei ole lisää kehitystunteja. Se on varmistaminen jo ensimmäisenä päivänä, onko todellinen Assessment API olemassa lainkaan.

Aloita pienellä pilotilla yhdessä avoimessa tehtävässä ennen kuin kosket koko hakemusputkeesi. Seuraa kahta asiaa samanaikaisesti: käyttävätkö rekrytoijat todella pisteiden suodatusta, ja näyttävätkö varhaistulokset oikeudenmukaisuuseroja ehdokasryhmien välillä. Kun natiivi Assessment API tai todistettu yhtenäinen API on saatavilla, valitse se. Rekrytoijakokemus ja oikeudellinen puolustettavuus riippuvat molemmat rakenteellisista, suodatettavista tuloksista — ei yleiskäyttöiseen API:iin ruuvailusta kiertotiestä.

— Jimmie

Kirjanmerkin arvoiset kehittäjädokumentit ja vaatimustenmukaisuusohjeet

Pidä Ashbyn arviointiintegraatiodokumentit, Unified Assessment API:n yleiskatsaus ja EEOC:n testausohjeet käden ulottuvilla. Integraatiopuolen tekniseen tukeen erikoistuneet yritykset, kuten Ampersand, ovat erikoistuneet API- ja webhook-toteutustyöhön.

Lähteet

UKK

Mitä ATS-integraatio tarkoittaa?

ATS-integraatio tarkoittaa hakijaseurantajärjestelmän yhdistämistä toiseen työkaluun, kuten arviointialustaan, jotta tiedot siirtyvät automaattisesti niiden välillä sen sijaan, että ne kopioitaisiin käsin. Arviointien osalta tämä tarkoittaa testipakettien listaamista, testin käynnistämistä ehdokkaalle ja pisteiden kirjoittamista takaisin ehdokkaan ATS-tietueeseen.

Mitkä ovat suosituimmat ATS-järjestelmät?

Parhaiden ATS-alustojen virallista yhtä listausta ei ole, ja oikea valinta riippuu yrityksen koosta, rekrytointivolyymista ja tarvittavista integraatioista. Sen sijaan, että nimeäisi tiettyjä toimittajia, HR-tiimien tulisi arvioida mitä tahansa ATS:ää sen perusteella, tarjoaako se dokumentoidun Assessment API:n, kuten Ashbyn kehittäjädokumenteissa kuvataan, eikä nojautua yleiseen suosiollistukseen.

Mikä on ATS:n ja CRM:n ero?

ATS hallinnoi avointen tehtävien rekrytointityönkulkua, seuraten ehdokkaita hakemuksesta tarjoukseen. Rekrytointiin tarkoitettu CRM puolestaan hallinnoi pitkäaikaisia suhteita potentiaaalisten ehdokkaiden kanssa, mukaan lukien henkilöt, jotka eivät aktiivisesti hae, mikä on eri tehtävä kuin aktiivisten hakijoiden seuraaminen putken läpi.

Mitä ATS tarkoittaa?

ATS tarkoittaa hakijaseurantajärjestelmää (applicant tracking system), ohjelmistoa, jota HR-tiimit käyttävät työpaikkojen julkaisemiseen, hakemusten keräämiseen ja ehdokkaiden siirtämiseen rekrytointivaiheiden läpi. Kun se tukee omistettua Assessment API:a, se voi myös käynnistää taitotestejä ja vastaanottaa rakenteellisia tuloksia suoraan ehdokastietueelle, Ashbyn API-viitteen kuvaamaa integraatioelinkaarta noudattaen.