API de Factorial: qué puedes hacer y cómo usarla con agentes de IA
La API de Factorial da acceso a datos de RR. HH. como empleados, equipos, ausencias, control horario y documentos. La usan áreas de RR. HH. e integradores que conectan Factorial con la nómina, con sistemas de acceso y con la comunicación interna. El acceso es con OAuth 2.0 con una aplicación registrada o con una clave de API de la empresa.
Qué ofrece la API de Factorial
Empleados
Registro, contratos y datos laborales.
Equipos y estructura
Equipos, centros de trabajo y responsables.
Ausencias y vacaciones
Solicitudes, aprobaciones y saldos.
Control horario
Registros de entrada y salida y turnos.
Documentos
Archivos de los empleados y de la empresa.
Webhooks
Avisos de eventos como nuevos empleados y ausencias.
Cómo acceder a la API de Factorial
- Con las credenciales de tu empresaOAuth 2.0 con una aplicación registrada en la cuenta de Factorial, o una clave de API generada por un administrador. Los permisos siguen el perfil autorizado.
- Los datos de los empleados son personales y algunos sensibles (RGPD y la ley de protección de datos que aplique).
- El empleado solo debe ver sus propios datos: el agente verifica la identidad.
- Respeta los límites de solicitudes de la API.
Documentación oficial: apidoc.factorialhr.com
Qué hace un agente de iTeam con la API de Factorial
¿Cuántos días de vacaciones me quedan?
En Teams, el empleado pregunta y el agente consulta el saldo en Factorial y responde, sin abrir una incidencia en RR. HH.
Solicitud de día libre encaminada
El agente registra la solicitud de ausencia y avisa al responsable para que la apruebe.
Fichaje incompleto
El agente identifica los registros que faltan en el período y se lo recuerda a cada persona antes del cierre.
Onboarding ordenado
Cuando entra un empleado, el agente prepara la lista de documentos y crea las tareas del responsable y de TI.
De la credencial al agente trabajando, con aprobación
Registra la aplicación en Factorial
Un administrador crea la aplicación o la clave con los alcances mínimos.
Regístrala en la bóveda de iTeam
La credencial queda en la bóveda y solo la usan los agentes de RR. HH., con la lectura separada de la escritura.
Prueba con aprobación
El registro de ausencias y los cambios en las fichas empiezan con aprobación de RR. HH.
Equipos de IA listos para este trabajo
Reclutamiento y selección
Bia lee cada CV con los requisitos de la vacante, explica por qué recomienda a cada candidato y agenda la entrevista; la decisión la toma tu equipo.
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.
Evaluación de desempeño
Bia recoge feedback a lo largo del año, Dai ayuda a escribirlo bien y cada plan de desarrollo tiene un seguimiento real.
Preguntas sobre la API de Factorial
¿La API de Factorial es gratuita?
En general, la API está disponible para los clientes según el plan contratado: confírmalo con Factorial.
¿Necesito programar para usar la API de Factorial con iTeam?
No necesariamente. La herramienta HTTP de iTeam lee la documentación y el equipo de implantación configura los flujos.
¿El agente aprueba las vacaciones por su cuenta?
No. Las registra y las encamina; la aprobación sigue en manos del responsable.
