Partager via

Connecteur Microsoft 365 Copilot BambooHR

Le connecteur Microsoft 365 Copilot pour les données de personnes permet aux organisations d’indexer des données provenant de systèmes externes, y compris BambooHR, dans Microsoft 365. Le connecteur bambooHR Microsoft 365 Copilot permet aux organisations d’indexer les profils de BambooHR dans Microsoft Graph pour les rendre accessibles dans les expériences Microsoft 365, y compris Microsoft 365 Copilot et Recherche Microsoft.

Ce guide s’adresse aux administrateurs Microsoft 365 ou à toute personne responsable de la configuration, de la gestion et de la surveillance du connecteur BambooHR Copilot.

La vidéo suivante fournit une vue d’ensemble du connecteur BambooHR.

Fonctionnalités

  • L’indexation complète des profils synchronise automatiquement les informations essentielles des employés à partir de BambooHR, notamment les noms, les coordonnées, les postes, les services, les dates d’embauche et la hiérarchie organisationnelle.
  • Les expériences Microsoft 365 Copilot améliorées permettent à vos utilisateurs finaux de poser des questions en langage naturel sur leurs collègues et de recevoir des réponses intelligentes basées sur les données de profil BambooHR. Utilisez la recherche sémantique dans Copilot pour aider les utilisateurs à trouver des collègues pertinents en fonction des mots clés, des compétences, des services, des emplacements et des relations organisationnelles.
  • La synchronisation des données en temps réel maintient les informations des employés à jour avec des synchronisations incrémentielles par défaut toutes les 15 minutes et une synchronisation complète quotidiennement.
  • L’intégration transparente de Microsoft 365 rend les données de profil détectables dans les expériences Microsoft 365, ce qui améliore la collaboration et la sensibilisation de l’organisation.
  • Le mappage d’identité automatisé correspond intelligemment aux profils BambooHR avec Microsoft Entra ID utilisateurs pour une corrélation d’identité multiplateforme précise.

Pour plus d’informations, consultez Microsoft 365 Copilot connecteur pour les données de personnes.

Remarque

Lorsque vous interrogez Copilot sur une personne, la citation apparaît comme office.com au lieu de BambooHR, car les informations de profil dans Microsoft 365 peuvent provenir de plusieurs sources. Par exemple, les titres de poste peuvent provenir de BambooHR, tandis que les noms et autres détails peuvent provenir de Microsoft Entra ou d’autres systèmes connectés.

Limitations

  • L’étendue de l’indexation des données est axée sur les informations de profil des employés de base pour optimiser les expériences Microsoft 365 et Copilot. Les congés, les documents, les avantages, les formations, les ressources, les notes, les urgences, l’intégration, la désintégration et les propriétés personnalisées sont en dehors de l’étendue d’indexation actuelle.
  • Les autorisations d’accès permettent au connecteur d’indexer les données de profil accessibles à tous les utilisateurs de votre locataire Microsoft, ce qui garantit une large détectabilité des informations sur les employés dans les expériences Microsoft 365 et Copilot. Des contrôles d’autorisation granulaires au niveau de l’utilisateur seront disponibles dans les futures mises à jour.
  • Le mappage d’identité nécessite que les adresses e-mail professionnelles dans BambooHR correspondent à l’UPN (UserPrincipalName) ou aux adresses e-mail dans Microsoft Entra pour un mappage de profil réussi. Cela garantit une corrélation d’identité précise entre les systèmes.
  • La configuration du schéma utilise un ensemble prédéfini de propriétés de profil d’employé optimisées pour l’intégration de Microsoft 365 et Copilot. Pour obtenir la liste complète des propriétés indexées, consultez la table de mappage de schéma.
  • Le focus des employés actifs filtre automatiquement pour inclure uniquement les employés actifs, garantissant ainsi que votre annuaire Microsoft 365 et Copilot reflètent la structure organisationnelle actuelle.

    Remarque

    BambooHR traite les employés sans date d’embauche renseignée (ou d’embauche initiale) comme inactifs, et ces profils sont exclus de l’indexation.

Configuration requise

  1. Accédez au portail des développeurs BambooHR et connectez-vous avec vos informations d’identification de compte de développeur BambooHR existantes, ou créez un compte de développeur si vous n’en avez pas. Notez que le portail des développeurs est distinct de votre principal instance BambooHR et qu’il est utilisé spécifiquement pour créer et gérer des applications API qui s’intègrent à BambooHR.

  2. Dans le portail des développeurs, créez une application BambooHR en fournissant un nom d’application unique (par exemple, « connecteur Microsoft 365 Copilot » ou le nom de votre organization).

    Capture d’écran de l’ajout d’une application.

  3. Dans la section Détails de l’application, ajoutez l’URL de redirection que Microsoft 365 utilisera pour communiquer avec BambooHR pendant l’authentification. Copiez et collez cette URL exacte : https://gcs.office.com/v1.0/admin/oauth/callback

    Capture d’écran des détails de l’application.

    Capture d’écran du formulaire URL directes.

  4. Dans la section Étendues de l’application, sélectionnez les autorisations requises qui permettent au connecteur d’accéder à des données d’employés spécifiques à partir de BambooHR. Sélectionnez les étendues suivantes avec un accès en lecture seule pour vous assurer que le connecteur peut récupérer les informations de profil nécessaires :

    Catégorie Étendues requises
    Claims email
    openid
    Employé employé
    employee :contact
    employee :identification
    employee :job
    employee :management
    employee :name
    employee_directory
    sensitive_employee :protected_info
    Divers champ
    offline_access
    public.user
    Rapports rapport

    Capture d’écran de sélectionner des étendues.

    Capture d’écran de la sélection de l’étendue.

  5. Accédez à la section Informations d’identification de l’application pour obtenir l’ID client de l’application et la clé secrète client de l’application. Ces informations d’identification seront utilisées pour authentifier le connecteur Microsoft 365 auprès de votre application BambooHR lors de l’installation.

    Capture d’écran de l’ID client et de la section Clé secrète client.

Prise en main

Ajouter le connecteur Microsoft 365 Copilot BambooHR.

Capture d’écran de l’ajout d’un connecteur bambooHR Microsoft 365 Copilot à partir du catalogue.

1. Choisir un nom d’affichage

Choisissez un nom d’affichage, par exemple Profils BambooHR, qui permet aux utilisateurs de reconnaître facilement les profils associés dans une réponse Copilot.

2. Ajouter l’URL instance

Entrez votre URL de instance BambooHR, par exemple,https://contoso.bamboohr.com/

3. Choisir le type d’authentification

Sélectionnez OAuth 2.0 dans la liste des types d’authentification, puis entrez l’ID client et la clé secrète client à partir de votre portail des développeurs BambooHR. Quand vous cliquez sur Autoriser, vous devez vous connecter avec vos informations d’identification d’administrateur à partir du instance BambooHR contenant les données de vos employés et donner votre consentement aux autorisations requises.

Pour d’autres paramètres, tels que les autorisations d’accès, les règles d’inclusion des données, le schéma, la fréquence d’analyse, etc., nous définissons les valeurs par défaut en fonction de ce qui fonctionne le mieux avec les données dans BambooHR. Les paramètres de valeur par défaut sont les suivants.

Page Paramètres Valeurs par défaut
Utilisateurs Autorisations d’accès

Remarque : toutes les données récupérées via le connecteur BambooHR Copilot sont visibles par tous les membres de votre locataire Microsoft. Toutefois, nous ne modifions pas le comportement du système, comme le respect des restrictions d’accès. Si un utilisateur ne peut pas voir les données de profil d’un autre utilisateur, ces données de profil (y compris les données BambooHR Copilot) ne seront pas partagées ou stockées dans l’affichage de l’utilisateur bloqué. Les données d’accès restreint seront incluses dans les futures mises à jour lorsque les contrôles d’autorisation au niveau de l’utilisateur seront implémentés.		 Tous les profils sont accessibles à tous.
Identités des cartes Identités de source de données mappées à l’aide d’ID de Microsoft Entra.
Synchronisation Analyse incrémentielle Fréquence : toutes les 15 minutes.
Synchronisation Analyse complète Fréquence : tous les jours.
Propriété de schéma Description Propriété dans le schéma de profil utilisateur Microsoft 365
Prénom Prénom de l’employé noms d’abord>
Nom Nom de famille de l’employé noms-last>
Nom Noms complets de l’employé names-displayName>
E-mail Adresse e-mail professionnelle de l’employé email-address>[type='work']

Remarque : Email est converti en Microsoft Entra objectId de l’utilisateur final et est utilisé pour le traitement interne.
Date de naissance Date de naissance de l’employé anniversaries-date>[type='birthday']
Service d’informations sur le travail Le service du travail de l’employé, par exemple, les ressources humaines positions-detail-company-department>>>
Division des informations sur le travail La division du travail des employés, par exemple, Amérique du Nord position-detail-company-division>>>
Numéro d’employé Numéro de l’employé position-detail-employeeId>>
Eeid employé ID de l’employé dans BambooHR webAccounts-userId>

Remarque : l’eeid de l’employé est également utilisé en interne pour case activée périodiquement les mises à jour d’un employé donné dans BambooHR.
Status de l’emploi Statut de l’employé, par exemple, temps plein, entrepreneur, etc. position-detail-employeeType>>
Date et heure d’embauche d’origine Date d’embauche de l’employé anniversaries-date>[type='originalHireDate']
Date et heure de l’embauche Date d’embauche de l’employé

Remarque : Lorsque la date et l’heure d’embauche d’origine sont null, nous indexons la date et l’heure de l’embauche		 anniversaries-date>[type='originalHireDate']
Poste d’informations sur le poste Le poste de l’employé, par exemple, administrateur principal des ressources humaines positions-detail-jobTitle>>
ID du superviseur Identificateur du responsable de l’employé positions-manager-userId>>

Remarque : l’ID du superviseur est utilisé pour rechercher l’e-mail du superviseur, qui est ensuite converti en Microsoft Entra objectId du responsable pour le traitement interne.
Téléphone portable Téléphone mobile professionnel de l’employé phone-number>(type=mobile)
Téléphone professionnel Téléphone professionnel de l’employé phone-number>(type=work)
Emplacement des informations sur le travail Emplacement du bureau de l’employé positions-positionDetail-companyDetail-officeLocation>>>
Statut Les status de l’employé, par exemple, actif ou inactif S/O

Remarque : Utilisation interne pour filtrer les employés inactifs, en s’assurant qu’ils sont exclus de la récupération de données BambooHR.

Configuration personnalisée

Dans l’installation personnalisée, vous pouvez modifier l’une des valeurs par défaut pour les utilisateurs, le contenu et la synchronisation.

Utilisateurs

Le connecteur BambooHR Copilot prend uniquement en charge les données visibles par tout le monde. Cela signifie que les données indexées apparaissent dans les résultats de la recherche pour tous les utilisateurs. Le connecteur BambooHR Copilot prend uniquement en charge le mappage de vos identités de source de données avec Microsoft Entra ID en vérifiant si l’adresse e-mail des profils BambooHR est identique à UserPrincipalName (UPN) ou à l’adresse e-mail des utilisateurs dans Microsoft Entra ID.

Contenu

Le connecteur BambooHR Copilot ne prend pas en charge l’ajout de nouvelles propriétés ou la suppression de propriétés existantes sous cet onglet. Dans cet onglet, il existe une propriété nommée annotationSerialized qui englobe toutes les propriétés par défaut mentionnées précédemment.

Synchronisation

L’intervalle d’actualisation détermine la fréquence à laquelle vos données sont synchronisées entre la source de données et l’index du connecteur BambooHR Copilot. Il existe deux types d’intervalles d’actualisation : l’analyse complète et l’analyse incrémentielle. Pour plus d’informations, consultez Paramètres d’actualisation.

Étapes suivantes

Après avoir publié votre connexion, vous pouvez consulter les status dans la section Connecteurs du Centre d’administration. Pour savoir comment effectuer des mises à jour et des suppressions, consultez Gérer votre connecteur.

Si vous rencontrez des problèmes ou si vous souhaitez fournir des commentaires, consultez prise en charge de Microsoft Graph.

  • Last updated on