> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Connecter Personio

> Connectez Personio aux Automations avec vos propres identifiants API Personio, sans fenêtre de connexion

Connectez Personio pour lire vos données RH dans les automatisations : personnes, contrats, absences, présences, projets et documents. Personio n'a pas de fenêtre de connexion pour les autres applications. Vous créez donc des identifiants API dans votre compte Personio et collez leur Client ID et leur secret dans Famulor.

Ce que vous obtenez : les **actions** Personio du [App Catalog](/fr/automations/app-catalog). Elles lisent toutes des données ; Personio ne propose pas de déclencheurs ici.

| Action | Ce qu'elle renvoie |
| - | - |
| List persons | Les personnes actuelles, filtrées par identité, statut ou date de création |
| List person employments | Les contrats d'une personne, avec statut, type et temps de travail |
| List absence periods | Les absences filtrées par personne, type d'absence ou période |
| List absence types | Les types d'absence configurés pour votre entreprise |
| List attendance periods | Les présences filtrées par personnes, projets, statut ou dates |
| List projects | Les projets de suivi du temps |
| List documents | Les métadonnées des documents d'une personne, éventuellement par catégorie et date |
| List document categories | Les catégories de documents et leurs ID |
| List employee attributes | Les attributs standard et personnalisés que les identifiants peuvent lire |
| List employee records | Les fiches des employés avec les attributs de votre choix |

## Avant de commencer

* Vous êtes un utilisateur Personio avec des **droits d'accès API**. Sans eux, Personio ne vous laisse pas créer d'identifiants API.
* Votre espace de travail Famulor inclut la plateforme d'automatisation dans son forfait, et vous en êtes propriétaire ou administrateur.

Le Client ID et le secret restent dans le connecteur d'apps ; Famulor ne les stocke jamais dans votre espace de travail.

## Étape 1 — Créer des identifiants API dans Personio

1. Dans Personio, ouvrez **Marketplace → Connected integrations** puis **API credentials**.
2. Créez de nouveaux identifiants et donnez-leur un nom reconnaissable, par exemple *Famulor*.
3. Activez l'**accès en lecture** aux données dont vos automatisations ont besoin. Les **personnes** sont obligatoires, car Famulor s'en sert pour vérifier la connexion. Ajoutez absences, présences, projets, documents et attributs des employés si vous voulez utiliser ces actions.
4. Enregistrez, puis copiez le **Client ID** et le **Client secret**. Personio n'affiche le secret qu'une seule fois. Si vous le perdez, réinitialisez les identifiants et utilisez la nouvelle paire.

## Étape 2 — Connecter dans Famulor

1. Allez dans **Automations → Connections** et cliquez sur **New connection**.
2. Ouvrez l'**App marketplace**, recherchez **Personio** et sélectionnez-le.
3. Saisissez le **Client ID** et le **Client secret**. Le nom de la connexion est facultatif ; s'il reste vide, elle s'appelle *Personio*.
4. Cliquez sur **Connecter Personio**.

Famulor vérifie aussitôt les identifiants auprès de Personio. En cas de succès, la connexion apparaît avec le statut **ok** dans la liste des connexions, et les actions Personio sont disponibles dans toutes les automatisations de l'espace de travail.

## Dépannage

| Message | Signification | Solution |
| - | - | - |
| *Personio a refusé l'ID client ou le secret* | Une faute de frappe, ou le secret a été réinitialisé dans Personio. | Copiez à nouveau les deux valeurs, ou réinitialisez les identifiants et utilisez la nouvelle paire. |
| *Personio a accepté les identifiants, mais ils ne peuvent pas lire les employés* | Les identifiants n'ont pas d'accès en lecture aux personnes. | Modifiez les identifiants dans Personio, activez l'accès en lecture aux personnes et connectez-vous à nouveau. |
| Une étape d'automatisation échoue avec une erreur d'autorisation | Les identifiants n'ont pas d'accès en lecture à ces données. | Ajoutez l'accès en lecture dans Personio, puis choisissez **Remplacer les identifiants** sur la connexion dans Famulor. |

## Reconnexion et suppression

* **Remplacer les identifiants :** ouvrez la connexion dans Automations → Connections et choisissez **Modifier**. Saisissez le nouveau Client ID et le nouveau secret ; Famulor remplace les identifiants enregistrés en une seule étape.
* **Supprimer :** supprimer la connexion retire aussi les identifiants du connecteur d'apps. Les automatisations qui l'utilisaient affichent *Connect needed* jusqu'à ce que vous reconnectiez Personio.
* Pour révoquer l'accès côté Personio, supprimez ou réinitialisez les identifiants API dans Personio.

## Voir aussi

* [App Catalog](/fr/automations/app-catalog)
* [Référence des nœuds d'automatisation](/fr/automations/nodes)
* [Vue d'ensemble des automatisations](/fr/automations/overview)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.