INTÉGRATION BAMBOOHR n8n : AUTOMATISER BAMBOOHR AVEC N8N

L'action "Create an employee" vous permet de créer automatiquement de nouvelles fiches collaborateurs dans BambooHR. C'est la pierre angulaire de tout workflow d'onboarding automatisé, vous évitant la saisie manuelle des informations de base pour chaque nouvelle recrue.

Paramètres de configuration :

• First Name : Prénom du collaborateur. Champ texte requis.
• Last Name : Nom de famille du collaborateur. Champ texte requis.
• Synced with Trax Payroll : Interrupteur on/off permettant de synchroniser automatiquement l'employé avec Trax Payroll. Optionnel, désactivé par défaut.
• Additional Fields : Section extensible pour ajouter des champs personnalisés (email, département, date d'embauche, etc.).

Cas d'usage typiques : Création automatique d'un employé quand un candidat est marqué "Hired" dans votre ATS, synchronisation depuis un formulaire Tally ou Typeform, import en masse depuis un fichier Excel via Google Sheets.

Cette action récupère les informations détaillées d'un collaborateur spécifique à partir de son identifiant. Utile pour alimenter d'autres systèmes avec des données employé à jour ou pour vérifier des informations avant une action automatisée.

Paramètres de configuration :

• Employee ID : Identifiant unique de l'employé dans BambooHR. Champ texte optionnel (peut être passé dynamiquement via une expression).
• Options : Section pour ajouter des filtres ou configurations supplémentaires.

Cas d'usage typiques : Récupération des coordonnées d'un employé pour envoi d'une notification personnalisée, vérification du département avant attribution d'accès spécifiques, alimentation d'un profil utilisateur dans un autre outil.

L'action "Get many employees" permet de récupérer une liste de collaborateurs depuis votre compte BambooHR. Idéale pour les synchronisations régulières, les exports de données ou l'alimentation de dashboards RH.

Paramètres de configuration :

• Return All : Interrupteur permettant de récupérer tous les employés sans limite. Optionnel.
• Limit : Nombre maximum d'enregistrements à récupérer. Champ numérique optionnel, utile pour paginer les résultats ou limiter la charge.

Cas d'usage typiques : Export quotidien de la liste des employés vers un Google Sheet pour reporting, synchronisation hebdomadaire avec l'annuaire d'entreprise (Active Directory, Google Workspace), génération de listes de diffusion email automatiques par département.

Cette action met à jour les informations d'un collaborateur existant dans BambooHR. Essentielle pour maintenir vos données RH synchronisées avec vos autres systèmes sans intervention manuelle.

Paramètres de configuration :

• Employee ID : Identifiant de l'employé à modifier. Champ texte requis.
• Synced with Trax Payroll : Interrupteur pour activer/désactiver la synchronisation paie. Optionnel.
• Update Fields : Section dynamique où vous spécifiez les champs à mettre à jour (poste, manager, département, etc.).

Cas d'usage typiques : Mise à jour automatique du poste suite à une promotion validée dans votre outil de gestion des talents, changement de département synchronisé depuis votre organigramme, modification des informations de contact suite à un déménagement signalé.

L'action "Get a company report" récupère les données d'un rapport d'entreprise préconfiguré dans BambooHR. Parfait pour automatiser vos routines de reporting RH et alimenter vos outils de BI.

Paramètres de configuration :

• Report ID : Identifiant du rapport BambooHR à récupérer. Champ texte requis.
• Format : Format de sortie des données. Menu déroulant avec "JSON" par défaut. Requis.
• Options : Paramètres additionnels pour personnaliser l'extraction.

Cas d'usage typiques : Export automatique hebdomadaire des effectifs vers votre outil de BI (Metabase, Looker), génération de rapports de turnover envoyés par email aux managers, alimentation d'un dashboard temps réel sur les absences.

Cette action permet d'uploader un fichier dans la bibliothèque de fichiers générale de BambooHR. Utile pour centraliser des documents d'entreprise accessibles à tous ou à certaines catégories d'employés.

Paramètres de configuration :

• Input Data Field Name : Nom du champ contenant les données binaires du fichier. Champ texte requis, généralement "data".
• Category Name or ID : Catégorie de classement du fichier dans BambooHR. Champ texte optionnel.

Cas d'usage typiques : Archivage automatique des notes de service générées, upload de documents de formation depuis votre LMS, centralisation des procédures mises à jour depuis Google Docs.

L'action "Get many files" récupère plusieurs fichiers depuis la bibliothèque BambooHR. Pratique pour des audits documentaires ou des synchronisations avec d'autres systèmes de stockage.

Paramètres de configuration :

• Return All : Interrupteur pour récupérer tous les fichiers. Optionnel.
• Limit : Nombre maximum de fichiers à récupérer. Champ numérique optionnel.
• Simplify : Interrupteur pour simplifier le format de sortie des données. Optionnel.

Cas d'usage typiques : Audit trimestriel de la complétude documentaire, migration de fichiers vers un nouveau système de GED, génération d'inventaires documentaires.

Cette action télécharge un fichier spécifique depuis BambooHR pour l'utiliser dans la suite de votre workflow. Essentielle pour les traitements de documents automatisés.

Paramètres de configuration :

• File ID : Identifiant unique du fichier à télécharger. Champ texte requis.
• Put Output In Field : Nom du champ où stocker les données du fichier. Champ texte optionnel, "data" par défaut.

Cas d'usage typiques : Téléchargement d'un fichier pour envoi par email via un autre nœud, extraction de données depuis un document pour traitement, copie de fichiers vers un stockage externe (Google Drive, Dropbox).

L'action "Update a file" permet de modifier un fichier existant dans la bibliothèque BambooHR. Utile pour versionner des documents ou mettre à jour des métadonnées.

Paramètres de configuration :

• File ID : Identifiant du fichier à mettre à jour. Champ texte requis.
• Update Fields : Section dynamique pour spécifier les modifications (métadonnées, contenu, catégorie).

Cas d'usage typiques : Mise à jour de documents de politique interne avec leur nouvelle version, modification des métadonnées (catégorie, description) en masse, remplacement de fichiers obsolètes par des versions actualisées.

Cette action supprime définitivement un fichier de la bibliothèque BambooHR. À utiliser avec précaution, idéalement dans des workflows de nettoyage contrôlés.

Paramètres de configuration :

• File ID : Identifiant du fichier à supprimer. Champ texte ou numérique requis.

Cas d'usage typiques : Suppression automatique des fichiers temporaires après traitement, nettoyage des documents expirés (conformité RGPD), archivage avec suppression après copie vers un stockage longue durée.

L'action "Upload an employee document" permet d'ajouter un document directement au dossier personnel d'un collaborateur. C'est l'action clé pour automatiser la gestion documentaire RH individuelle.

Paramètres de configuration :

• Employee ID : Identifiant de l'employé concerné. Champ texte requis.
• Employee Document Category ID : Catégorie de document (contrat, attestation, etc.). Champ texte optionnel.
• Input Data Field Name : Nom du champ contenant le fichier. Champ texte requis, généralement "data".

Cas d'usage typiques : Upload automatique des contrats signés depuis DocuSign ou Yousign, archivage des bulletins de paie depuis votre logiciel de paie, stockage des attestations de formation après complétion.

Cette action récupère la liste des documents associés à un ou plusieurs employés. Parfaite pour auditer la complétude des dossiers ou synchroniser les documents avec d'autres systèmes.

Paramètres de configuration :

• Employee ID : Identifiant de l'employé (optionnel pour récupérer tous les documents). Champ texte optionnel.
• Return All : Interrupteur pour récupérer tous les documents. Optionnel.
• Limit : Nombre maximum de documents. Champ numérique optionnel.
• Simplify : Simplification du format de sortie. Optionnel.

Cas d'usage typiques : Vérification de la présence de tous les documents obligatoires avant fin de période d'essai, export de l'inventaire documentaire pour audit RH, détection des documents manquants avec notification automatique.

L'action "Download an employee document" télécharge un document spécifique du dossier d'un collaborateur pour traitement ultérieur dans votre workflow.

Paramètres de configuration :

• Employee ID : Identifiant de l'employé. Champ texte requis.
• File ID : Identifiant du document à télécharger. Champ texte optionnel.
• Put Output In Field : Champ de destination des données. Champ texte optionnel, "data" par défaut.

Cas d'usage typiques : Envoi automatique d'une attestation employeur par email sur demande, extraction de documents pour constitution de dossiers (mobilité, visa), copie de sauvegarde vers un stockage externe sécurisé.

Cette action met à jour un document existant dans le dossier d'un collaborateur, que ce soit son contenu ou ses métadonnées.

Paramètres de configuration :

• Employee ID : Identifiant de l'employé. Champ texte requis.
• File ID : Identifiant du document à modifier. Champ texte requis.
• Update Fields : Section pour spécifier les champs à mettre à jour.

Cas d'usage typiques : Mise à jour d'avenants au contrat de travail, modification de la catégorie d'un document mal classé, remplacement d'un document par sa version signée.

L'action "Delete an employee document" supprime définitivement un document du dossier personnel d'un collaborateur. À utiliser dans le cadre de politiques de rétention documentaire.

Paramètres de configuration :

• Employee ID : Identifiant de l'employé. Champ texte requis.
• File ID : Identifiant du document à supprimer. Champ texte requis (format expression).

Cas d'usage typiques : Application des politiques de rétention RGPD (suppression après X années), nettoyage des documents temporaires (brouillons, versions de travail), suppression contrôlée lors d'un offboarding complet.