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.
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 nativa | API pubblica e webhook | Embed SDK (con l'API) | |
|---|---|---|---|
| Ideale per | Team che usano uno dei cinque ATS supportati | Qualsiasi altro ATS o un tuo flusso di lavoro | Una pagina carriere o un portale che gestisci tu |
| Codice necessario | Nessuno | Chiamate API e un ricevitore di webhook | Poche righe nella pagina, più l'API |
| Cosa invia l'invito | Lo spostamento di un candidato nella fase associata | La tua chiamata API | La tua chiamata API; il link viene montato nella tua pagina |
| I risultati tornano come | Una nota sul candidato nell'ATS | Risultati che recuperi dopo il webhook dei risultati | Lo 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
- Pubblica il colloquio. Solo un colloquio pubblicato può essere associato a una posizione.
- 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.
- 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.
- 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.
- 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.


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.


Invitare un candidato dal tuo sistema
- GET /v1/interviews elenca i tuoi colloqui pubblicati.
- POST /v1/candidates con nome ed email. Un secondo candidato con la stessa email viene rifiutato, quindi salva l'id.
- POST /v1/invitations con entrambi gli id. La risposta contiene il link, mostrato una sola volta; testee lo invia anche via email al candidato.
- 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'invito | A cosa serve |
|---|---|
| externalId | Il tuo id (ad esempio quello della candidatura). Viene restituito nell'invito e in ogni webhook |
| returnUrl | Al termine, il candidato vede un pulsante per tornare a questo indirizzo https (non all'interno dell'embed) |
| extraTime | Il 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 |
| nycNotice | Il candidato vive a New York City: l'email contiene il tuo avviso e il colloquio si apre 10 giorni lavorativi dopo |
| skipSignIn | Il 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
- 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.
- Crea l'invito sul tuo server e passa il suo link alla pagina. La chiave API non va mai nella pagina.
- Montalo con TesteeEmbed.mount: un contenitore, il link e una funzione onEvent. La scheda Incorpora della dashboard mostra lo snippet.
- 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
- Usa un candidato di test con un'email che puoi leggere; le anteprime dei membri del team non inviano webhook.
- 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.
- 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.
- 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.
- 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
- Documentazione per sviluppatori di testee: integrazioni ATS
- Documentazione per sviluppatori di testee: API REST
- Documentazione per sviluppatori di testee: Webhook
- Documentazione per sviluppatori di testee: Embed SDK
- Documentazione per sviluppatori di testee: Slack
- Specifica Standard Webhooks
- RFC 2104, HMAC: Keyed-Hashing for Message Authentication