API Gupy : ce qu'on peut faire et comment l'utiliser avec des agents IA
L'API de Gupy, plateforme brésilienne de recrutement, permet de consulter les offres, les candidatures et les étapes des processus de sélection et de recevoir des événements par webhook. Elle sert aux équipes RH et aux intégrateurs qui relient le recrutement à la paie, à l'embauche et à la communication interne. L'accès se fait par un jeton généré pour l'entreprise cliente chez Gupy.
Ce que propose l’API Gupy
Offres
Consultation des offres, des exigences, du statut et des responsables.
Candidatures
Candidats de chaque offre et étape où ils se trouvent.
Étapes du processus
Déplacement des candidats entre les phases du processus de sélection.
Webhooks
Alertes d'événements comme un changement d'étape et une embauche.
Données d'embauche
Informations du candidat retenu pour passer à l'intégration administrative.
Comment accéder à l’API Gupy
- Avec les identifiants de votre entrepriseJeton d'API généré dans le compte de l'entreprise chez Gupy, envoyé dans l'en-tête comme bearer token. Les droits et les ressources disponibles dépendent du contrat.
- Les décisions sur les candidats doivent rester humaines ; l'agent organise et relance.
- Les données des candidats sont personnelles et parfois sensibles (LGPD, la loi brésilienne de protection des données).
- Respectez les limites de requêtes ; utilisez les webhooks pour les événements.
Documentation officielle: developers.gupy.io
Ce qu’un agent iTeam fait avec l’API Gupy
Manager informé sans avoir à demander
Chaque lundi, l'agent envoie à chaque manager l'entonnoir de ses offres : combien de candidats par étape et qui attend son évaluation.
Candidat bloqué à une étape
L'agent signale les candidatures sans mouvement depuis plusieurs jours et relance le recruteur ou le manager responsable.
Intégration déclenchée à l'embauche
Quand Gupy enregistre l'embauche, l'agent ouvre le dossier d'intégration administrative et demande les documents au nouveau collaborateur.
Agenda des entretiens
L'agent croise l'agenda du manager et propose des créneaux aux candidats retenus au tri.
De l’identifiant à l’agent au travail, avec validation
Générer le jeton chez Gupy
Avec un administrateur, créez le jeton d'API et confirmez quelles ressources le contrat ouvre.
Enregistrer dans le coffre d'iTeam
Le jeton est conservé dans le coffre et seuls les agents RH l'utilisent, avec une lecture séparée du déplacement de candidats.
Tester avec validation
Déplacer ou écarter des candidats passe toujours par une validation humaine.
Équipes IA prêtes à l’emploi qui utilisent Gupy
Questions sur l’API Gupy
L'API de Gupy est-elle gratuite ?
En général, l'accès à l'API est lié au contrat avec Gupy ; vérifiez auprès de votre interlocuteur s'il est inclus.
Faut-il programmer pour utiliser l'API de Gupy avec iTeam ?
Pas nécessairement. L'outil HTTP d'iTeam lit la documentation et l'équipe de déploiement configure les flux.
L'agent écarte-t-il des candidats tout seul ?
Il ne devrait pas. Dans iTeam, les changements d'étape restent sous la validation de la personne qui mène le processus.
