Teamtailor + n8n : automatiser la présélection des candidats

Teamtailor + n8n : ce que change vraiment l'automatisation de la présélection

Automatiser la présélection avec Teamtailor et n8n consiste à connecter le webhook déclenché par une candidature à un workflow n8n qui extrait le CV, le fait scorer par un modèle d'IA au regard de la fiche de poste, puis renvoie automatiquement le résultat dans Teamtailor — étape mise à jour, note interne ou tag de score. Le recruteur retrouve une shortlist déjà triée, sans avoir rouvert l'ATS pour chaque dossier.

Ce n'est pas une fonctionnalité que Teamtailor vend sur étagère. L'éditeur a construit son écosystème autour d'une API JSON:API ouverte et de webhooks configurables, mais ne publie aucun connecteur natif vers n8n. L'intégration se monte avec les nœuds génériques Webhook et HTTP Request de n8n, pas avec un plugin clé en main.

« La vraie valeur de ce type de workflow n'est pas de remplacer le recruteur, mais de lui livrer une présélection déjà triée et justifiée, prête à valider en quelques minutes plutôt qu'en plusieurs heures », résume Anas Rabhi, fondateur de Profilya. Pour une vue d'ensemble des cas d'usage au-delà de Teamtailor, notre guide sur l'automatisation du recrutement avec l'IA détaille l'ensemble de la chaîne, du sourcing à l'onboarding.

Ce que permet réellement l'API Teamtailor (et ses limites)

L'API Teamtailor suit la spécification JSON:API. Chaque requête doit porter un header d'authentification (Authorization: Bearer … pour l'API Partner, ou un token classique pour l'API standard) et un header X-Api-Version qui fixe la version de schéma utilisée — une omission qui casse silencieusement l'intégration en cas de montée de version côté éditeur.

Trois endpoints suffisent pour la plupart des workflows de présélection : POST /v1/candidates pour créer un profil, GET /v1/candidates/{id} pour récupérer son dossier complet (CV, réponses au formulaire, pièces jointes), et PATCH /v1/candidates/{id} pour le mettre à jour. L'accès aux données de candidats exige une clé avec un scope admin : une clé aux droits restreints échoue silencieusement sur ces routes.

Côté événements, les Company Webhooks de Teamtailor permettent de s'abonner à la création d'une candidature, à la mise à jour d'un profil ou au changement d'étape dans un pipeline. Chaque envoi est signé via un header Teamtailor-Signature (HMAC), à vérifier impérativement avant de traiter le payload — sans quoi n'importe qui connaissant l'URL du webhook pourrait injecter de faux événements.

La documentation technique complète (schémas de ressources, versions d'API, exemples de requêtes) est disponible sur docs.teamtailor.com. C'est un passage obligé avant de câbler le moindre nœud HTTP Request : les noms de champs et les relations JSON:API ne sont pas toujours intuitifs.

Architecture technique : du webhook Teamtailor au scoring IA dans n8n

Le workflow type s'articule en sept étapes, chacune portée par un nœud n8n distinct. Voici l'architecture que nous mettons en place pour ce cas d'usage :

Le point de vigilance est l'étape 6 : le workflow propose un rejet, il ne le prononce jamais seul. C'est ce qui distingue une aide à la présélection d'une décision automatisée au sens du RGPD — nous y revenons plus loin. Pour un panorama des workflows n8n appliqués aux RH au-delà du seul cas Teamtailor, voir notre article sur n8n pour automatiser les processus RH.

Étapes concrètes pour connecter Teamtailor et n8n

Voici la séquence de mise en œuvre que nous suivons pour déployer ce type d'intégration :

1. Générer une clé API Teamtailor : dans les paramètres du compte, section API/intégrations, avec le scope admin nécessaire pour lire et modifier les dossiers candidats.
2. Créer un Company Webhook : choisir l'événement déclencheur (candidature créée, étape modifiée) et pointer vers l'URL de production du workflow n8n.
3. Ajouter un nœud Webhook dans n8n : récupérer l'URL de test, la coller côté Teamtailor, puis basculer en URL de production une fois le workflow validé.
4. Vérifier la signature HMAC : un nœud Code recalcule la signature à partir du secret partagé et du corps brut de la requête, avant tout traitement du payload.
5. Récupérer le dossier complet : un nœud HTTP Request appelle GET /v1/candidates/{id} avec les headers Bearer et X-Api-Version corrects.
6. Scorer avec un agent IA : transmettre le CV extrait et la fiche de poste à un modèle de langage, avec une consigne stricte de sortie structurée (score, points forts, points d'alerte).
7. Router la décision : un nœud IF sépare les scores selon des seuils définis avec l'équipe recrutement, jamais fixés arbitrairement par le développeur du workflow.
8. Renvoyer le résultat dans Teamtailor : un nœud HTTP Request en PATCH met à jour l'étape ou ajoute une note visible par le recruteur, qui garde la main sur la décision finale.

Chaque étape gagne à être testée isolément sur des candidatures réelles avant d'activer le webhook en production — les formats de CV et les réponses libres des candidats révèlent toujours des cas que la documentation ne couvre pas.

Limites et bonnes pratiques pour fiabiliser le workflow

Un workflow Teamtailor + n8n qui fonctionne en démonstration n'est pas encore un workflow fiable en production. Quelques points cassent régulièrement les intégrations mal préparées :

• -- Rupture de version d'API : une montée de version côté Teamtailor sans mise à jour du header X-Api-Version peut renvoyer un format de réponse différent, silencieusement.
• -- Faux positifs de scoring : un modèle d'IA bien réglé reste probabiliste. Un CV atypique mais pertinent peut recevoir un score bas — d'où l'importance de router les cas limites vers une revue humaine plutôt que vers un rejet automatique.
• -- Pièces jointes volumineuses : CV en PDF scanné, portfolios lourds. Prévoir une limite de taille et un traitement d'erreur explicite plutôt qu'un échec silencieux du nœud HTTP Request.
• -- Absence de rejeu : sans file d'attente ou logique de retry, un webhook manqué (timeout, erreur réseau) fait disparaître une candidature du radar. Un nœud de gestion d'erreur avec notification est indispensable.
• -- Coût d'hébergement n8n : l'auto-hébergement facilite la maîtrise des données transmises au modèle d'IA, mais transfère la charge de maintenance (mises à jour, sauvegardes) à l'équipe technique.

Ces points de vigilance concernent l'intégration Teamtailor comme n'importe quelle automatisation RH sur-mesure : la robustesse se construit sur la gestion des cas limites, pas sur le chemin nominal. C'est le travail que nous menons dans nos missions d'automatisation RH sur-mesure : cadrer les seuils, tester sur des volumes réels, et prévoir les scénarios d'échec avant la mise en production.

RGPD et présélection automatisée : ce qu'impose la CNIL

La CNIL a fait du recrutement un thème de contrôle prioritaire en 2026, avec trois points systématiquement vérifiés : l'information donnée aux candidats sur l'usage d'un outil de tri, la durée de conservation des données, et l'existence d'une intervention humaine réelle avant toute décision défavorable — voir la page dédiée de la CNIL sur le recrutement.

Trois obligations structurent un workflow Teamtailor + n8n conforme :

• -- Information explicite : la notice RGPD accessible depuis le formulaire de candidature doit mentionner l'usage d'un outil de scoring ou de tri automatisé.
• -- Conservation limitée : les données d'un candidat non retenu ne peuvent être conservées plus de deux ans après le dernier contact ; passé ce délai, elles doivent être supprimées ou anonymisées — un nœud de purge programmée dans n8n peut automatiser cette échéance.
• -- Validation humaine réelle : un recruteur doit examiner le dossier avant qu'une décision produise un effet sur le candidat. Valider systématiquement sans regarder le classement de l'outil ne constitue pas une intervention humaine au sens du RGPD.

À cela s'ajoute une obligation distincte mais convergente : le règlement européen sur l'IA classe les systèmes d'IA utilisés pour le recrutement en annexe III comme systèmes à haut risque, avec des obligations de documentation et de supervision qui s'ajoutent à celles du RGPD. Un workflow Teamtailor + n8n bien conçu — supervision humaine systématique, scoring documenté, purge automatique — répond déjà à l'essentiel de ces deux cadres.