Saltar para o conteúdo
KendorDocs

Como ligar o Ashby ao Kendor

Para responsáveis ·

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

  1. Abre Integrações na barra lateral, em Organização.
  2. No cartão Ashby, em Acompanhamento de candidatos, escolhe Conectar.
  3. 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 review e Kendor decision existem 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.

Este artigo foi útil?