Como ligar o Ashby ao Kendor
Cria uma chave de API do Ashby com as permissões que o Kendor indica, cola-a em Integrações, e o Kendor configura o webhook e os respetivos campos sempre que a chave o permitir.
Ligas o Ashby com uma única chave de API. Cria a chave no Ashby, cola-a em Integrações → Ashby no Kendor, e o Kendor verifica as permissões, regista o webhook e cria os seus campos na candidatura, na medida em que a chave o permitir. Uma lista de verificação mostra depois o que está feito e o que, se for o caso, falta fazer à mão no Ashby.
Antes de começares
- A tua organização está no plano Kendor, que inclui a integração com o Ashby, e já ativámos a integração contigo.
- És Responsável no Kendor. Os editores e os observadores veem o cartão do Ashby com Só os proprietários podem gerir o Ashby.
- Podes criar chaves de API nas definições de administração do Ashby.
Cria uma chave de API no Ashby
No Ashby, abre Admin → API keys e cria uma chave para o Kendor. O Kendor lista as permissões de que precisa na página do Ashby, em 1 · Crie uma chave de API no Ashby.
Obrigatórias
| Permissão no Kendor | Âmbito no Ashby | Para que o Kendor a usa |
|---|---|---|
| Ler chaves de API | apiKeys:read |
Verifica que permissões a chave tem. |
| Ler vagas | jobs:read |
Lista as tuas vagas quando defines regras de etapa. |
| Ler entrevistas | interviews:read |
Lê o plano de entrevistas de cada vaga e as respetivas etapas. |
| Ler metadados do processo de contratação | hiringProcessMetadata:read |
Lê as etapas e os campos da candidatura. |
| Escrever candidatos | candidates:write |
Escreve os campos e as notas do Kendor. |
Para o Kendor se configurar sozinho
| Permissão no Kendor | Âmbito no Ashby | Para que o Kendor a usa |
|---|---|---|
| Escrever chaves de API | apiKeys:write |
Regista o webhook por ti. |
| Escrever metadados do processo de contratação | hiringProcessMetadata:write |
Cria por ti os cinco campos do Kendor. |
Estas duas são opcionais. Sem elas, adicionas tu o webhook e os cinco campos no Ashby, e o Kendor mostra-te exatamente o que introduzir.
Cola a chave no Kendor
- Abre Integrações na barra lateral, em Organização.
- No cartão Ashby, em Acompanhamento de candidatos, escolhe Conectar.
- Em 2 · Cole a sua chave de API do Ashby, cola a chave em Chave de API da Ashby e escolhe Conectar.
O Kendor pergunta ao Ashby que permissões a chave tem, depois regista o webhook e encontra ou cria os seus campos. Se o Ashby recusar a chave, o motivo aparece por baixo do campo, por exemplo Ashby rejected the API key.
A chave é guardada encriptada. Depois, o Kendor só mostra os últimos quatro carateres: Ligado com a chave terminada em 1234.
Verifica a lista de configuração
A secção Configuração tem três linhas. Um visto significa que a linha está concluída.
- Permissões da chave: todas as permissões obrigatórias estão na chave. Se faltar alguma, o Kendor nomeia-as. Adiciona-as à chave no Ashby e depois escolhe Verificar de novo.
- Webhook: o Ashby avisa o Kendor quando uma candidatura muda de etapa.
- Campos do Kendor nas candidaturas: os cinco campos
Kendor status,Kendor result,Kendor score,Kendor revieweKendor decisionexistem em Application no Ashby.
O estado no topo mostra Ligado quando tudo está no sítio e Requer atenção quando algo não está.
Adicionar o webhook à mão
Se a chave não puder escrever chaves de API, a linha Webhook mostra um URL do webhook e um Token secreto para copiar. No Ashby, abre Admin → Webhooks e adiciona um webhook do tipo Candidate stage change com esse URL e esse segredo. Usa Mostrar segredo para ver o token completo.
Cada organização tem o seu próprio URL e segredo de webhook. O Ashby assina cada pedido com o segredo, e o Kendor rejeita qualquer pedido cuja assinatura não corresponda.
Criar os campos à mão
Se a chave não puder escrever metadados do processo de contratação, cria os campos em falta no Ashby em Admin → Custom fields, em Application, com estes nomes e tipos exatos:
| Nome do campo | Tipo |
|---|---|
Kendor status |
String |
Kendor result |
String |
Kendor score |
Number |
Kendor review |
URL |
Kendor decision |
String |
O Kendor encontra-os pelo nome, ignorando maiúsculas e minúsculas. Escolhe Verificar de novo quando existirem. Os campos em falta são simplesmente ignorados quando o Kendor escreve resultados.
Dica. Verificar de novo volta a ler as permissões da chave e repete qualquer configuração que a chave agora permita. Usa-o sempre que alterares as permissões da chave no Ashby.
Substituir ou desligar a chave
- Substituir chave troca por uma chave nova com as mesmas permissões. A chave antiga deixa de ser usada de imediato. O URL e o segredo do webhook mantêm-se, por isso um webhook que tenhas adicionado à mão continua a funcionar.
- Desconectar remove a chave, as tuas regras de etapa e o webhook que o Kendor registou, e o Kendor deixa de escrever no Ashby. Um webhook que tenhas adicionado à mão fica no Ashby até o apagares lá. Os convites já enviados continuam válidos.
Se te ligares de novo depois de desligares, o Kendor emite um novo URL e segredo de webhook, por isso atualiza qualquer webhook que tenhas adicionado à mão.
A seguir, escolhe que etapas enviam uma triagem.