API Factorial : ce qu'elle permet et comment l'utiliser avec des agents IA
L'API Factorial donne accès aux données RH comme les collaborateurs, les équipes, les absences, le pointage et les documents. Elle sert aux équipes RH et aux intégrateurs qui relient Factorial à la paie, aux systèmes d'accès et à la communication interne. L'accès se fait par OAuth 2.0 avec une application enregistrée, ou par une clé d'API de l'entreprise.
Ce que propose l’API Factorial
Collaborateurs
Fiches, contrats et données d'emploi.
Équipes et structure
Équipes, lieux de travail et managers.
Absences et congés
Demandes, validations et soldes.
Pointage
Enregistrements d'entrée et de sortie, et plannings.
Documents
Fichiers des collaborateurs et de l'entreprise.
Webhooks
Notifications d'événements comme les nouveaux collaborateurs et les absences.
Comment accéder à l’API Factorial
- Avec les identifiants de votre entrepriseOAuth 2.0 avec une application enregistrée dans le compte Factorial, ou clé d'API générée par un administrateur. Les permissions suivent le profil autorisé.
- Les données des collaborateurs sont personnelles, et certaines sensibles (RGPD).
- Le collaborateur ne doit voir que ses propres données ; l'agent vérifie l'identité.
- Respectez les limites de requêtes de l'API.
Documentation officielle: apidoc.factorialhr.com
Ce qu’un agent iTeam fait avec l’API Factorial
Combien de jours de congé me reste-t-il ?
Sur Teams, le collaborateur pose la question, et l'agent consulte le solde dans Factorial et répond, sans ouvrir de demande auprès des RH.
Demande de congé transmise
L'agent enregistre la demande d'absence et prévient le manager pour qu'il la valide.
Pointage incomplet
L'agent repère les saisies manquantes sur la période et le rappelle à chacun avant la clôture.
Intégration bien organisée
À l'arrivée d'un collaborateur, l'agent prépare la liste des documents et crée les tâches du manager et de l'IT.
De l’identifiant à l’agent au travail, avec validation
Enregistrez l'application dans Factorial
Un administrateur crée l'application ou la clé avec des portées minimales.
Enregistrez-la dans le coffre iTeam
L'identifiant reste dans le coffre et seuls les agents RH l'utilisent, avec lecture séparée de l'écriture.
Testez avec validation
Les enregistrements d'absence et les modifications de fiches commencent avec la validation des RH.
Équipes IA prêtes à l’emploi pour ce travail
Recrutement et tri des CV
Les candidatures sont lues selon vos critères, les meilleurs profils remontent avec une explication, et les entretiens se calent sans échange d'e-mail…
Questions RH des salariés
Congés, mutuelle, fiche de paie, télétravail : l'agent répond à partir de vos documents RH et passe la main dès que la question devient personnelle.
Préparation de la paie
Heures, absences, primes et frais sont rassemblés et vérifiés avant d'entrer dans la paie, pour que le bulletin soit juste du premier coup.
Entretiens et évaluations
Managers et salariés arrivent à l'entretien avec les faits de l'année, et les objectifs décidés sont suivis au lieu d'être oubliés.
Questions sur l’API Factorial
L'API Factorial est-elle gratuite ?
En règle générale, l'API est disponible pour les clients selon l'offre souscrite ; vérifiez auprès de Factorial.
Faut-il programmer pour utiliser l'API Factorial avec iTeam ?
Pas nécessairement. L'outil HTTP d'iTeam lit la documentation, et l'équipe de déploiement configure les flux.
L'agent valide-t-il les congés tout seul ?
Non. Il enregistre et transmet ; la validation reste au manager.
