Synchroniser les personnes depuis BambooHR
Connectez BambooHR avec une clé API et Polzy tient vos membres à jour selon un calendrier — et quelques instants après un changement si vous ajoutez un webhook BambooHR.
Sur cette page
- 1Avant de commencer
- 2Créer une clé API dans BambooHR
- 3Connecter BambooHR dans Polzy
- 4Paramètres de synchronisation
- 5Associer les champs
- 6Prévisualiser et lancer la première synchronisation
- 7Recevoir les changements en quelques instants avec un webhook
- 8Calendrier et historique de synchronisation
- 9Quand quelqu’un part
- 10Dépannage
- 11Bon à savoir
- 12Liens utiles
Connectez BambooHR et Polzy lit votre annuaire de salariés selon un calendrier. Les nouvelles recrues arrivent comme membres de votre espace de travail, un changement d’intitulé de poste, de service ou de manager suit à la synchronisation suivante, et les personnes qui partent ne reçoivent plus d’enquêtes. Ajoutez aussi un webhook BambooHR, et un changement atteint Polzy en quelques instants au lieu d’attendre la synchronisation suivante.
La synchronisation des personnes est disponible à partir de Team, et seuls les administrateurs de l’espace de travail peuvent connecter une source. Polzy ne fait que lire BambooHR : il n’y écrit jamais et ne modifie aucune fiche salarié.
Avant de commencer
Il vous faut :
- Être administrateur de l’espace de travail Polzy, sur Team ou plus, avec Synchronisation des personnes activé sous Paramètres → Général → Ce que fait cet espace de travail.
- Un utilisateur BambooHR qui peut créer des clés API et voit chaque salarié et chaque champ que Polzy doit lire — y compris les anciens salariés, les dates de départ et les supérieurs. Une clé API voit exactement ce que voit son utilisateur.
- Votre sous-domaine BambooHR : la partie de votre adresse BambooHR avant
.bamboohr.com. Pourhttps://acme.bamboohr.com, c’estacme. - Pour les webhooks : un administrateur BambooHR, et la page Intégrations de Polzy, incluse dans Business.
Un espace de travail se synchronise depuis une seule source à la fois. Si une autre source est connectée, déconnectez-la d’abord. Si votre organisation provisionne ses membres via SCIM, aucune source de personnes ne peut être connectée — voir SCIM.
Créer une clé API dans BambooHR
- Connectez-vous à BambooHR avec l’utilisateur dont la clé doit avoir les accès. Un utilisateur dédié aux intégrations est une bonne idée : si cet utilisateur est désactivé, la clé cesse de fonctionner.
- Cliquez sur votre nom en bas à gauche et choisissez API Keys.
- Ajoutez une nouvelle clé, nommez-la Polzy et générez-la.
- Copiez la clé tout de suite. BambooHR ne l’affiche qu’une fois.
Voir BambooHR : Getting started with the API.
Connecter BambooHR dans Polzy
- Ouvrez Contacts → Synchro et champs.
- Sous Sources disponibles, trouvez BambooHR et choisissez Connecter. Un panneau s’ouvre avec trois étapes : Connexion, Paramètres de synchro et Correspondance des champs.
- Saisissez votre Sous-domaine BambooHR et collez la API Key. Laissez Secret du webhook vide pour l’instant ; il sert au webhook décrit plus bas.
- Choisissez Tester la connexion. Successfully connected to BambooHR. Found N employees. signifie que la clé fonctionne.
- Choisissez Suivant, vérifiez les paramètres de synchronisation (voir plus bas), puis choisissez de nouveau Suivant.
- À l’étape Correspondance des champs, gardez la correspondance par défaut ou activez Correspondance personnalisée des champs (voir plus bas), puis choisissez Connecter.
La clé est stockée chiffrée et ne sert qu’à lire BambooHR. Polzy la vérifie de nouveau quand vous choisissez Connecter : si BambooHR la refuse, rien n’est enregistré.
Paramètres de synchronisation
| Paramètre | Ce qu’il fait | Par défaut |
|---|---|---|
| Fréquence de synchronisation | La fréquence à laquelle Polzy lit BambooHR : toutes les 30 minutes, toutes les heures, toutes les 4 heures ou une fois par jour. | Toutes les heures |
| Désactiver les employés partis | Une personne que Polzy a importée de BambooHR et qui n’y apparaît plus est désactivée à la synchronisation suivante. | Activé |
| Envoyer des e-mails d'invitation | Les nouveaux membres qui ont une adresse e-mail reçoivent une invitation à se connecter à Polzy. | Activé |
| Rôle par défaut | Le rôle des nouveaux membres : Lecteur, Éditeur ou Administrateur. Il ne s’applique qu’aux personnes que la synchronisation crée. | Lecteur |
| Enregistrer les données brutes | Conserve une copie de chaque fiche telle que BambooHR l’a envoyée, à côté de la personne dans Polzy. Laissez-le désactivé sauf pour dépanner une correspondance : il stocke plus de données personnelles que nécessaire. | Désactivé |
Associer les champs
Polzy lit BambooHR au moyen d’un rapport des champs dont il a besoin, anciens salariés compris. La correspondance par défaut remplit :
| Champ Polzy | Depuis BambooHR |
|---|---|
workEmail | |
| Prénom, nom | firstName, lastName |
| Intitulé de poste | jobTitle |
| Service, site | department, location |
| Numéro de téléphone | mobilePhone |
| Matricule, date d’entrée | id, hireDate |
| Statut actif | déduit de terminationDate et status |
| Manager | supervisorId |
Pour la modifier, activez Correspondance personnalisée des champs. Chaque ligne a alors une source à choisir — parmi les autres champs proposés figurent workPhone, employeeNumber et division — et une valeur Si vide, utiliser, écrite quand BambooHR n’a rien pour cette personne. Une valeur que BambooHR envoie n’est jamais écrasée.
Quelques points à connaître :
- Seuls les champs de votre espace de travail sont remplis. Le service ou le site ne sont conservés que si votre espace de travail a un champ de ce nom. Ajoutez-en un avec Ajouter un champ sur Synchro et champs, puis associez-le.
- Groupes. Pour comparer les résultats selon un champ, faites-en un champ Liste et activez Groupes à côté de lui dans le tableau Correspondance des champs. Les valeurs de BambooHR sont rapprochées des options du champ.
- De vrais exemples. Une fois connecté, choisissez Paramètres sur Synchro et champs et rouvrez Correspondance des champs : la liste vient alors de cinq vraies fiches, chacune avec un Exemple.
- Managers. Le supérieur devient le manager de la personne quand il est lui aussi dans Polzy. S’il n’y est pas encore, le lien se fait lors d’une synchronisation ultérieure. Les managers demandent que Lignes hiérarchiques soit activé dans l’espace de travail.
Prévisualiser et lancer la première synchronisation
- Sur Synchro et champs, choisissez Prévisualiser une synchro sous Historique de synchro. Polzy calcule ce qu’une synchronisation ajouterait, mettrait à jour et désactiverait, sans rien changer, et ouvre le journal où le résultat apparaît comme Aperçu.
- Vérifiez l’aperçu. Si des noms, des e-mails ou des services semblent faux, corrigez la correspondance sous Paramètres et prévisualisez de nouveau.
- Choisissez Synchroniser maintenant. Le résultat apparaît dans Historique de synchro.
Les personnes sont rapprochées par leur identifiant BambooHR, puis par adresse e-mail : une personne que vous aviez déjà invitée à la main est mise à jour au lieu d’être ajoutée une seconde fois.
Recevoir les changements en quelques instants avec un webhook
Sans webhook, les changements arrivent à la prochaine synchronisation planifiée. Avec un webhook, BambooHR indique à Polzy quels salariés ont changé, et Polzy relit chacun d’eux aussitôt.
- Dans Polzy, ouvrez Intégrations, puis BambooHR, et copiez l’adresse sous Réception. Elle est propre à votre connexion et se termine par
/bamboohr. - Dans BambooHR, ouvrez Account Settings et choisissez Webhooks. Si cette entrée manque, le support BambooHR peut activer les webhooks sur votre compte.
- Ajoutez un webhook nommé Polzy, collez l’adresse comme URL et choisissez le format JSON.
- Choisissez les champs à surveiller — ceux que vous associez dans Polzy, comme le nom, l’e-mail professionnel, l’intitulé de poste, le service, le site, le statut et le supérieur.
- Générez la clé privée et copiez-la avant d’enregistrer. BambooHR ne l’affiche qu’une fois.
- Dans Polzy, ouvrez Contacts → Synchro et champs, choisissez Paramètres, collez la clé privée dans Secret du webhook, puis choisissez Enregistrer à la dernière étape.
BambooHR signe chaque appel avec la clé privée (X-BambooHR-Signature et X-BambooHR-Timestamp). Polzy refuse un appel non signé, signé avec une autre clé ou vieux de plus de cinq minutes, et ne fait rien deux fois quand le même appel arrive de nouveau. Chaque changement apparaît dans Journal complet comme une exécution à part, marquée Webhook. Voir BambooHR : Webhooks.
Calendrier et historique de synchronisation
Après la première synchronisation, Polzy tourne tout seul, à la fréquence choisie, à quelques minutes près. La ligne sous le nom de BambooHR indique la dernière synchronisation, sa fréquence, et le nombre de personnes et de groupes importés. Historique de synchro liste les cinq dernières exécutions — Réussi, Partiel (certaines personnes ont été ignorées ou ont échoué), Échec ou Aperçu — et Journal complet ouvre chaque exécution, avec chaque modification qu’elle a faite.
Si une synchronisation échoue, Polzy réessaie plus tard, en attendant un peu plus à chaque fois. Après trois échecs d’affilée, ou immédiatement quand BambooHR refuse la clé, la source affiche Nécessite une action et les administrateurs sont prévenus. Synchroniser maintenant fonctionne de nouveau une fois la source reconnectée : corrigez la clé sous Paramètres et enregistrez.
Quand quelqu’un part
- Parti selon BambooHR. Une personne qui a une date de départ ou le statut Terminated est désactivée à la synchronisation suivante, ou aussitôt avec un webhook. Les personnes désactivées ne reçoivent aucune enquête et n’occupent aucune place ; leurs réponses passées restent.
- Disparu de BambooHR. Avec Désactiver les employés partis activé, une personne qui n’apparaît plus du tout dans BambooHR est elle aussi désactivée.
- Bloqué dans Polzy. Une personne qu’un administrateur a bloquée dans Polzy reste bloquée, quoi que dise BambooHR.
Une synchronisation ne supprime jamais personne.
Dépannage
| Ce que vous voyez | Pourquoi | Que faire |
|---|---|---|
| BambooHR refused this API key: … The key needs report access. | La clé a été révoquée, son utilisateur a été désactivé, ou cet utilisateur ne peut pas exécuter de rapports. | Créez une clé avec un utilisateur qui a accès aux rapports et collez-la sous Paramètres. |
| Failed to fetch from BambooHR | BambooHR était injoignable, ou le sous-domaine est faux. | Vérifiez le sous-domaine, puis choisissez Synchroniser maintenant. |
| Tout le monde apparaît actif, y compris les partants | L’utilisateur de la clé ne voit pas les dates de départ ni le statut. | Donnez à cet utilisateur l’accès à ces champs dans BambooHR. |
| Les changements par webhook n’arrivent jamais | Aucun Secret du webhook n’est enregistré, il ne correspond pas à la clé privée, ou l’adresse est fausse. | Générez une nouvelle clé privée, collez-la dans Secret du webhook et vérifiez l’URL dans BambooHR. |
| N personnes n’ont pas été importées : le forfait n’a plus de places. | Chaque membre occupe une place, et l’offre est complète. | Libérez des places ou changez d’offre, puis choisissez Synchroniser maintenant. |
| … importe déjà des personnes. Déconnectez-le avant d’en connecter un autre. | Un espace de travail se synchronise depuis une seule source à la fois, et une autre est connectée. | Ouvrez les Paramètres de cette source et choisissez d’abord Déconnecter. |
Bon à savoir
- Des membres, pas des contacts. Toutes les personnes venues de BambooHR sont des membres : elles peuvent se connecter et chacune occupe une place. Une synchronisation qui dépasserait vos places importe les personnes qui tiennent, s’arrête là et prévient les administrateurs — voir Utilisation et limites.
- Le webhook est facultatif. Les synchronisations planifiées continuent avec ou sans lui, et rattrapent tout ce qu’un webhook aurait manqué.
- Déconnecter ou supprimer. Sous Paramètres, Déconnecter arrête la synchronisation et garde les paramètres et l’historique, pour reconnecter plus tard ; Supprimer efface la connexion. Dans les deux cas, les personnes déjà synchronisées restent dans Polzy et ne sont plus mises à jour.
- Besoin d’aide ? Le lien Demander à Polzy du panneau de connexion explique où trouver chaque valeur dans BambooHR.
Liens utiles
- BambooHR : Getting started with the API — créer une clé API et trouver votre sous-domaine.
- BambooHR : Webhooks — comment BambooHR envoie et signe les changements.
- Personnes et contacts — champs, groupes et membres.
Articles liés
Les membres connectés peuvent demander à Polzy ou écrire à l’équipe depuis Support. Notre délai de réponse dépend de votre forfait.