Saltar para o conteúdo
KendorDocs

A integração com o Ashby não envia triagens nem escreve resultados

Para responsáveis ·

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.

  1. 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.
  2. 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.
  3. O Kendor deixou uma nota no Ashby? Olha para as notas do candidato. Uma nota que começa por Kendor: no invite sent indica o motivo.
  4. 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.

Este artigo foi útil?