Freigeben über

BambooHR Microsoft 365 Copilot Connector

Der Microsoft 365 Copilot-Connector für Personendaten ermöglicht Organisationen das Indizieren von Daten aus externen Systemen, einschließlich BambooHR, in Microsoft 365. Der BambooHR Microsoft 365 Copilot-Connector ermöglicht Es Organisationen, Profile von BambooHR in Microsoft Graph zu indizieren, um sie über Microsoft 365-Umgebungen zugänglich zu machen, einschließlich Microsoft 365 Copilot und Microsoft Search.

Dieser Leitfaden richtet sich an Microsoft 365-Administratoren oder alle Personen, die für die Konfiguration, Verwaltung und Überwachung des BambooHR Copilot-Connectors verantwortlich sind.

Das folgende Video bietet eine Übersicht über den BambooHR-Connector.

Funktionen

  • Die umfassende Profilindizierung synchronisiert automatisch wichtige Mitarbeiterinformationen von BambooHR, einschließlich Namen, Kontaktdetails, Stellenbezeichnungen, Abteilungen, Einstellungsdaten und Organisationshierarchie.
  • Verbesserte Microsoft 365 Copilot ermöglichen es Ihren Endbenutzern, Fragen in natürlicher Sprache zu Kollegen zu stellen und intelligente Antworten basierend auf BambooHR-Profildaten zu erhalten. Verwenden Sie die semantische Suche in Copilot, um Benutzern zu helfen, relevante Kollegen basierend auf Schlüsselwörtern, Fähigkeiten, Abteilungen, Standorten und Organisationsbeziehungen zu finden.
  • Die Echtzeitdatensynchronisierung hält die Mitarbeiterinformationen mit standardmäßigen inkrementellen Synchronisierungen alle 15 Minuten und einer täglichen vollständigen Synchronisierung auf dem neuesten Stand.
  • Die nahtlose Microsoft 365-Integration macht Profildaten in Microsoft 365-Umgebungen auffindbar, was die Zusammenarbeit und das Bewusstsein der Organisation verbessert.
  • Die automatisierte Identitätszuordnung stimmt bambooHR-Profile intelligent mit Microsoft Entra ID Benutzern ab, um eine genaue plattformübergreifende Identitätskorrelation zu ermöglichen.

Weitere Informationen finden Sie unter Microsoft 365 Copilot Connector für Personendaten.

Hinweis

Wenn Sie Copilot nach einer Person fragen, wird das Zitat als office.com anstelle von BambooHR angezeigt, da Profilinformationen in Microsoft 365 aus mehreren Quellen stammen können. Beispielsweise können Stellentitel von BambooHR stammen, während Namen und andere Details von Microsoft Entra oder anderen verbundenen Systemen stammen können.

Begrenzungen

  • Der Datenindizierungsbereich konzentriert sich auf kerne Mitarbeiterprofilinformationen, um Microsoft 365-Erfahrungen und Copilot zu optimieren. Freizeit, Dokumente, Vorteile, Schulungen, Ressourcen, Notizen, Notfall, Onboarding, Offboarding und benutzerdefinierte Eigenschaften liegen außerhalb des aktuellen Indizierungsbereichs.
  • Zugriffsberechtigungen ermöglichen es dem Connector, Profildaten zu indizieren, auf die alle Benutzer in Ihrem Microsoft-Mandanten zugreifen können, um eine umfassende Auffindbarkeit von Mitarbeiterinformationen in Microsoft 365-Umgebungen und Copilot sicherzustellen. In zukünftigen Updates werden differenzierte Berechtigungssteuerelemente auf Benutzerebene verfügbar sein.
  • Die Identitätszuordnung erfordert, dass geschäftliche E-Mail-Adressen in BambooHR mit dem UserPrincipalName (UPN) oder den E-Mail-Adressen in Microsoft Entra übereinstimmen, um eine erfolgreiche Profilzuordnung zu erzielen. Dies stellt eine genaue Identitätskorrelation zwischen Systemen sicher.
  • Bei der Schemakonfiguration wird ein vordefinierter Satz von Mitarbeiterprofileigenschaften verwendet, die für die Integration von Microsoft 365 und Copilot optimiert sind. Eine vollständige Liste der indizierten Eigenschaften finden Sie in der Schemazuordnungstabelle.
  • Der Aktive Mitarbeiterfokus filtert automatisch so, dass nur aktive Mitarbeiter einbezogen werden, um sicherzustellen, dass Ihr Microsoft 365-Verzeichnis und Copilot die aktuelle Organisationsstruktur widerspiegeln.

    Hinweis

    BambooHR behandelt Mitarbeiter ohne ausgefüllten Einstellungsdatum (oder ursprünglichen Einstellungsdatum) als inaktiv, und diese Profile sind von der Indizierung ausgeschlossen.

Voraussetzungen

  1. Greifen Sie auf das BambooHR-Entwicklerportal zu, und melden Sie sich mit Den Anmeldeinformationen Ihres vorhandenen BambooHR-Entwicklerkontos an, oder erstellen Sie ein neues Entwicklerkonto, falls Sie noch keins besitzen. Beachten Sie, dass das Entwicklerportal von Ihren wichtigsten BambooHR-instance getrennt ist und speziell zum Erstellen und Verwalten von API-Anwendungen verwendet wird, die in BambooHR integriert werden.

  2. Erstellen Sie im Entwicklerportal eine neue BambooHR-App, indem Sie einen eindeutigen Anwendungsnamen angeben (z. B. "Microsoft 365 Copilot Connector" oder den Namen Ihres organization).

    Screenshot: Anwendung hinzufügen

  3. Fügen Sie im Abschnitt mit den App-Details die Umleitungs-URL hinzu, die Microsoft 365 für die Kommunikation mit BambooHR während der Authentifizierung verwendet. Kopieren Sie diese URL, und fügen Sie sie ein: https://gcs.office.com/v1.0/admin/oauth/callback

    Screenshot der App-Details.

    Screenshot des Formulars

  4. Wählen Sie im Abschnitt Anwendungsbereiche die erforderlichen Berechtigungen aus, die dem Connector den Zugriff auf bestimmte Mitarbeiterdaten von BambooHR ermöglichen. Wählen Sie die folgenden Bereiche mit schreibgeschütztem Zugriff aus, um sicherzustellen, dass der Connector die erforderlichen Profilinformationen abrufen kann:

    Kategorie Erforderliche Bereiche
    Anspruch email
    openid
    Mitarbeiter Arbeitnehmer
    employee:contact
    employee:identification
    employee:job
    employee:management
    employee:name
    employee_directory
    sensitive_employee:protected_info
    Sonstiges Feld
    offline_access
    public.user
    Berichte Bericht

    Screenshot: Bereiche auswählen.

    Screenshot der Bereichsauswahl.

  5. Navigieren Sie zum Abschnitt App-Anmeldeinformationen , um die App-Client-ID und den geheimen App-Clientschlüssel abzurufen. Diese Anmeldeinformationen werden während des Setups verwendet, um den Microsoft 365-Connector bei Ihrer BambooHR-Anwendung zu authentifizieren.

    Screenshot: Abschnitt

Erste Schritte

Fügen Sie bambooHR Microsoft 365 Copilot Connector hinzu.

Screenshot: Hinzufügen des BambooHR Microsoft 365 Copilot-Connectors aus dem Katalog.

1. Auswählen eines Anzeigenamens

Wählen Sie einen Anzeigenamen aus, z. B. BambooHR Profiles, mit dem Benutzer zugeordnete Profile in einer Copilot-Antwort leicht erkennen können.

2. Hinzufügen der instance-URL

Geben Sie Ihre BambooHR-instance-URL ein, z. B.https://contoso.bamboohr.com/

3. Authentifizierungstyp auswählen

Wählen Sie OAuth 2.0 aus der Liste der Authentifizierungstypen aus, und geben Sie die Client-ID und den geheimen Clientschlüssel aus Ihrem BambooHR-Entwicklerportal ein. Wenn Sie auf Autorisieren klicken, müssen Sie sich mit Ihren Administratoranmeldeinformationen aus dem BambooHR-instance anmelden, der Ihre Mitarbeiterdaten enthält, und den erforderlichen Berechtigungen zustimmen.

Für andere Einstellungen, z. B. Zugriffsberechtigungen, Dateneinschlussregeln, Schema, Durchforstungshäufigkeit usw., legen wir Standardwerte fest, basierend auf dem, was am besten mit Daten in BambooHR funktioniert. Die Standardwerteinstellungen sind wie folgt.

Seite Einstellungen Standardwerte
Benutzer Zugriffsberechtigungen

Hinweis: Alle Daten, die über den BambooHR Copilot-Connector abgerufen werden, sind für alle Personen in Ihrem Microsoft-Mandanten sichtbar. Wir ändern jedoch nicht das Verhalten des Systems, z. B. die Einhaltung von Zugriffseinschränkungen. Wenn ein Benutzer daran gehindert wird, die Profildaten eines anderen Benutzers anzuzeigen, werden diese Profildaten (einschließlich BambooHR Copilot-Daten) nicht freigegeben oder in der Ansicht des blockierten Benutzers gespeichert. Zugriffsbeschränkte Daten werden in zukünftigen Updates enthalten sein, wenn Berechtigungssteuerelemente auf Benutzerebene implementiert werden.		 Alle Profile sind für jeden zugänglich.
Zuordnen von Identitäten Datenquellenidentitäten, die mithilfe von Microsoft Entra-IDs zugeordnet werden.
Synchronisieren Inkrementelle Durchforstung Häufigkeit: alle 15 Minuten.
Synchronisieren Vollständige Durchforstung Häufigkeit: jeden Tag.
Schemaeigenschaft Beschreibung Eigenschaft im Microsoft 365-Benutzerprofilschema
Vorname Vorname des Mitarbeiters name-first>
Nachname Nachname des Mitarbeiters name-last>
Name Vollständige Namen des Mitarbeiters names-displayName>
E-Mail Geschäftliche E-Mail-Adresse des Mitarbeiters emails-address>[type='work']

Hinweis: Email wird in die Microsoft Entra objectId des Endbenutzers konvertiert und für die interne Verarbeitung verwendet.
Geburtsdatum Geburtsdatum des Mitarbeiters anniversaries-date>[type='birthday']
Stelleninformationsabteilung Stellenabteilung des Mitarbeiters, z. B. Personalwesen positions-detail-company-department>>>
Abteilung "Auftragsinformationen" Die Arbeitsteilung des Mitarbeiters, z. B. Nordamerika position-detail-company-division>>>
Mitarbeiternummer Mitarbeiternummer position-detail-employeeId>>
Mitarbeiter-Eeid Mitarbeiter-ID in BambooHR webAccounts-userId>

Hinweis: Die eeid des Mitarbeiters wird auch intern verwendet, um regelmäßig nach Updates für einen bestimmten Mitarbeiter in BambooHR zu suchen.
Beschäftigung status Mitarbeiterstatus, z. B. Vollzeit, Auftragnehmer usw. position-detail-employeeType>>
Ursprüngliche Einstellungsdatum Uhrzeit Einstellungsdatum des Mitarbeiters anniversaries-date>[type='originalHireDate']
Uhrzeit des Einstellungsdatums Einstellungsdatum des Mitarbeiters

Hinweis: Wenn die Uhrzeit des ursprünglichen Einstellungsdatums NULL ist, indizieren wir die Uhrzeit des Einstellungsdatums.		 anniversaries-date>[type='originalHireDate']
Stelleninformationen Berufsbezeichnung Position des Mitarbeiters, z. B. Senior HR Administrator positions-detail-jobTitle>>
Supervisor-ID Bezeichner des Vorgesetzten des Mitarbeiters positions-manager-userId>>

Hinweis: Die Supervisor-ID wird verwendet, um die E-Mail-Adresse des Vorgesetzten zu finden, die dann zur internen Verarbeitung in die Microsoft Entra ObjectId des Managers konvertiert wird.
Mobiltelefon Arbeitshandy des Mitarbeiters phones-number>(type=mobile)
Telefon (Arbeit) Arbeitstelefon des Mitarbeiters phones-number>(type=work)
Speicherort der Auftragsinformationen Bürostandort des Mitarbeiters positions-positionDetail-companyDetail-officeLocation>>>
Status Mitarbeiter-status, z. B. aktiv oder inaktiv Nicht zutreffend

Hinweis: Interne Verwendung zum Filtern inaktiver Mitarbeiter, um sicherzustellen, dass sie vom BambooHR-Datenabruf ausgeschlossen sind.

Benutzerdefinierte Einrichtung

Im benutzerdefinierten Setup können Sie jeden der Standardwerte für Benutzer, Inhalte und Synchronisierung bearbeiten.

Benutzer

Der BambooHR Copilot-Connector unterstützt nur Daten, die für jeden sichtbar sind. Dies bedeutet, dass indizierte Daten in den Suchergebnissen für alle Benutzer angezeigt werden. Der BambooHR Copilot-Connector unterstützt nur das Zuordnen Ihrer Datenquellenidentitäten zu Microsoft Entra ID, indem überprüft wird, ob die E-Mail-Adresse von BambooHR-Profilen mit UserPrincipalName (UPN) oder der E-Mail-Adresse von Benutzern in Microsoft Entra ID identisch ist.

Inhalt

Der BambooHR Copilot-Connector unterstützt weder das Hinzufügen neuer Eigenschaften noch das Entfernen vorhandener Eigenschaften auf dieser Registerkarte. Auf dieser Registerkarte befindet sich eine Eigenschaft namens annotationSerialized, die alle zuvor erwähnten Standardeigenschaften umfasst.

Synchronisieren

Das Aktualisierungsintervall bestimmt, wie oft Ihre Daten zwischen der Datenquelle und dem BambooHR Copilot-Connectorindex synchronisiert werden. Es gibt zwei Arten von Aktualisierungsintervallen: vollständige Durchforstung und inkrementelle Durchforstung. Weitere Informationen finden Sie unter Aktualisierungseinstellungen.

Nächste Schritte

Nachdem Sie Ihre Verbindung veröffentlicht haben, können Sie die status im Abschnitt Connectors des Admin Centers überprüfen. Informationen zum Durchführen von Updates und Löschungen finden Sie unter Verwalten ihres Connectors.

Wenn Sie Probleme haben oder Feedback geben möchten, finden Sie weitere Informationen unter Microsoft Graph-Support.

  • Last updated on