Come collegare Ashby a Kendor
Crea una chiave API di Ashby con i permessi elencati da Kendor, incollala in Integrazioni e Kendor configura il webhook e i suoi campi dove la chiave lo consente.
Colleghi Ashby con una sola chiave API. Crea la chiave in Ashby, incollala in Integrazioni → Ashby in Kendor, e Kendor ne controlla i permessi, registra il webhook e crea i propri campi sulla candidatura, per quanto la chiave lo consente. Una checklist mostra poi cosa è fatto e cosa, eventualmente, resta da fare a mano in Ashby.
Prima di iniziare
- La tua organizzazione ha il piano Kendor, che include l'integrazione con Ashby, e abbiamo attivato l'integrazione insieme a te.
- Sei un Proprietario in Kendor. Editor e visualizzatori vedono la scheda di Ashby con la scritta Solo i proprietari possono gestire Ashby.
- Puoi creare chiavi API nelle impostazioni di amministrazione di Ashby.
Crea una chiave API in Ashby
In Ashby apri Admin → API keys e crea una chiave per Kendor. Kendor elenca i permessi di cui ha bisogno nella pagina di Ashby, sotto 1 · Crea una chiave API in Ashby.
Obbligatori
| Permesso in Kendor | Scope di Ashby | A cosa serve a Kendor |
|---|---|---|
| Leggere chiavi API | apiKeys:read |
Controlla quali permessi ha la chiave. |
| Leggere posizioni | jobs:read |
Elenca le tue posizioni quando imposti le regole di fase. |
| Leggere colloqui | interviews:read |
Legge il piano di colloqui di ogni posizione e le sue fasi. |
| Leggere i metadati del processo di assunzione | hiringProcessMetadata:read |
Legge le fasi e i campi delle candidature. |
| Scrivere candidati | candidates:write |
Scrive i campi e le note di Kendor. |
Per far sì che Kendor si configuri da solo
| Permesso in Kendor | Scope di Ashby | A cosa serve a Kendor |
|---|---|---|
| Scrivere chiavi API | apiKeys:write |
Registra il webhook per te. |
| Scrivere i metadati del processo di assunzione | hiringProcessMetadata:write |
Crea per te i cinque campi Kendor. |
Questi due sono facoltativi. Senza di essi aggiungi tu in Ashby il webhook e i cinque campi, e Kendor ti mostra esattamente cosa inserire.
Incolla la chiave in Kendor
- Apri Integrazioni nella barra laterale, sotto Organizzazione.
- Nella scheda Ashby in Gestione candidature, scegli Collega.
- Sotto 2 · Incolla la tua chiave API di Ashby, incolla la chiave in Chiave API di Ashby e scegli Collega.
Kendor chiede ad Ashby quali permessi ha la chiave, poi registra il webhook e trova o crea i propri campi. Se Ashby rifiuta la chiave, il motivo compare sotto il campo, per esempio Ashby rejected the API key.
La chiave è salvata cifrata. In seguito Kendor ne mostra solo gli ultimi quattro caratteri: Collegato con la chiave che termina con 1234.
Controlla l'elenco di configurazione
La sezione Configurazione ha tre righe. Una spunta indica che la riga è completata.
- Permessi della chiave: tutti i permessi obbligatori sono presenti sulla chiave. Se ne manca qualcuno, Kendor lo indica per nome. Aggiungili alla chiave in Ashby, poi scegli Controlla di nuovo.
- Webhook: Ashby avvisa Kendor quando una candidatura cambia fase.
- Campi Kendor sulle candidature: i cinque campi
Kendor status,Kendor result,Kendor score,Kendor revieweKendor decisionesistono su Application in Ashby.
Lo stato in alto riporta Connesso quando tutto è a posto, e Richiede attenzione quando qualcosa non lo è.
Aggiungi il webhook a mano
Se la chiave non può scrivere chiavi API, la riga Webhook mostra un URL del webhook e un Token segreto da copiare. In Ashby apri Admin → Webhooks e aggiungi un webhook di tipo Candidate stage change con quell'URL e quel secret. Usa Mostra segreto per vedere il token completo.
Ogni organizzazione ha il proprio URL e il proprio secret del webhook. Ashby firma ogni richiesta con il secret, e Kendor rifiuta qualsiasi richiesta la cui firma non corrisponda.
Crea i campi a mano
Se la chiave non può scrivere i metadati del processo di assunzione, crea i campi mancanti in Ashby sotto Admin → Custom fields, su Application, con questi nomi e tipi esatti:
| Nome del campo | Tipo |
|---|---|
Kendor status |
String |
Kendor result |
String |
Kendor score |
Number |
Kendor review |
URL |
Kendor decision |
String |
Kendor li trova per nome, senza distinguere maiuscole e minuscole. Scegli Controlla di nuovo quando esistono. I campi mancanti vengono semplicemente saltati quando Kendor scrive i risultati.
Suggerimento. Controlla di nuovo rilegge i permessi della chiave e rifà ogni configurazione che la chiave ora consente. Usalo ogni volta che cambi i permessi della chiave in Ashby.
Sostituisci o scollega la chiave
- Sostituisci chiave inserisce una nuova chiave con gli stessi permessi. La vecchia chiave smette di essere usata subito. L'URL e il secret del webhook restano uguali, quindi un webhook aggiunto a mano continua a funzionare.
- Scollega rimuove la chiave, le tue regole di fase e il webhook registrato da Kendor, e Kendor smette di scrivere in Ashby. Un webhook aggiunto a mano resta in Ashby finché non lo elimini lì. Gli inviti già inviati restano validi.
Se ti ricolleghi dopo aver scollegato, Kendor emette un nuovo URL e un nuovo secret per il webhook, quindi aggiorna qualsiasi webhook aggiunto a mano.