Connectez TieTalent à
Une clé API TieTalent, cinq étapes. Ensuite, les recruteurs lancent Candidate Intelligence ou Role Fit depuis les candidatures Pinpoint ou les Stage Actions et voient les résultats sur la candidature.
Transcription vidéo
Ce parcours montre comment créer une clé API TieTalent sous Developers, ouvrir le plugin TieTalent dans Pinpoint sous Settings, Integrations, My Plugins, coller la clé API TieTalent, ajouter éventuellement l'URL du compte Pinpoint et une clé API Pinpoint avec uniquement l'accès en lecture Application, puis lancer Candidate Intelligence ou Role Fit depuis une candidature ou une Stage Action.
Ce qu'il vous faut
- Accès Company Manager Pinpoint (Integrations et API & Webhooks)
- Owner, admin ou developer de l'espace TieTalent (Developers → API keys)
- Environ 10 minutes, Pinpoint et TieTalent ouverts dans deux onglets
- Gardez les clés API secrètes. Copiez la clé TieTalent une seule fois à la création
Cinq étapes pour connecter
- 1
Créer une clé API TieTalent
TieTalent → Developers → API keys → Create
Dans TieTalent, ouvrez Developers → API keys et créez une clé. Copiez la valeur complète une fois (elle commence par ats_). TieTalent ne réaffichera pas le secret complet.
- 2
Ouvrir TieTalent dans Pinpoint
Pinpoint → Settings → Integrations → My Plugins → TieTalent → Configure
Dans Pinpoint, ouvrez Settings → Integrations → My Plugins. Trouvez TieTalent et ouvrez Configure. Vous devez voir les champs pour la clé API TieTalent, plus l'URL du compte Pinpoint et la clé API Pinpoint en option.
- 3
Coller la clé API TieTalent
Pinpoint → TieTalent Configure → TieTalent API key → Save
Collez la clé ats_ dans TieTalent API key et enregistrez. Sans clé valide, le formulaire d'action affiche un avertissement de configuration.
- 4
Ajouter l'accès au compte Pinpoint (recommandé)
Pinpoint → Settings → API & Webhooks → API Keys → puis TieTalent Configure
Dans Pinpoint Settings → API & Webhooks, activez l'API Pinpoint, puis créez une clé API avec uniquement Application: Read. TieTalent ne fait que lire via cette clé et ne modifie rien dans Pinpoint. Dans TieTalent Configure, collez l'URL du compte (https://yourcompany.pinpointhq.com) et cette clé API. TieTalent peut alors lire LinkedIn, CV, historique professionnel et description de poste, pour que Role Fit tourne depuis une Stage Action sans coller de description de poste.
- 5
Lancer Candidate Intelligence ou Role Fit
Pinpoint → Candidature → ⋯ → Run TieTalent …, ou Stage → Add stage action
Sur une candidature, ouvrez le menu ⋯ et choisissez Run TieTalent Candidate Intelligence ou Run TieTalent Role Fit. Ou ajoutez une Stage Action sur une étape du pipeline pour que le rapport démarre automatiquement quand des candidats atteignent cette étape. Role Fit sans connexion Pinpoint nécessite une description de poste collée.
Confirmer la connexion avec un candidat
Choisissez une candidature réelle, avec CV si possible. Lancez Candidate Intelligence ou Role Fit. Role Fit a besoin d'une description de poste dans le formulaire ou via le job Pinpoint connecté. Quand l'analyse se termine, l'assessment sur la candidature affiche un verdict ou un résumé d'adéquation, des faits clés et le lien Open TieTalent report. La connexion est alors confirmée.
À quoi ressemble « terminé »
- Pinpoint My Plugins → TieTalent est configuré avec une clé API TieTalent valide
- Au moins un assessment démarré avec des résultats sur la candidature Pinpoint
- Connexion API Pinpoint optionnelle renseignée si vous voulez l'enrichissement LinkedIn, CV et description de poste
Problèmes fréquents
Avertissement de configuration sur la clé API TieTalent
Créez une nouvelle clé sous TieTalent Developers → API keys, collez la valeur ats_ complète dans Pinpoint Configure, puis enregistrez. Les clés révoquées ou mal saisies sont refusées.
URL de compte Pinpoint ou association de clés invalide
Utilisez votre adresse de connexion, par exemple https://yourcompany.pinpointhq.com. Si vous ajoutez l'URL, vous devez aussi ajouter la clé API Pinpoint (ou retirer les deux). Créez la clé sous Settings → API & Webhooks avec uniquement Application: Read.
Role Fit demande une description de poste
Sans la connexion Pinpoint optionnelle, collez la description de poste dans le formulaire. Avec la connexion configurée, laissez le champ vide pour que TieTalent lise le poste depuis Pinpoint.
Crédits insuffisants ou Candidate Intelligence non activé
Chaque analyse utilise des crédits de votre espace TieTalent. S'ils ne suffisent pas, l'analyse ne démarre pas et rien n'est facturé ; un admin TieTalent peut recharger sous Plans & billing. Si Candidate Intelligence n'est pas activé pour votre espace, contactez TieTalent pour le faire activer.
L'assessment démarre mais les résultats n'apparaissent pas dans Pinpoint
Les rapports prennent quelques minutes. Actualisez la candidature. Si une analyse échoue, l'assessment en indique la raison et aucun crédit n'est facturé. Chaque analyse apparaît aussi dans TieTalent History sous Candidate Intelligence ou Role Fit, avec un filtre Pinpoint.
TieTalent ne peut pas lire le candidat dans Pinpoint
L'assessment indique que Pinpoint a refusé la clé API. La clé API Pinpoint a été révoquée ou n'a pas Application: Read. Créez une nouvelle clé avec Application: Read, collez-la dans TieTalent Configure et relancez le rapport.
Une nouvelle analyse renvoie le même rapport
Si le même candidat est relancé avec les mêmes informations (CV, profil LinkedIn et, pour Role Fit, description de poste) dans les 6 mois, TieTalent renvoie le rapport existant sans frais. Modifiez les informations, par exemple avec un CV plus récent, pour obtenir un nouveau rapport.
Prêt à connecter ?
Créez une clé API TieTalent, puis configurez TieTalent dans Pinpoint My Plugins. Contactez-nous si votre équipe a besoin d'un parcours guidé.