Comment connecter Ashby à Kendor
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
- Ouvrez Intégrations dans la barre latérale, sous Organisation.
- Sur la carte Ashby dans Suivi des candidatures, choisissez Connecter.
- 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 reviewetKendor decisionexistent 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.