API de Gupy: qué puedes hacer y cómo usarla con agentes de IA
Gupy es una plataforma brasileña de reclutamiento y selección. Su API permite consultar vacantes, candidaturas y etapas de los procesos de selección, y recibir eventos por webhook. La usan equipos de RR. HH. e integradores que conectan el reclutamiento con el sistema de nómina, la incorporación y la comunicación interna. El acceso es por un token generado para la empresa cliente en Gupy.
Qué ofrece la API de Gupy
Vacantes
Consulta de vacantes, requisitos, estado y responsables.
Candidaturas
Candidatos de cada vacante y la etapa en que se encuentran.
Etapas del proceso
Movimiento de candidatos entre las fases del proceso de selección.
Webhooks
Avisos de eventos como el cambio de etapa y la contratación.
Datos de contratación
Información del candidato aprobado para pasar a la incorporación.
Cómo acceder a la API de Gupy
- Con las credenciales de tu empresaToken de API generado en la cuenta de la empresa en Gupy y enviado en la cabecera como bearer token. Los permisos y los recursos disponibles dependen del contrato.
- Las decisiones sobre candidatos deben ser humanas; el agente organiza y recuerda.
- Los datos de los candidatos son personales y a veces sensibles. En Brasil se rigen por la LGPD, la ley de protección de datos.
- Respeta los límites de solicitudes; usa webhooks para los eventos.
Documentación oficial: developers.gupy.io
Qué hace un agente de iTeam con la API de Gupy
Gerente informado sin pedirlo
Cada lunes, el agente envía a cada gerente el embudo de sus vacantes: cuántos candidatos hay por etapa y quién espera su evaluación.
Candidato detenido en una etapa
El agente señala las candidaturas sin movimiento desde hace días y avisa al reclutador o al gerente responsable.
Incorporación disparada por la contratación
Cuando Gupy registra la contratación, el agente abre el proceso de incorporación y pide los documentos al nuevo colaborador.
Agenda de entrevistas
El agente cruza la agenda del gerente y propone horarios a los candidatos aprobados en el primer filtro.
De la credencial al agente trabajando, con aprobación
Genera el token en Gupy
Con un administrador, crea el token de API y confirma qué recursos están habilitados en el contrato.
Regístralo en la bóveda de iTeam
El token queda en la bóveda y solo lo usan los agentes de RR. HH., con la lectura separada del movimiento de candidatos.
Prueba con aprobación
Mover o descartar candidatos pasa siempre por aprobación humana.
Equipos de IA listos que usan Gupy
Preguntas sobre la API de Gupy
¿La API de Gupy es gratuita?
En general, el acceso a la API está ligado al contrato con Gupy; confirma con tu ejecutivo si está incluido.
¿Necesito programar para usar la API de Gupy con iTeam?
No necesariamente. La herramienta HTTP de iTeam lee la documentación y el equipo de implantación configura los flujos.
¿El agente descarta candidatos por sí solo?
No debería. En iTeam, los cambios de etapa quedan bajo la aprobación de quien conduce el proceso.
