En bref
- Trois façons de se connecter : une connexion ATS native, l’API publique avec webhooks ou l’entretien intégré à votre page carrières. Vous pouvez en utiliser plusieurs.
- ATS : associez une offre et une étape dans Workable, Greenhouse, Teamtailor, Recruitee ou Breezy HR à un entretien publié. Chaque candidat placé à cette étape est invité une seule fois, et les résultats reviennent sous forme de note.
- API : créez des candidats et des invitations depuis vos propres systèmes avec une clé API aux droits limités, et suivez ce qui se passe grâce aux webhooks signés.
- Intégration (embed) : faites passer l’entretien sur votre propre site avec un seul script, depuis les sites que vous autorisez.
- Testez d’abord : envoyez un événement de test webhook, faites passer un candidat de test par l’étape, et consultez les journaux de livraison et d’activité avant la mise en production.
Trois façons de connecter les entretiens IA
Une intégration ATS pour les entretiens IA évite à vos recruteurs les copier-coller : les candidats sont invités depuis le système que vous utilisez déjà, et les résultats y reviennent. Si votre ATS n’a pas de connexion native, ou si vous recrutez via votre propre portail, l’API publique et l’intégration font le même travail avec un peu de code.
- Connexion ATS native. Workable, Greenhouse, Teamtailor, Recruitee et Breezy HR. Sans code : collez une clé, associez une offre et une étape, et le passage d’un candidat à cette étape envoie l’invitation.
- API publique et webhooks. Votre système crée les candidats et les invitations via REST et récupère les résultats ; les webhooks le préviennent quand quelque chose se produit.
- Embed SDK. Un script fait passer l’entretien dans un cadre sur votre page carrières. Il a besoin d’un lien d’invitation, il s’utilise donc avec l’API.
Les trois nécessitent un forfait payant et un administrateur de l’entreprise. L’entretien est le même que celui reçu par lien e-mail, y compris la possibilité d’écrire au lieu de parler.
Choisir entre l’ATS, l’API et l’intégration
| Connexion ATS native | API publique et webhooks | Embed SDK (avec l’API) | |
|---|---|---|---|
| Idéal pour | Les équipes sur l’un des cinq ATS pris en charge | Tout autre ATS ou votre propre processus | Une page carrières ou un portail que vous gérez |
| Code nécessaire | Aucun | Des appels d’API et un récepteur de webhooks | Quelques lignes sur la page, plus l’API |
| Ce qui envoie l’invitation | Le passage d’un candidat à l’étape associée | Votre appel d’API | Votre appel d’API ; le lien est monté sur votre page |
| Les résultats reviennent sous forme de | Note sur le candidat dans l’ATS | Résultats que vous récupérez après le webhook de résultats | Pareil ; la page apprend seulement que le candidat a terminé |
Commencez par la connexion native si votre ATS en propose une. Choisissez l’API si vous voulez maîtriser qui est invité et quand. Ajoutez l’intégration si les candidats doivent rester sur votre site.
Configurer une intégration ATS pour les entretiens IA
Connecter un ATS et associer une offre
- Publiez l’entretien. Seul un entretien publié peut être associé à une offre.
- Ouvrez Intégrations → ATS et cliquez sur Connecter un ATS. Collez les identifiants de l’ATS (où les trouver). testee les essaie auprès de l’ATS avant d’enregistrer, puis les stocke chiffrés et n’affiche qu’un indice masqué.
- Configurez le webhook. Rien à faire pour Workable et Breezy HR : testee l’enregistre. Pour Greenhouse, Teamtailor et Recruitee, ajoutez un webhook dans l’ATS avec l’adresse indiquée sur la carte Webhook de la connexion, et échangez le secret comme la carte l’indique.
- Associez une offre. L’onglet Offres liste les offres ouvertes de l’ATS. Ouvrez-en une, choisissez l’entretien publié et l’étape qui envoie l’invitation, puis enregistrez.
- Signalez les offres à New York sur l’association, pour que les invitations portent votre avis au titre de la Local Law 144 et s’ouvrent 10 jours ouvrés plus tard.


Ce qui se passe pour chaque candidat
- Une seule invitation, quel que soit le nombre de fois où l’ATS envoie l’événement. Les événements des offres ou étapes non associées sont ignorés.
- Champs fixes : l’e-mail et le nom du candidat, l’offre et l’étape, et la référence de l’ATS. Aucune correspondance à configurer.
- Résultats sous forme de note : le score de couverture (pour évaluation, pas une décision d’embauche), le résumé et un lien vers les résultats. Vous pouvez désactiver ce renvoi pour chaque connexion.
- Échecs : une panne est relancée pendant environ huit heures ; un refus, par exemple s’il ne reste plus de minutes d’entretien, apparaît dans le journal.
- Du temps supplémentaire pour un candidat qui l’a demandé se règle sur la page de l’invitation dans le tableau de bord, tant qu’il n’a pas commencé.
Suspendre met en attente les invitations et les notes jusqu’à la reprise. Si l’ATS refuse la clé plus tard, la connexion affiche « Reconnexion nécessaire » et les notes attendent.
Utiliser l’API et les webhooks des entretiens IA
L’API REST publique fait ce qu’un recruteur fait dans le tableau de bord : lister les entretiens publiés, créer des candidats, les inviter et récupérer les résultats. La référence se trouve dans la documentation de l’API des entretiens IA.
Clés API
- Créez une clé dans Intégrations → Clés API. Le secret (aik_live_…) n’est affiché qu’une fois et s’envoie comme jeton bearer, jamais dans une URL.
- Portées : n’accordez à chaque clé que les droits utilisés par son système, comme invitations:write et results:read.
- Liste d’IP autorisées : jusqu’à 50 adresses ou plages, comme les adresses sortantes de vos serveurs.
- Expiration : 30 jours, 90 jours (par défaut), 1 an, une date jusqu’à 2 ans à l’avance, ou jamais. La liste vous prévient 7 jours avant.
- Limite de débit : 120 requêtes par minute et par clé.


Inviter un candidat depuis votre système
- GET /v1/interviews liste vos entretiens publiés.
- POST /v1/candidates avec le nom et l’e-mail. Un second candidat avec le même e-mail est refusé : conservez donc l’identifiant.
- POST /v1/invitations avec les deux identifiants. La réponse contient le lien, affiché une seule fois ; testee l’envoie aussi par e-mail au candidat.
- Envoyez un en-tête Idempotency-Key à chaque POST. Une nouvelle tentative avec la même clé après un délai dépassé ne crée rien en double (les clés durent 24 heures).
| Champ d’invitation facultatif | Rôle |
|---|---|
| externalId | Votre propre identifiant (celui de la candidature, par exemple). Il revient sur l’invitation et dans chaque webhook |
| returnUrl | Une fois terminé, le candidat voit un bouton de retour vers cette adresse https (pas dans l’intégration) |
| extraTime | 25, 50 ou 100 % de temps en plus pour un candidat qui l’a demandé ; un entretien dure au maximum 60 minutes, temps supplémentaire compris. Jamais renvoyé par l’API ni envoyé dans les webhooks |
| nycNotice | Le candidat vit à New York : l’e-mail contient votre avis, et l’entretien s’ouvre 10 jours ouvrés plus tard |
| skipSignIn | Votre site a déjà connecté le candidat : le lien seul ouvre l’entretien (voir l’intégration) |
Webhooks
Ajoutez un endpoint dans Intégrations → Webhooks : une URL https publique et ses événements, à savoir invitation.created, invitation.opened, invitation.resent, invitation.revoked, invitation.expired, session.started, session.completed, results.failed, review.decision_changed, candidate.erased et results.ready. Les payloads ne contiennent que des identifiants et votre externalId, jamais de noms ni de scores ; sur results.ready, appelez GET /v1/sessions/{id}/results.
- Vérifiez chaque signature : un HMAC-SHA256 de l’horodatage et du corps brut, avec le secret de l’endpoint comme clé. Comparez en temps constant et rejetez les horodatages de plus de 5 minutes (code dans la documentation des webhooks).
- Répondez 2xx en moins de 10 secondes. Les échecs sont relancés avec backoff pendant environ 24 heures.
- Attendez-vous à des doublons et à un ordre quelconque : ignorez un identifiant d’événement déjà traité, et lisez l’état actuel via l’API.
Intégrer l’entretien à votre page carrières
Un entretien intégré à votre page carrières garde les candidats sur votre site : un script place l’entretien dans un cadre et signale ce que fait le candidat (documentation de l’Embed SDK).
Intégrer l’entretien
- Autorisez votre site dans Intégrations → Intégration web : une origine https sans chemin, jusqu’à 20. L’entretien ne se chargera dans un cadre nulle part ailleurs.
- Créez l’invitation sur votre serveur et transmettez son lien à la page. La clé API ne va jamais dans la page.
- Montez-le avec TesteeEmbed.mount : un conteneur, le lien et une fonction onEvent. L’onglet Intégration web du tableau de bord affiche l’extrait de code.
- Gérez les événements : ready, login_required, started, completed, feedback_submitted et error, chacun avec des identifiants uniquement.
Passer le code de connexion
Par défaut, le candidat se connecte dans le cadre avec un code à 6 chiffres reçu par e-mail ; votre page ne le voit jamais. Si votre site a déjà connecté le candidat, créez l’invitation via l’API avec skipSignIn, et le lien seul ouvre l’entretien. Le tableau de bord ne permet pas de le définir.
- Le compromis : le lien devient la seule clé, donc quiconque l’a peut passer l’entretien. Limitez l’expiration à un ou deux jours, créez l’invitation juste avant que le candidat ne commence, et ne l’affichez que derrière votre propre connexion.
- Pour l’historique : l’invitation indique « Connexion ignorée », et les résultats précisent que l’identité a été vérifiée par le site de votre entreprise.
Testez avant la mise en production
Un test complet
- Utilisez un candidat de test avec un e-mail que vous pouvez lire ; les aperçus des membres de l’équipe n’envoient aucun webhook.
- Envoyez un événement de test webhook depuis le menu de l’endpoint : un test.ping signé, qui vérifie donc aussi votre code de signature.
- Consultez le journal de livraison sur la page de l’endpoint. Renvoyer relivre une livraison avec le même identifiant, ce qui vérifie que vous ignorez les doublons.
- Placez le candidat à l’étape associée et consultez l’onglet Activité de la connexion ATS : chaque événement, invitation et note est terminé, en cours de relance, en échec ou ignoré.
- Passez l’entretien et vérifiez que results.ready est arrivé, ou que la note est apparue dans l’ATS. Les solutions aux problèmes courants sont dans la documentation de dépannage ATS.
Notes de sécurité
- Les clés restent sur le serveur, une par système, avec seulement les portées nécessaires, une liste d’IP autorisées et une expiration. Révoquez une clé que vous soupçonnez d’avoir fuité.
- Vérifier, puis faire confiance : rejetez les webhooks dont la signature ou l’horodatage échoue, et lisez les données via l’API.
- N’autorisez que vos propres sites pour l’intégration.
- Les liens d’invitation sont personnels : ne les journalisez et ne les partagez jamais, surtout avec skipSignIn.
Notifications Slack
Dans Intégrations → Slack, connectez-vous avec Ajouter à Slack ou un webhook entrant, choisissez les notifications à publier, comme les résultats prêts, et envoyez un message de test (documentation Slack).
Résumé
- Sur l’un des cinq ATS pris en charge, utilisez la connexion native : associez chaque offre et étape à un entretien publié.
- Sinon, utilisez l’API avec des clés aux droits limités et à durée limitée, des en-têtes Idempotency-Key, et vérifiez chaque webhook.
- Pour garder les candidats sur votre site, ajoutez l’intégration, et ne passez le code de connexion que derrière votre propre connexion.
- Avant la mise en production, faites passer un candidat de test de bout en bout.
Questions et réponses
testee s’intègre-t-il à Greenhouse ou à Workable ?
Oui, nativement, ainsi qu’à Teamtailor, Recruitee et Breezy HR. Vous associez une offre et une étape à un entretien publié ; chaque candidat placé à cette étape est invité une seule fois, et les résultats reviennent sous forme de note.
Existe-t-il une API pour les entretiens IA ?
Oui. L’API REST crée des candidats et des invitations, indique leur statut et renvoie les résultats, les rapports PDF et les exports CSV. Des webhooks signés préviennent votre système quand quelque chose se produit.
Mon ATS n’est pas pris en charge. Puis-je quand même le connecter ?
Oui, via l’API : créez l’invitation quand le candidat atteint la bonne étape, gardez-y votre externalId, et récupérez les résultats à l’arrivée de results.ready.
Les candidats peuvent-ils passer l’entretien sur notre page carrières ?
Oui, avec l’Embed SDK : autorisez votre site dans Intégrations → Intégration web, créez l’invitation avec l’API et montez-la sur votre page.
Le résultat fait-il avancer les candidats dans l’ATS ?
Non. testee ne déplace ni ne rejette jamais un candidat. La note porte le score de couverture, présenté comme aide à l’évaluation et non comme une décision d’embauche ; c’est une personne qui décide.
Que doit contenir une checklist d’intégration ATS ?
Quelles offres et étapes déclenchent l’invitation, qui gère les clés, comment les webhooks sont vérifiés, ce qui revient dans l’ATS, comment les échecs sont repérés, comment traiter les candidats de New York et les demandes d’aménagement, et un test complet.
Sources
- Documentation développeur testee : intégrations ATS
- Documentation développeur testee : API REST
- Documentation développeur testee : webhooks
- Documentation développeur testee : Embed SDK
- Documentation développeur testee : Slack
- Spécification Standard Webhooks
- RFC 2104, HMAC : Keyed-Hashing for Message Authentication