A integração com o Ashby não envia triagens nem escreve resultados
Resolve os problemas comuns do Ashby, desde uma assinatura de webhook rejeitada ou permissões de chave em falta até candidatos sem email e escritas falhadas.
A maioria dos problemas do Ashby aparece em dois sítios no Kendor: a lista de verificação Configuração e Convites recentes da Ashby, ambas na página do Ashby em Integrações. Quando algo precisa de ser corrigido, o cartão do Ashby nomeia o primeiro problema e oferece Concluir configuração, e a página do Ashby mostra Requer atenção. Começa por aí, corrige no Ashby e escolhe Verificar de novo.
O que o cartão te está a dizer
| Mensagem | O que significa | Solução |
|---|---|---|
| Faltam permissões à chave | À chave de API falta uma ou mais permissões obrigatórias. | Edita a chave no Ashby em Admin → API keys, adiciona as permissões listadas em Permissões da chave e escolhe Verificar de novo. |
| Webhook não registado | O Kendor não conseguiu adicionar o webhook, normalmente porque a chave não pode escrever chaves de API. | Adiciona-o à mão: vê Adicionar o webhook à mão. |
| Campos do Kendor em falta no Ashby | Um ou mais dos cinco campos não existem em Application. | Cria-os com os nomes exatos, ou dá à chave Escrever metadados do processo de contratação e escolhe Verificar de novo. |
| Não foi possível escrever um resultado no Ashby | Uma escrita recente numa candidatura falhou. | Vê Escritas falhadas abaixo. |
O candidato entrou na etapa mas não recebeu convite
Percorre estes pontos por ordem.
- Existe uma regra correspondente? Verifica Etapas que enviam uma avaliação ou uma entrevista de live coding. Uma regra de uma vaga tem de nomear essa vaga e essa etapa exatas. Uma regra de qualquer vaga corresponde ao nome da etapa em qualquer vaga.
- O webhook está no sítio? A linha Webhook em Configuração deve ter um visto. Se o adicionaste à mão, verifica que o tipo é Candidate stage change e que o URL e o segredo correspondem ao que o Kendor mostra.
- O Kendor deixou uma nota no Ashby? Olha para as notas do candidato. Uma nota que começa por
Kendor: no invite sentindica o motivo. - A candidatura já tinha sido convidada a partir desta etapa? Cada candidatura recebe um convite por etapa. Movê-la para fora e de volta não envia outro. Usa antes Enviar lembrete no candidato no Kendor.
Notas que o Kendor deixa em vez de um convite
| Nota | Solução |
|---|---|
Kendor: no invite sent, because this candidate has no email address in Ashby. |
Adiciona um email ao candidato no Ashby e depois move a candidatura para a etapa outra vez. |
Kendor: no invite sent. Email must belong to the … domain |
A triagem tem uma Lista de domínios de email permitidos e o email do candidato está fora dela. Altera o Domínio de email permitido nas definições da triagem, ou corrige o email no Ashby, e depois move a candidatura para a etapa outra vez. |
Kendor: no invite sent. This candidate has already completed the screen; … |
Ativa Permitir novo convite após conclusão na triagem e depois move a candidatura para a etapa outra vez. |
Kendor: no invite sent. Candidates can only be invited to a live screen. … |
Põe a triagem disponível e depois move a candidatura para a etapa outra vez. |
Quando nenhum convite foi enviado, nada fica registado para essa etapa, por isso mover a candidatura para lá outra vez tenta de novo.
Falhas na assinatura do webhook
O Ashby assina cada mudança de etapa com o segredo do teu webhook, e o Kendor verifica a assinatura antes de fazer o que quer que seja. Um pedido com uma assinatura em falta ou errada é rejeitado com 401 Unauthorized, e nenhum convite é enviado.
Isto costuma significar que o segredo no Ashby não corresponde ao do Kendor. Na página do Ashby no Kendor, escolhe Mostrar segredo na linha Webhook, copia o Token secreto e cola-o no webhook no Ashby.
Um pedido para um URL de webhook que o Kendor não reconhece é rejeitado com 404. Isso acontece depois de desconectares: o URL antigo deixa de funcionar, e ligar de novo emite um novo URL e segredo. Atualiza ou remove qualquer webhook que tenhas adicionado à mão.
Entregas duplicadas
Se o Ashby entregar a mesma mudança de etapa mais do que uma vez, o Kendor envia um convite e ignora as repetições, mesmo quando chegam no mesmo instante. Não tens de fazer nada.
Escritas falhadas
Quando o Kendor não consegue escrever numa candidatura, por exemplo porque o Ashby rejeitou a chave ou não foi possível contactá-lo, o convite mostra Ainda não escrito; tentando de novo em Convites recentes da Ashby. Passa o rato por cima para ver o motivo do Ashby.
- O Kendor repete a cada 10 minutos durante um dia a partir da primeira falha.
- Passado um dia, deixa de repetir esse convite. A alteração seguinte à tentativa, como uma submissão ou uma decisão, volta a escrever tudo.
Se o motivo for sobre a chave, substitui-a com Substituir chave usando uma chave com as mesmas permissões, ou corrige as permissões e escolhe Verificar de novo.
O Ashby rejeita a chave ao ligar
Se Conectar ou Substituir chave mostrar Ashby rejected the API key, a chave está errada, foi revogada ou foi desativada no Ashby. Cria uma chave nova e cola-a outra vez. Could not reach Ashby significa que o pedido não chegou; tenta de novo daqui a pouco.
Depois de desconectar
Desconectar remove a chave, todas as regras de etapa e o webhook que o Kendor registou. As novas mudanças de etapa não enviam nada. Os convites já enviados continuam válidos, mas o seu progresso deixa de ser escrito no Ashby.
Nota. Só os Responsáveis podem ver e alterar a ligação ao Ashby. Os editores e os observadores veem Só os proprietários podem gerir o Ashby.