Aller au contenu
KendorDocs

Comment connecter Ashby à Kendor

Pour les propriétaires ·

Créez une clé d'API Ashby avec les autorisations listées par Kendor, collez-la sous Intégrations, et Kendor configure le webhook et ses champs là où la clé le permet.

Vous connectez Ashby avec une seule clé d'API. Créez la clé dans Ashby, collez-la dans Intégrations → Ashby dans Kendor, et Kendor vérifie ses autorisations, enregistre le webhook et crée ses champs sur la candidature, dans la mesure où la clé le permet. Une liste de contrôle indique ensuite ce qui est fait et, le cas échéant, ce qu'il reste à faire à la main dans Ashby.

Avant de commencer

  • Votre organisation est sur l'offre Kendor, qui inclut l'intégration Ashby, et nous avons activé l'intégration avec vous.
  • Vous êtes Propriétaire dans Kendor. Les éditeurs et les lecteurs voient la carte Ashby avec Seuls les propriétaires peuvent gérer Ashby.
  • Vous pouvez créer des clés d'API dans les paramètres d'administration d'Ashby.

Créer une clé d'API dans Ashby

Dans Ashby, ouvrez Admin → API keys et créez une clé pour Kendor. Kendor liste les autorisations dont il a besoin sur la page Ashby, sous 1 · Créez une clé d'API dans Ashby.

Obligatoires

Autorisation dans Kendor Scope Ashby Ce que Kendor en fait
Lire les clés d'API apiKeys:read Vérifie les autorisations dont dispose la clé.
Lire les postes jobs:read Liste vos postes quand vous configurez les règles d'étape.
Lire les entretiens interviews:read Lit le plan d'entretiens de chaque poste et ses étapes.
Lire les métadonnées du processus de recrutement hiringProcessMetadata:read Lit les étapes et les champs des candidatures.
Écrire les candidats candidates:write Écrit les champs et les notes de Kendor.

Pour que Kendor se configure tout seul

Autorisation dans Kendor Scope Ashby Ce que Kendor en fait
Écrire les clés d'API apiKeys:write Enregistre le webhook pour vous.
Écrire les métadonnées du processus de recrutement hiringProcessMetadata:write Crée pour vous les cinq champs Kendor.

Ces deux autorisations sont facultatives. Sans elles, vous ajoutez vous-même le webhook et les cinq champs dans Ashby, et Kendor vous indique exactement quoi saisir.

Coller la clé dans Kendor

  1. Ouvrez Intégrations dans la barre latérale, sous Organisation.
  2. Sur la carte Ashby dans Suivi des candidatures, choisissez Connecter.
  3. Sous 2 · Collez votre clé d'API Ashby, collez la clé dans Clé d'API Ashby et choisissez Connecter.

Kendor demande à Ashby quelles autorisations a la clé, puis enregistre le webhook et trouve ou crée ses champs. Si Ashby refuse la clé, la raison s'affiche sous le champ, par exemple Ashby rejected the API key.

La clé est stockée chiffrée. Ensuite, Kendor n'en affiche que les quatre derniers caractères : Connecté avec la clé se terminant par 1234.

Consulter la liste de configuration

La section Configuration comporte trois lignes. Une coche signifie que la ligne est terminée.

  • Autorisations de la clé : toutes les autorisations obligatoires sont sur la clé. S'il en manque, Kendor les nomme. Ajoutez-les à la clé dans Ashby, puis choisissez Vérifier à nouveau.
  • Webhook : Ashby prévient Kendor quand une candidature change d'étape.
  • Champs Kendor sur les candidatures : les cinq champs Kendor status, Kendor result, Kendor score, Kendor review et Kendor decision existent sur Application dans Ashby.

Le statut en haut indique Connecté quand tout est en place, et À traiter quand quelque chose ne l'est pas.

Ajouter le webhook à la main

Si la clé ne peut pas écrire les clés d'API, la ligne Webhook affiche une URL du webhook et un Jeton secret à copier. Dans Ashby, ouvrez Admin → Webhooks et ajoutez un webhook de type Candidate stage change avec cette URL et ce secret. Utilisez Afficher le secret pour voir le jeton complet.

Chaque organisation a sa propre URL de webhook et son propre secret. Ashby signe chaque requête avec le secret, et Kendor rejette toute requête dont la signature ne correspond pas.

Créer les champs à la main

Si la clé ne peut pas écrire les métadonnées du processus de recrutement, créez les champs manquants dans Ashby sous Admin → Custom fields, sur Application, avec exactement ces noms et ces types :

Nom du champ Type
Kendor status String
Kendor result String
Kendor score Number
Kendor review URL
Kendor decision String

Kendor les retrouve par leur nom, sans tenir compte de la casse. Choisissez Vérifier à nouveau une fois qu'ils existent. Les champs manquants sont simplement ignorés quand Kendor écrit les résultats.

Astuce. Vérifier à nouveau relit les autorisations de la clé et refait toute configuration que la clé permet désormais. Utilisez-le chaque fois que vous modifiez les autorisations de la clé dans Ashby.

Remplacer ou déconnecter la clé

  • Remplacer la clé met en place une nouvelle clé avec les mêmes autorisations. L'ancienne clé cesse immédiatement d'être utilisée. L'URL et le secret du webhook restent les mêmes : un webhook ajouté à la main continue donc de fonctionner.
  • Déconnecter supprime la clé, vos règles d'étape et le webhook enregistré par Kendor, et Kendor cesse d'écrire dans Ashby. Un webhook ajouté à la main reste dans Ashby jusqu'à ce que vous l'y supprimiez. Les invitations déjà envoyées restent valables.

Si vous vous reconnectez après une déconnexion, Kendor émet une nouvelle URL et un nouveau secret de webhook : mettez donc à jour tout webhook ajouté à la main.

Ensuite, choisissez les étapes qui envoient une épreuve.

Cet article vous a-t-il aidé ?