TalentApproved

3 Chiamate API per Inviare i Punteggi di Valutazione ATS a HR e Engineering

3 Chiamate API per Inviare i Punteggi di Valutazione ATS a HR e Engineering

Preferisci un'API di valutazione nativa quando il tuo sistema di tracciamento dei candidati la offre. Quando non è disponibile, ricorri a un'integrazione di sistema di riferimento o a un'API di valutazione unificata. In entrambi i casi, pianifica tre azioni fondamentali: elencare i pacchetti di test disponibili, avviare una valutazione per un candidato e sincronizzare i risultati tramite webhook. Funzionalità più avanzate o l'accesso all'integrazione in generale potrebbero essere riservati a un livello a pagamento o partner.

TL;DR:

  • Le API di valutazione native offrono la migliore esperienza per i recruiter, consentendo di filtrare e classificare i candidati in base a punteggi strutturati all'interno dell'ATS.
  • Quando non è disponibile nessuna API di valutazione, le integrazioni di fallback allegano i risultati come note o file, il che limita la possibilità di filtrare o ordinare i risultati dei candidati.
  • La sequenza di integrazione consigliata prevede l'elenco dei pacchetti, l'avvio delle valutazioni e la raccolta dei risultati tramite webhook, con attenzione all'identificazione sicura e alla corretta gestione dei codici di risposta.
  • I datori di lavoro devono validare e documentare gli strumenti di valutazione per verificarne l'equità e la conformità legale prima dell'implementazione, garantendo che i risultati siano archiviati con una traccia di audit e che il consenso sia registrato.
  • Testare a fondo l'integrazione in un ambiente di staging e monitorare il successo dei webhook aiuta a prevenire errori e risultati orfani nella pipeline di selezione in produzione.
Talent Approved
Valuta le Competenze Oltre il CV
Talent Approved aiuta i datori di lavoro a creare valutazioni delle competenze su misura, esaminare risultati strutturati e prendere decisioni di assunzione più consapevoli.
Esplora Talent Approved

Indice dei contenuti

API native, integrazioni di fallback e API di valutazione unificate

Tre schemi di integrazione coprono quasi ogni stack di selezione, e ognuno cambia ciò che i recruiter vedono all'interno dell'ATS.

Un'API di valutazione nativa è l'opzione più efficiente. Espone pacchetti di test, ordini e risultati strutturati direttamente nel record dell'ATS, il che significa che i recruiter possono filtrare e classificare i candidati per punteggio nello stesso modo in cui filtrano per fase o fonte. La documentazione per sviluppatori di Ashby descrive questo come la struttura standard: elencare i pacchetti, avviare una valutazione, scrivere i risultati tramite un webhook.

Quando l'ATS non dispone di endpoint dedicati alla valutazione, i team ricorrono a listener di cambio di fase e allegano i risultati come note, link o file caricati. Questo preserva una copertura di base, ma elimina il punteggio strutturato, quindi i recruiter perdono la possibilità di ordinare o filtrare per risultato all'interno dell'ATS, secondo la guida all'integrazione di Kombo.

Un'API di valutazione unificata si posiziona tra le due. Standardizza pacchetti, webhook degli ordini e riscrittura dei risultati su molte piattaforme ATS contemporaneamente, così un fornitore si integra una volta sola e raggiunge decine di sistemi invece di costruire e mantenere un connettore separato per ciascuno, come descritto nella panoramica dell'API di valutazione unificata.

  • API nativa: migliore esperienza per il recruiter, legata a un singolo ATS.
  • Integrazione di fallback: copertura più ampia, punteggio in-ATS più debole.
  • API unificata: minore manutenzione a lungo termine per i fornitori che servono più ATS.

Costruire l'integrazione: una checklist passo dopo passo

Prima di scrivere qualsiasi codice, verifica che l'ATS esponga effettivamente un'API di valutazione e recupera la documentazione per sviluppatori. Molte piattaforme pubblicano solo endpoint generali per candidati o candidature, e trattarli come endpoint di valutazione è un errore comune nelle prime fasi.

  1. Mappa prima gli identificatori. Utilizza l'ID candidatura o il UUID del candidato in ogni chiamata in modo che i risultati si colleghino al record corretto anziché diventare orfani, un problema segnalato nella guida all'integrazione di JobCannon.
  2. Scegli uno schema di autenticazione. La maggior parte delle piattaforme utilizza chiavi API, chiavi partner o OAuth, e ognuna richiede la propria politica di archiviazione sicura e rotazione.
  3. Segui la sequenza di chiamate standard. Elenca i pacchetti con assessment.list, avvia il test con assessment.start, poi ascolta un webhook che si attiva al completamento e scrivi il risultato.
  4. Gestisci i codici di risposta documentati. Il riferimento API di Ashby per assessment.start elenca 200, 409 e 422 come risposte tipiche, e la tua integrazione deve avere un comportamento definito per ciascuno.
  5. Definisci il payload dei risultati. Pianifica punteggi complessivi, sotto-punteggi, timestamp, allegati e qualsiasi attributo personalizzato su cui il team vuole filtrare in seguito.
  6. Pianifica i limiti di frequenza. Richiedi aumenti di quota prima dei periodi di assunzione ad alto volume in modo che un'ondata di inviti ai candidati non generi errori 429 a metà campagna.

Consiglio Pro: Archivia l'ID candidatura insieme a ogni payload in uscita e in entrata, anche nei log, in modo che un webhook fallito sia facile da ricondurre a un candidato specifico.

Sono i datori di lavoro, non i fornitori, a portare il peso legale dei test di selezione. Le linee guida dell'EEOC sui test di selezione e sulle procedure di selezione chiariscono che gli strumenti di selezione devono essere validati e correlati al lavoro, e che i datori di lavoro rimangono responsabili dell'impatto disparato anche quando il test è stato costruito da terze parti. Chiedi a qualsiasi fornitore di valutazione la documentazione di validazione prima di integrare il loro strumento in una pipeline di selezione attiva. Il nostro articolo sulle linee guida per i test EEOC illustra i requisiti UGESP in modo più dettagliato.

  • Richiedi documentazione di validazione e di impatto negativo a qualsiasi fornitore di valutazione prima del go-live.
  • Archivia i risultati delle valutazioni con una traccia di audit chiara e un periodo di conservazione definito, non indefinitamente.
  • Chiedi ai fornitori come registrano il consenso per il proctoring o il monitoraggio via webcam, e se si applica una valutazione d'impatto sulla protezione dei dati.
  • Documenta la tua revisione di validazione, esegui un controllo pilota sull'equità dei risultati iniziali e conserva tale documentazione come prova.

Il nostro playbook sui test di impatto negativo spiega come condurre quell'analisi pilota e cosa correggere quando i numeri appaiono sbilanciati.

Scegliere tra integrazione nativa, API unificata e sviluppo personalizzato

Prima di impegnare tempo di sviluppo, esegui una breve checklist insieme ai responsabili HR e tecnici.

  • Verifica quali funzionalità l'ATS supporta nativamente e quali richiedono una soluzione alternativa.
  • Chiedi a qualsiasi fornitore di valutazione se supporta già il tuo ATS e se l'onboarding come partner prevede una tariffa o un requisito di abbonamento, poiché alcune piattaforme riservano i moduli di integrazione a livelli superiori, secondo il confronto di Coderbyte sulle integrazioni delle piattaforme di valutazione.
  • Verifica che la riscrittura dei risultati includa punteggi strutturati, non solo un link o un allegato, in modo che i recruiter possano filtrare per risultato.
  • Definisci in anticipo l'affidabilità dei webhook e le aspettative di nuovo tentativo, e identifica chi gestisce il monitoraggio su entrambi i lati.
  • Verifica che il fornitore possa fornire documentazione di validazione, controlli anti-cheat e un accordo sul trattamento dei dati.

Consiglio Pro: Chiedi un ambiente sandbox prima di firmare qualsiasi cosa. Un fornitore che non riesce a dimostrare l'attivazione di un webhook di test end to end non è pronto per la tua pipeline di produzione.

Testare l'integrazione end to end e rilevare i problemi in anticipo

Un ambiente di staging dovrebbe simulare l'intero ciclo di vita prima che qualsiasi candidato reale lo attraversi: crea un ordine di test, attiva il webhook manualmente e verifica che il risultato venga visualizzato correttamente nell'interfaccia dell'ATS, non solo in un record di database.

  1. Esegui test di staging che coprano l'elenco dei pacchetti, la creazione degli ordini e la riscrittura dei risultati con dati di esempio realistici.
  2. Monitora i tassi di successo dei webhook e le tendenze degli errori, e costruisci un report di riconciliazione che segnali i risultati orfani prima che si accumulino.
  3. Utilizza correlation ID su ogni richiesta in modo che un ticket di supporto possa essere tracciato su entrambi i sistemi in minuti, non ore.
  4. Costruisci una logica di nuovo tentativo idempotente in modo che un webhook riinviato non crei mai un risultato duplicato, e tieni pronto uno script di backfill per eventuali eventi mancati.
  5. Scrivi un breve playbook operativo che indichi chi viene avvisato in caso di errore del webhook e come riavviare in sicurezza un ordine bloccato.

Dove si inserisce Talent Approved in un'integrazione ATS

La piattaforma di Talent Approved include una funzionalità che genera valutazioni specifiche per ruolo a partire da descrizioni del lavoro o elenchi di competenze, insieme al monitoraggio anti-cheat e a riepiloghi generati dall'AI che accelerano la revisione. Sul fronte dell'integrazione, Talent Approved segue lo stesso ciclo di vita di elenco, avvio e riscrittura descritto sopra, e la mappatura dell'ID candidatura o del UUID del candidato su ogni chiamata mantiene i risultati correttamente collegati al record ATS corretto. Il modello di prezzo è pay-as-you-go, con una tariffa di $5 per ogni candidato completato, senza abbonamento richiesto. I team che implementano l'integrazione possono anche consultare la nostra guida al funzionamento delle valutazioni istantanee e le nostre risorse sulla conformità EEOC per i dettagli di implementazione e validazione.

Dove si inserisce Talent Approved in un'integrazione ATS — diagramma panoramico

Cosa sbaglia il team HR sull'integrazione ATS

Cosa sbaglia il team HR sull'integrazione ATS — diagramma panoramico

La maggior parte dei team tratta ogni API ATS allo stesso modo, poi si sorprende quando la propria "integrazione di valutazione" si rivela essere un listener di cambio di fase senza punteggio strutturato allegato. La soluzione non sono più ore di sviluppo. È verificare, fin dal primo giorno, se esiste davvero un'API di valutazione.

Inizia con un piccolo pilota su un singolo ruolo aperto prima di toccare l'intera pipeline di selezione. Osserva due cose contemporaneamente: se i recruiter utilizzano effettivamente il filtro per punteggio, e se i risultati iniziali mostrano lacune di equità tra i gruppi di candidati. Quando è disponibile un'API di valutazione nativa o un'API unificata collaudata, sceglila. L'esperienza del recruiter e la difendibilità legale dipendono entrambe da risultati strutturati e filtrabili, non da una soluzione alternativa innestata su un'API generica.

— Jimmie

Documentazione per sviluppatori e guide alla conformità da tenere nei segnalibri

Tieni a portata di mano la documentazione sull'integrazione delle valutazioni di Ashby, la panoramica dell'API di valutazione unificata e le linee guida sui test dell'EEOC. Per il supporto tecnico sul lato dell'integrazione, aziende come Ampersand sono specializzate nell'implementazione di API e webhook.

Fonti

FAQ

Cosa significa integrazione ATS?

L'integrazione ATS significa collegare un sistema di tracciamento dei candidati a un altro strumento, come una piattaforma di valutazione, in modo che i dati si spostino automaticamente tra di essi invece di essere copiati manualmente. Per le valutazioni in particolare, ciò significa elencare i pacchetti di test, avviare un test per un candidato e scrivere il punteggio nel record ATS del candidato.

Quali sono i principali sistemi ATS?

Non esiste una classifica ufficiale delle migliori piattaforme ATS, e la scelta giusta dipende dalle dimensioni dell'azienda, dal volume delle assunzioni e dalle integrazioni richieste. Invece di citare fornitori specifici, i team HR dovrebbero valutare qualsiasi ATS in base al fatto che esponga un'API di valutazione documentata, come descritto nella documentazione per sviluppatori di Ashby, piuttosto che affidarsi a generiche classifiche di popolarità.

Qual è la differenza tra un ATS e un CRM?

Un ATS gestisce il flusso di lavoro di selezione per i ruoli aperti, tracciando i candidati dalla candidatura all'offerta. Un CRM di recruiting gestisce invece le relazioni a lungo termine con i potenziali candidati, incluse le persone che non stanno candidandosi attivamente, il che è un compito diverso dal tracciare i candidati attivi attraverso una pipeline.

Cosa significa ATS?

ATS è l'acronimo di applicant tracking system (sistema di tracciamento dei candidati), il software che i team HR utilizzano per pubblicare offerte di lavoro, raccogliere candidature e far avanzare i candidati attraverso le fasi di selezione. Quando supporta un'API di valutazione dedicata, può anche avviare test sulle competenze e ricevere risultati strutturati direttamente nel record del candidato, secondo il ciclo di vita dell'integrazione descritto nel riferimento API di Ashby.