Vai al contenuto

Collegare i colloqui con IA al tuo ATS, all'API o alla pagina carriere.

Un'integrazione ATS per i colloqui con IA, l'API pubblica con i webhook o il colloquio incorporato nella tua pagina carriere: cosa fa ciascuno, come scegliere e come configurarlo e testarlo.

Aggiornato il 17 novembre 2026 · 9 min di lettura

In questa pagina

In breve

  • Tre modi per collegarsi: una connessione ATS nativa, l'API pubblica con i webhook o il colloquio incorporato nella tua pagina carriere. Puoi usarne più di uno.
  • ATS: associa una posizione e una fase in Workable, Greenhouse, Teamtailor, Recruitee o Breezy HR a un colloquio pubblicato. Ogni candidato spostato in quella fase viene invitato una sola volta e i risultati tornano come nota.
  • API: crea candidati e inviti dai tuoi sistemi con una chiave API a permessi limitati e scopri cosa è successo tramite webhook firmati.
  • Embed: esegui il colloquio all'interno del tuo sito con un solo script, dai siti che autorizzi.
  • Prima, fai una prova: invia un evento di test del webhook, sposta un candidato di test nella fase e leggi i log di consegna e di attività prima di andare live.

Tre modi per collegare i colloqui con IA

Un'integrazione ATS per i colloqui con IA risparmia ai tuoi selezionatori il copia e incolla: i candidati vengono invitati dal sistema che usi già e i risultati vi ritornano. Se il tuo ATS non ha una connessione nativa, o assumi tramite un tuo portale, l'API pubblica e l'embed fanno lo stesso lavoro con un po' di codice.

  • Connessione ATS nativa. Workable, Greenhouse, Teamtailor, Recruitee e Breezy HR. Nessun codice: incolla una chiave, associa una posizione e una fase, e spostare un candidato in quella fase invia l'invito.
  • API pubblica e webhook. Il tuo sistema crea candidati e inviti via REST e recupera i risultati; i webhook lo avvisano quando succede qualcosa.
  • Embed SDK. Uno script esegue il colloquio in un frame nella tua pagina carriere. Richiede un link d'invito, quindi va usato insieme all'API.
Video tutorial, 3:16. Collegare Greenhouse e associare la fase di una posizione a un colloquio, poi Slack, una chiave API e un webhook. In inglese, con sottotitoli.

Tutti e tre richiedono un piano a pagamento e un admin dell'azienda. Il colloquio è lo stesso che i candidati ricevono tramite il link via email, compresa la possibilità di scrivere invece di parlare.

Scegliere tra ATS, API ed embed

Connessione ATS nativaAPI pubblica e webhookEmbed SDK (con l'API)
Ideale perTeam che usano uno dei cinque ATS supportatiQualsiasi altro ATS o un tuo flusso di lavoroUna pagina carriere o un portale che gestisci tu
Codice necessarioNessunoChiamate API e un ricevitore di webhookPoche righe nella pagina, più l'API
Cosa invia l'invitoLo spostamento di un candidato nella fase associataLa tua chiamata APILa tua chiamata API; il link viene montato nella tua pagina
I risultati tornano comeUna nota sul candidato nell'ATSRisultati che recuperi dopo il webhook dei risultatiLo stesso; la pagina sa solo che il candidato ha finito

Parti dalla connessione nativa se il tuo ATS ne ha una. Scegli l'API quando ti serve controllare chi viene invitato e quando. Aggiungi l'embed quando i candidati devono restare sul tuo sito.

Configurare un'integrazione ATS per i colloqui con IA

Collegare un ATS e associare una posizione

  1. Pubblica il colloquio. Solo un colloquio pubblicato può essere associato a una posizione.
  2. Apri Integrazioni → ATS e premi Collega ATS. Incolla le credenziali dell'ATS (dove trovarle). testee le prova con l'ATS prima di salvarle, poi le conserva cifrate e mostra solo un indizio mascherato.
  3. Configura il webhook. Workable e Breezy HR non richiedono nulla: lo registra testee. Per Greenhouse, Teamtailor e Recruitee, aggiungi un webhook nell'ATS con l'indirizzo riportato nella scheda Webhook della connessione e scambia il segreto come indicato nella scheda.
  4. Associa una posizione. La scheda Posizioni elenca le posizioni aperte dell'ATS. Aprine una, scegli il colloquio pubblicato e la fase che invia l'invito, poi salva.
  5. Contrassegna le posizioni a New York City nell'associazione, così gli inviti contengono il tuo avviso ai sensi della Local Law 144 e si aprono 10 giorni lavorativi dopo.
Un collegamento a Workable: le sue impostazioni, il webhook e le posizioni collegate ai colloqui.
Una connessione Workable: le sue impostazioni, la scheda del webhook e le posizioni, ciascuna associata a un colloquio pubblicato.

Cosa succede per ogni candidato

  • Invitato una sola volta, per quante volte l'ATS invii l'evento. Gli eventi relativi a posizioni o fasi non associate vengono ignorati.
  • Campi fissi: email e nome del candidato, posizione e fase, e il riferimento dell'ATS. Non c'è alcuna mappatura da configurare.
  • Risultati come nota: il punteggio di copertura (per la revisione, non una decisione di assunzione), il riepilogo e un link ai risultati. Puoi disattivare la scrittura di ritorno per ogni connessione.
  • Errori: un'interruzione del servizio viene ritentata per circa otto ore; un rifiuto, ad esempio per minuti di colloquio esauriti, compare nel log.
  • Tempo extra per un candidato che lo ha chiesto si imposta nella pagina dell'invito nella dashboard, finché il candidato non inizia.

Con Metti in pausa, inviti e note restano in sospeso finché non riprendi. Se in seguito l'ATS rifiuta la chiave, la connessione mostra Serve ricollegare e le note restano in attesa.

Usa l'API e i webhook per i colloqui con IA

L'API REST pubblica fa ciò che un selezionatore fa nella dashboard: elencare i colloqui pubblicati, creare candidati, invitarli e recuperare i risultati. Il riferimento è nella documentazione dell'API per i colloqui con IA.

Chiavi API

  • Crea una chiave in Integrazioni → Chiavi API. Il segreto (aik_live_…) viene mostrato una sola volta e inviato come bearer token, mai in un URL.
  • Ambiti: dai a ogni chiave solo i permessi che usa il suo sistema, come invitations:write e results:read.
  • Lista di IP consentiti: fino a 50 indirizzi o intervalli, come gli indirizzi in uscita dei tuoi server.
  • Scadenza: 30 giorni, 90 giorni (il valore predefinito), 1 anno, una data fino a 2 anni avanti, oppure mai. L'elenco avvisa 7 giorni prima.
  • Limite di richieste: 120 richieste al minuto per chiave.
La scheda Chiavi API con chiavi attive e revocate, i loro permessi e le regole IP.
La scheda Chiavi API: i permessi e le regole IP di ogni chiave, con le chiavi revocate conservate per traccia.

Invitare un candidato dal tuo sistema

  1. GET /v1/interviews elenca i tuoi colloqui pubblicati.
  2. POST /v1/candidates con nome ed email. Un secondo candidato con la stessa email viene rifiutato, quindi salva l'id.
  3. POST /v1/invitations con entrambi gli id. La risposta contiene il link, mostrato una sola volta; testee lo invia anche via email al candidato.
  4. Invia un header Idempotency-Key a ogni POST. Un nuovo tentativo con la stessa chiave dopo un timeout non crea nulla due volte (le chiavi durano 24 ore).
Campo facoltativo dell'invitoA cosa serve
externalIdIl tuo id (ad esempio quello della candidatura). Viene restituito nell'invito e in ogni webhook
returnUrlAl termine, il candidato vede un pulsante per tornare a questo indirizzo https (non all'interno dell'embed)
extraTimeIl 25, 50 o 100 percento di tempo in più per un candidato che lo ha chiesto; un colloquio dura al massimo 60 minuti, tempo extra incluso. Mai restituito dall'API né inviato nei webhook
nycNoticeIl candidato vive a New York City: l'email contiene il tuo avviso e il colloquio si apre 10 giorni lavorativi dopo
skipSignInIl tuo sito ha già autenticato il candidato: il link da solo apre il colloquio (vedi l'embed)

Webhook

Aggiungi un endpoint in Integrazioni → Webhook: un URL https pubblico e i suoi eventi, cioè invitation.created, invitation.opened, invitation.resent, invitation.revoked, invitation.expired, session.started, session.completed, results.failed, review.decision_changed, candidate.erased e results.ready. I payload contengono solo gli id e il tuo externalId, mai nomi o punteggi; su results.ready, chiama GET /v1/sessions/{id}/results.

  • Verifica ogni firma: un HMAC-SHA256 del timestamp e del body grezzo, con il segreto dell'endpoint come chiave. Confronta in tempo costante e rifiuta i timestamp più vecchi di 5 minuti (codice nella documentazione dei webhook).
  • Rispondi con 2xx entro 10 secondi. Gli errori vengono ritentati con backoff per circa 24 ore.
  • Aspettati ripetizioni e qualsiasi ordine: salta un id evento che hai già gestito e leggi lo stato attuale dall'API.

Incorporare il colloquio nella tua pagina carriere

Incorporare il colloquio nella pagina carriere tiene i candidati sul tuo sito: uno script inserisce il colloquio in un frame e segnala cosa fa il candidato (documentazione dell'embed SDK).

Incorporare il colloquio

  1. Autorizza il tuo sito in Integrazioni → Incorpora: un'origine https senza percorso, fino a 20. Il colloquio non si caricherà in un frame da nessun'altra parte.
  2. Crea l'invito sul tuo server e passa il suo link alla pagina. La chiave API non va mai nella pagina.
  3. Montalo con TesteeEmbed.mount: un contenitore, il link e una funzione onEvent. La scheda Incorpora della dashboard mostra lo snippet.
  4. Gestisci gli eventi: ready, login_required, started, completed, feedback_submitted ed error, ciascuno solo con gli id.

Saltare il codice di accesso

Per impostazione predefinita il candidato accede all'interno del frame con un codice di 6 cifre ricevuto via email; la tua pagina non lo vede mai. Se il tuo sito ha già autenticato il candidato, crea l'invito tramite l'API con skipSignIn e il link da solo apre il colloquio. Dalla dashboard non si può impostare.

  • Il compromesso: il link diventa l'unica chiave, quindi chiunque lo abbia può svolgere il colloquio. Limita la scadenza a uno o due giorni, crea l'invito appena prima che il candidato inizi e mostralo solo dietro il tuo accesso.
  • Agli atti: l'invito mostra «Accesso saltato» e i risultati indicano che l'identità è stata verificata dal sito della tua azienda.

Testa prima di andare live

Un'esecuzione di prova

  1. Usa un candidato di test con un'email che puoi leggere; le anteprime dei membri del team non inviano webhook.
  2. Invia un evento di test del webhook dal menu dell'endpoint: un test.ping firmato, così verifica anche il tuo codice di controllo della firma.
  3. Leggi il log di consegna nella pagina dell'endpoint. Replay invia di nuovo una consegna con lo stesso id, così verifichi che salti le ripetizioni.
  4. Sposta il candidato nella fase associata e controlla la scheda Attività della connessione ATS: ogni evento, invito e nota risulta completato, in nuovo tentativo, non riuscito o ignorato.
  5. Svolgi il colloquio e verifica che results.ready sia arrivato o che la nota sia comparsa nell'ATS. Le soluzioni ai problemi più comuni sono nella documentazione per la risoluzione dei problemi ATS.

Note sulla sicurezza

  • Le chiavi restano sul server, una per sistema, con solo gli ambiti necessari, una lista di IP consentiti e una scadenza. Revoca una chiave se sospetti che sia trapelata.
  • Prima verifica, poi fidati: rifiuta i webhook con firma o timestamp non validi e leggi i dati dall'API.
  • Autorizza solo i tuoi siti per l'embed.
  • I link d'invito sono personali: non registrarli mai nei log e non condividerli, soprattutto con skipSignIn.

Notifiche Slack

In Integrazioni → Slack, collegati con Aggiungi a Slack o con un incoming webhook, scegli quali notifiche pubblicare, ad esempio risultati pronti, e invia un messaggio di prova (documentazione Slack).

Riepilogo

  • Se usi uno dei cinque ATS supportati, usa la connessione nativa: associa ogni posizione e fase a un colloquio pubblicato.
  • Altrimenti, usa l'API con chiavi a permessi limitati e con scadenza e con header Idempotency-Key, e verifica ogni webhook.
  • Per tenere i candidati sul tuo sito, aggiungi l'embed e salta il codice di accesso solo dietro il tuo accesso.
  • Prima di andare live, fai una prova completa con un candidato di test.

Domande e risposte

testee si integra con Greenhouse o Workable?

Sì, in modo nativo, e anche con Teamtailor, Recruitee e Breezy HR. Associ una posizione e una fase a un colloquio pubblicato; ogni candidato spostato in quella fase viene invitato una sola volta e i risultati tornano come nota.

Esiste un'API per i colloqui con IA?

Sì. L'API REST crea candidati e inviti, ne riporta lo stato e restituisce risultati, report PDF ed esportazioni CSV. I webhook firmati avvisano il tuo sistema quando succede qualcosa.

Il mio ATS non è supportato. Posso comunque collegarlo?

Sì, tramite l'API: crea l'invito quando il candidato raggiunge la fase giusta, conserva il tuo externalId nell'invito e recupera i risultati quando arriva results.ready.

I candidati possono svolgere il colloquio nella nostra pagina carriere?

Sì, con l'embed SDK: autorizza il tuo sito in Integrazioni → Incorpora, crea l'invito con l'API e montalo nella tua pagina.

Il risultato fa avanzare i candidati nell'ATS?

No. testee non sposta né scarta mai un candidato. La nota riporta il punteggio di copertura, indicato come supporto alla revisione e non come decisione di assunzione; decide una persona.

Cosa deve contenere una checklist per l'integrazione con l'ATS?

Quali posizioni e fasi inviano inviti, chi gestisce le chiavi, come vengono verificati i webhook, cosa torna all'ATS, come ci si accorge degli errori, come si gestiscono i candidati di New York City e le richieste di accomodamento, e un'esecuzione di prova.

Fonti

  1. Documentazione per sviluppatori di testee: integrazioni ATS
  2. Documentazione per sviluppatori di testee: API REST
  3. Documentazione per sviluppatori di testee: Webhook
  4. Documentazione per sviluppatori di testee: Embed SDK
  5. Documentazione per sviluppatori di testee: Slack
  6. Specifica Standard Webhooks
  7. RFC 2104, HMAC: Keyed-Hashing for Message Authentication

Provalo sultuo prossimo ruolo.

Crea in pochi minuti un colloquio strutturato con IA partendo dalla tua descrizione del lavoro.14 giorni gratis, senza carta.