Vai al contenuto
KendorDocs

Come collegare Ashby a Kendor

Per i proprietari ·

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

  1. Apri Integrazioni nella barra laterale, sotto Organizzazione.
  2. Nella scheda Ashby in Gestione candidature, scegli Collega.
  3. 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 review e Kendor decision esistono 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.

Poi, scegli quali fasi inviano una prova.

Questo articolo ti è stato utile?