TalentApproved

3 appels API pour transmettre les scores d'évaluation ATS aux RH et à l'ingénierie

3 appels API pour transmettre les scores d'évaluation ATS aux RH et à l'ingénierie

Privilégiez une API d'évaluation native lorsque votre système de suivi des candidatures en propose une. Dans le cas contraire, revenez à une intégration de système d'enregistrement ou à une API d'évaluation unifiée. Dans tous les cas, prévoyez trois actions essentielles : lister les packages de tests disponibles, déclencher une évaluation pour un candidat et synchroniser les résultats via des webhooks. Des fonctionnalités plus avancées ou l'accès à l'intégration peuvent être réservés à un niveau payant ou partenaire.

En résumé :

  • Les API d'évaluation natives offrent la meilleure expérience aux recruteurs en permettant de filtrer et de classer les candidats sur la base de scores structurés au sein de l'ATS.
  • Lorsqu'aucune API d'évaluation n'est disponible, les intégrations de secours joignent les résultats sous forme de notes ou de fichiers, ce qui limite la possibilité de filtrer ou de trier les résultats des candidats.
  • La séquence d'intégration recommandée consiste à lister les packages, déclencher les évaluations et capturer les résultats via des webhooks, en mettant l'accent sur une identification sécurisée et une gestion correcte des codes de réponse.
  • Les employeurs doivent valider et documenter les outils d'évaluation pour s'assurer de leur équité et de leur conformité légale avant le déploiement, en veillant à ce que les résultats soient stockés avec une piste d'audit et que le consentement soit enregistré.
  • Tester l'intégration de manière approfondie dans un environnement de staging et suivre le bon acheminement des webhooks permet d'éviter les erreurs et les résultats orphelins dans le pipeline de recrutement en production.
Talent Approved
Évaluez les compétences au-delà du CV
Talent Approved aide les employeurs à créer des évaluations de compétences personnalisées, à examiner des résultats structurés et à prendre des décisions de recrutement plus éclairées.
Découvrir Talent Approved

Table des matières

API natives, intégrations de secours et API d'évaluation unifiées

Trois modèles d'intégration couvrent presque toutes les configurations de recrutement, et chacun modifie ce que vos recruteurs voient dans l'ATS.

Une API d'évaluation native est l'option la plus propre. Elle expose les packages de tests, les commandes et les résultats structurés directement dans la fiche ATS, ce qui permet aux recruteurs de filtrer et de classer les candidats par score de la même manière qu'ils filtrent par étape ou par source. La documentation développeur d'Ashby décrit cela comme la forme standard : lister les packages, démarrer une évaluation, écrire les résultats en retour via un webhook.

Lorsque l'ATS ne dispose pas d'endpoints d'évaluation dédiés, les équipes se rabattent sur des écouteurs de changement d'étape et joignent les résultats sous forme de notes, de liens ou de pièces jointes. Cela préserve une couverture de base, mais supprime le scoring structuré, de sorte que les recruteurs perdent la possibilité de trier ou de filtrer par résultat dans l'ATS, comme l'indique le guide d'intégration de Kombo.

Une API d'évaluation unifiée se situe entre les deux. Elle standardise les packages, les webhooks de commandes et l'écriture des résultats sur de nombreuses plateformes ATS à la fois, permettant ainsi à un fournisseur de s'intégrer une seule fois et d'atteindre des dizaines de systèmes plutôt que de construire et de maintenir un connecteur distinct pour chacun, comme décrit dans l'aperçu de l'API d'évaluation unifiée.

  • API native : meilleure expérience recruteur, liée à un seul ATS.
  • Intégration de secours : couverture la plus large, scoring le plus faible dans l'ATS.
  • API unifiée : maintenance à long terme allégée pour les fournisseurs desservant plusieurs ATS.

Construire l'intégration : une liste de contrôle étape par étape

Avant d'écrire la moindre ligne de code, vérifiez que l'ATS expose bien une API d'évaluation et consultez la documentation développeur. De nombreuses plateformes ne publient que des endpoints généraux pour les candidats ou les candidatures, et les traiter comme des endpoints d'évaluation est une erreur précoce courante.

  1. Cartographiez d'abord les identifiants. Utilisez l'ID de candidature ou l'UUID du candidat sur chaque appel afin que les résultats soient associés au bon dossier plutôt que de devenir orphelins, un écueil signalé dans le guide d'intégration de JobCannon.
  2. Choisissez un mode d'authentification. La plupart des plateformes utilisent des clés API, des clés partenaire ou OAuth, et chacune nécessite son propre système de stockage sécurisé et de rotation des clés.
  3. Suivez la séquence d'appels standard. Listez les packages avec assessment.list, déclenchez le test avec assessment.start, puis écoutez le webhook qui se déclenche à la fin et écrivez le résultat en retour.
  4. Gérez les codes de réponse documentés. La référence API Ashby pour assessment.start liste 200, 409 et 422 comme réponses typiques, et votre intégration doit définir un comportement précis pour chacun d'eux.
  5. Définissez votre payload de résultat. Prévoyez les scores globaux, les sous-scores, les horodatages, les pièces jointes et tous les attributs personnalisés sur lesquels votre équipe souhaite filtrer ultérieurement.
  6. Anticipez les limites de débit. Demandez des augmentations de quota avant les périodes de recrutement à fort volume afin qu'une vague d'invitations aux candidats ne génère pas d'erreurs 429 en pleine campagne.

Conseil pro : Stockez l'ID de candidature avec chaque payload entrant et sortant, même dans les journaux, afin qu'un webhook en échec puisse facilement être retracé jusqu'à un candidat précis.

Ce sont les employeurs, et non les fournisseurs, qui portent la responsabilité légale des tests d'emploi. Les directives de l'EEOC sur les tests d'emploi et les procédures de sélection stipulent clairement que les outils de sélection doivent être validés et en lien avec le poste, et que les employeurs restent responsables de l'impact disparate même lorsqu'un tiers a conçu le test. Demandez à tout fournisseur d'évaluation sa documentation de validation avant d'intégrer son outil dans un pipeline de recrutement en production. Notre article sur les directives de tests EEOC détaille les exigences UGESP.

  • Demandez la documentation de validation et d'impact défavorable à tout fournisseur d'évaluation avant le lancement.
  • Stockez les résultats d'évaluation avec une piste d'audit claire et une période de conservation définie, et non indéfiniment.
  • Demandez aux fournisseurs comment ils enregistrent le consentement pour la surveillance par procuration ou par webcam, et si une analyse d'impact sur la protection des données est applicable.
  • Documentez votre examen de validation, effectuez un contrôle pilote d'équité sur les premiers résultats et conservez ces éléments dans vos archives.

Notre guide d'analyse de l'impact défavorable explique comment réaliser cette analyse pilote et ce qu'il faut corriger lorsque les chiffres semblent déséquilibrés.

Choisir entre intégration native, API unifiée et développement sur mesure

Avant d'engager du temps de développement, parcourez une courte liste de contrôle avec vos responsables RH et techniques ensemble.

  • Confirmez quelles fonctionnalités l'ATS prend en charge nativement et lesquelles nécessitent une solution de contournement.
  • Demandez à tout fournisseur d'évaluation s'il prend déjà en charge votre ATS, et si l'intégration partenaire implique des frais ou un abonnement, car certaines plateformes réservent les modules d'intégration aux niveaux supérieurs, selon la comparaison des intégrations de plateformes d'évaluation de Coderbyte.
  • Vérifiez que l'écriture en retour inclut des scores structurés, et pas seulement un lien ou une pièce jointe, afin que les recruteurs puissent filtrer par résultat.
  • Définissez dès le départ les attentes en matière de fiabilité des webhooks et de tentatives de renvoi, et désignez les responsables de la surveillance des deux côtés.
  • Confirmez que le fournisseur peut fournir une documentation de validation, des contrôles anti-triche et un accord de traitement des données.

Conseil pro : Demandez un environnement sandbox avant de signer quoi que ce soit. Un fournisseur incapable de démontrer le déclenchement d'un webhook de test de bout en bout n'est pas prêt pour votre pipeline de production.

Tester l'intégration de bout en bout et détecter les défaillances en amont

Un environnement de staging doit simuler le cycle de vie complet avant qu'un vrai candidat y soit confronté : créer une commande de test, déclencher le webhook manuellement et confirmer que le résultat s'affiche correctement dans l'interface ATS, et pas seulement dans un enregistrement de base de données.

  1. Effectuez des tests en staging couvrant la liste des packages, la création de commandes et l'écriture des résultats en retour sur des données d'exemple réalistes.
  2. Suivez les taux de succès des webhooks et les tendances d'erreurs, et créez un rapport de rapprochement qui signale les résultats orphelins avant qu'ils ne s'accumulent.
  3. Utilisez des identifiants de corrélation sur chaque requête afin qu'un ticket de support puisse être retracé dans les deux systèmes en quelques minutes, et non en quelques heures.
  4. Créez une logique de réessai idempotente afin qu'un webhook renvoyé ne crée jamais un résultat en double, et gardez un script de rétroalimentation prêt pour tout événement manqué.
  5. Rédigez un court guide opérationnel indiquant qui est alerté en cas d'échec d'un webhook et comment relancer en toute sécurité une commande bloquée.

La place de Talent Approved dans une intégration ATS

La plateforme Talent Approved comprend une fonctionnalité qui génère des évaluations spécifiques au poste à partir de descriptions de postes ou de listes de compétences, accompagnée d'une surveillance anti-triche et de résumés générés par IA qui accélèrent l'examen. Du côté de l'intégration, Talent Approved suit le même cycle de vie de liste, déclenchement et écriture en retour décrit ci-dessus, et le mappage de l'ID de candidature ou de l'UUID du candidat sur chaque appel garantit que les résultats sont correctement associés au bon dossier ATS. Le modèle tarifaire est à l'usage, avec des frais de 5 $ par candidat ayant complété l'évaluation, sans abonnement requis. Les équipes mettant en œuvre l'intégration peuvent également consulter notre guide sur le fonctionnement des évaluations instantanées ainsi que nos ressources de conformité EEOC pour les détails de mise en œuvre et de validation.

La place de Talent Approved dans une intégration ATS — schéma de présentation

Ce que les équipes RH font mal dans l'intégration ATS

Ce que les équipes RH font mal dans l'intégration ATS — schéma de présentation

La plupart des équipes traitent toutes les API ATS de la même façon, puis sont surprises de constater que leur « intégration d'évaluation » n'est en réalité qu'un écouteur de changement d'étape sans scoring structuré. La solution ne réside pas dans davantage d'heures de développement. Il s'agit de vérifier, dès le premier jour, si une véritable API d'évaluation existe.

Commencez par un petit pilote sur un seul poste ouvert avant de toucher à l'ensemble de votre pipeline de recrutement. Observez deux choses simultanément : si les recruteurs utilisent réellement le filtrage par score, et si les premiers résultats révèlent un écart d'équité entre les groupes de candidats. Lorsqu'une API d'évaluation native ou une API unifiée éprouvée est disponible, choisissez-la. L'expérience recruteur et la défendabilité juridique dépendent toutes deux de résultats structurés et filtrables, et non d'une solution de contournement greffée sur une API générique.

— Jimmie

Documentation développeur et ressources de conformité à mettre en favoris

Gardez à portée de main la documentation d'intégration des évaluations Ashby, l'aperçu de l'API d'évaluation unifiée et les directives de test de l'EEOC. Pour le support technique du côté de l'intégration, des entreprises comme Ampersand sont spécialisées dans la mise en œuvre d'API et de webhooks.

Sources

FAQ

Que signifie l'intégration ATS ?

L'intégration ATS consiste à connecter un système de suivi des candidatures à un autre outil, comme une plateforme d'évaluation, afin que les données circulent automatiquement entre eux sans être copiées manuellement. Pour les évaluations en particulier, cela signifie lister les packages de tests, déclencher un test pour un candidat et écrire le score en retour dans le dossier ATS du candidat.

Quels sont les principaux systèmes ATS ?

Il n'existe pas de classement officiel unique des meilleures plateformes ATS, et le bon choix dépend de la taille de l'entreprise, du volume de recrutement et des intégrations requises. Plutôt que de nommer des fournisseurs spécifiques, les équipes RH devraient évaluer tout ATS en vérifiant s'il expose une API d'évaluation documentée, comme décrit dans la documentation développeur d'Ashby, plutôt que de s'appuyer sur des listes de popularité générale.

Quelle est la différence entre un ATS et un CRM ?

Un ATS gère le workflow de recrutement pour les postes ouverts, en suivant les candidats de la candidature à l'offre. Un CRM de recrutement gère quant à lui les relations à long terme avec les candidats potentiels, y compris les personnes qui ne postulent pas activement, ce qui est une mission différente du suivi des candidats actifs dans un pipeline.

Que signifie ATS ?

ATS signifie système de suivi des candidatures (applicant tracking system), le logiciel utilisé par les équipes RH pour publier des offres d'emploi, collecter des candidatures et faire progresser les candidats à travers les étapes du recrutement. Lorsqu'il prend en charge une API d'évaluation dédiée, il peut également déclencher des tests de compétences et recevoir des résultats structurés directement sur le dossier du candidat, conformément au cycle de vie d'intégration décrit dans la référence API d'Ashby.