API de Convenia: qué puedes hacer y cómo usarla con agentes de IA
Convenia es un software brasileño de RR. HH. Su API permite acceder a los datos de empleados, altas, bajas, vacaciones y otra información del departamento de personal. La usan empresas que quieren integrar RR. HH. con la nómina, los beneficios y los sistemas internos. El acceso se hace con un token generado en la cuenta de la empresa.
Qué ofrece la API de Convenia
Empleados
Consulta y actualización de datos personales y contractuales.
Altas
Seguimiento del proceso de incorporación digital.
Bajas
Registro y consulta de bajas.
Vacaciones y ausencias
Periodos de vacaciones y de ausencia.
Estructura de la empresa
Departamentos, puestos y centros de coste.
Cómo acceder a la API de Convenia
- Con las credenciales de tu empresaUsa un token de API generado en la plataforma de Convenia por un administrador y enviado en la cabecera de las solicitudes.
- Los datos de los empleados son personales y algunos son sensibles (ley brasileña de protección de datos, LGPD).
- Las respuestas a los empleados deben respetar quién puede ver qué.
- Los cambios en los datos de los empleados necesitan la aprobación de RR. HH.
Qué hace un agente de iTeam con la API de Convenia
Onboarding de quien se incorpora
Cuando se completa el alta, el agente crea los accesos, avisa al responsable y envía la agenda de la primera semana al nuevo empleado.
Dudas de vacaciones en Teams
El empleado pregunta cuántos días de vacaciones le quedan, y el agente consulta y responde solo a quien tiene derecho a verlo.
Baja con lista de tareas
Al registrar una baja, el agente abre las tareas de retirada de accesos y devolución de equipos.
Informe mensual de plantilla
El agente reúne altas, bajas y plantilla por área y lo envía a RR. HH.
De la credencial al agente trabajando, con aprobación
Generar el token
Un administrador de Convenia genera el token de API de la empresa.
Guardarlo en la bóveda de iTeam
Registra el token y restringe el acceso a los agentes de RR. HH., con los campos sensibles bloqueados cuando sea posible.
Validar con RR. HH.
Prueba con un grupo pequeño y mantén los cambios en los datos de los empleados bajo aprobación.
Equipos de IA listos que usan Convenia
Dudas del equipo y onboarding
Bia responde en Slack o Microsoft Teams con las políticas reales de tu empresa, y RR. HH. se queda con las conversaciones que necesitan a una persona.
Nómina y control de horas
Bia revisa fichajes y ausencias, Darwin cuadra las horas extra con el presupuesto y la nómina llega a tu proveedor sin sorpresas.
Preguntas sobre la API de Convenia
¿La API de Convenia es gratuita?
El acceso a la API depende del plan contratado. Confirma con Convenia si está incluido en tu cuenta.
¿Necesito programar para usar la API de Convenia con iTeam?
No necesariamente. El equipo de implantación de iTeam configura la integración a partir de la documentación de Convenia.
¿Calcula el agente la nómina?
No. La nómina sigue en el sistema de nómina, y el agente se ocupa de las rutinas, las dudas y las integraciones de alrededor.
