Compartir a través de

Conector de bambooHR Microsoft 365 Copilot

El conector de Microsoft 365 Copilot para datos de personas permite a las organizaciones indexar datos de sistemas externos, incluido BambooHR, en Microsoft 365. El conector de Microsoft 365 Copilot BambooHR permite a las organizaciones indexar perfiles de BambooHR en Microsoft Graph para que sean accesibles en todas las experiencias de Microsoft 365, incluidos Microsoft 365 Copilot y Microsoft Search.

Esta guía está destinada a administradores de Microsoft 365 o a cualquier persona responsable de configurar, administrar y supervisar el conector BambooHR Copilot.

En el vídeo siguiente se proporciona información general sobre el conector BambooHR.

Capacidades

  • La indexación completa de perfiles sincroniza automáticamente la información esencial de los empleados de BambooHR, incluidos los nombres, los detalles de contacto, los títulos de trabajo, los departamentos, las fechas de contratación y la jerarquía organizativa.
  • Las experiencias mejoradas de Microsoft 365 Copilot permiten a los usuarios finales formular preguntas en lenguaje natural sobre compañeros y recibir respuestas inteligentes basadas en datos de perfil de BambooHR. Use la búsqueda semántica en Copilot para ayudar a los usuarios a encontrar compañeros relevantes en función de palabras clave, aptitudes, departamentos, ubicaciones y relaciones organizativas.
  • La sincronización de datos en tiempo real mantiene actualizada la información de los empleados con sincronizaciones incrementales predeterminadas cada 15 minutos y sincronización completa diaria.
  • La integración perfecta de Microsoft 365 hace que los datos de perfil se puedan detectar en todas las experiencias de Microsoft 365, lo que mejora la colaboración y el reconocimiento de la organización.
  • La asignación automatizada de identidades coincide de forma inteligente con los perfiles de BambooHR con los usuarios de Microsoft Entra ID para una correlación de identidad multiplataforma precisa.

Para obtener más información, consulte Microsoft 365 Copilot conector para datos de personas.

Nota:

Cuando se pregunta a Copilot sobre una persona, la cita aparece como office.com en lugar de BambooHR, ya que la información del perfil de Microsoft 365 puede provenir de varias fuentes. Por ejemplo, los títulos de trabajos pueden proceder de BambooHR, mientras que los nombres y otros detalles pueden proceder de Microsoft Entra u otros sistemas conectados.

Limitaciones

  • El ámbito de indexación de datos se centra en la información básica del perfil de los empleados para optimizar las experiencias de Microsoft 365 y Copilot. El tiempo de expiración, los documentos, las ventajas, los entrenamientos, los recursos, las notas, la emergencia, la incorporación, la retirada y las propiedades personalizadas están fuera del ámbito de indexación actual.
  • Los permisos de acceso permiten al conector indexar los datos de perfil accesibles para todos los usuarios de su inquilino de Microsoft, lo que garantiza una amplia capacidad de detección de la información de los empleados en las experiencias de Microsoft 365 y Copilot. Los controles de permisos de nivel de usuario pormenorizados estarán disponibles en futuras actualizaciones.
  • La asignación de identidades requiere direcciones de correo electrónico de trabajo en BambooHR para que coincidan con userprincipalName (UPN) o direcciones de correo electrónico de Microsoft Entra para la asignación correcta de perfiles. Esto garantiza una correlación de identidad precisa entre sistemas.
  • La configuración de esquema usa un conjunto predefinido de propiedades de perfil de empleado optimizadas para la integración de Microsoft 365 y Copilot. Para obtener una lista completa de las propiedades indizadas, consulte la tabla de asignación de esquemas.
  • El enfoque activo de los empleados filtra automáticamente para incluir solo a los empleados activos, lo que garantiza que el directorio de Microsoft 365 y Copilot reflejen la estructura organizativa actual.

    Nota:

    BambooHR trata a los empleados sin una fecha de contratación rellenada (o contratación original) como inactiva, y estos perfiles se excluyen de la indexación.

Requisitos previos

  1. Acceda al portal para desarrolladores de BambooHR e inicie sesión con sus credenciales de cuenta de desarrollador de BambooHR existentes, o cree una nueva cuenta de desarrollador si no tiene ninguna. Tenga en cuenta que el portal para desarrolladores es independiente de la instancia de BambooHR principal y se usa específicamente para crear y administrar aplicaciones de API que se integran con BambooHR.

  2. En el portal para desarrolladores, cree una nueva aplicación BambooHR proporcionando un nombre de aplicación único (por ejemplo, "conector de Microsoft 365 Copilot" o el nombre de su organización).

    Captura de pantalla de Agregar aplicación.

  3. En la sección de detalles de la aplicación, agregue la dirección URL de redireccionamiento que Microsoft 365 usará para comunicarse con BambooHR durante la autenticación. Copie y pegue esta dirección URL exacta: https://gcs.office.com/v1.0/admin/oauth/callback

    Captura de pantalla de detalles de la aplicación.

    Captura de pantalla del formulario Direcciones URL directas.

  4. En la sección Ámbitos de aplicación, seleccione los permisos necesarios que permiten al conector acceder a datos específicos de empleados desde BambooHR. Seleccione los siguientes ámbitos con acceso de solo lectura para asegurarse de que el conector puede recuperar la información de perfil necesaria:

    Categoría Ámbitos necesarios
    Notificaciones correo electrónico
    OpenID
    Empleado empleado
    employee:contact
    employee:identification
    employee:job
    employee:management
    employee:name
    employee_directory
    sensitive_employee:protected_info
    Varios campo
    offline_access
    public.user
    Informes informe

    Captura de pantalla de Seleccionar ámbitos.

    Captura de pantalla de selección de ámbito.

  5. Vaya a la sección credenciales de la aplicación para obtener el identificador de cliente de la aplicación y el secreto de cliente de la aplicación. Estas credenciales se usarán para autenticar el conector de Microsoft 365 con la aplicación BambooHR durante la instalación.

    Captura de pantalla de la sección Id. de cliente y Secreto de cliente.

Introducción

Agregue bambooHR Microsoft 365 Copilot conector.

Captura de pantalla de Agregar bambooHR Microsoft 365 Copilot conector del catálogo.

1. Elija un nombre para mostrar.

Elija un nombre para mostrar, por ejemplo, BambooHR Profiles, que ayude a los usuarios a reconocer fácilmente los perfiles asociados en una respuesta de Copilot.

2. Agregar la dirección URL de la instancia

Escriba la dirección URL de la instancia de BambooHR, por ejemplo, https://contoso.bamboohr.com/

3. Elija el tipo de autenticación.

Seleccione OAuth 2.0 en la lista de tipos de autenticación y escriba el identificador de cliente y el secreto de cliente en el portal para desarrolladores de BambooHR. Al hacer clic en Autorizar, debe iniciar sesión con sus credenciales de administrador desde la instancia de BambooHR que contiene los datos de los empleados y dar su consentimiento a los permisos necesarios.

Para otras configuraciones, como los permisos de acceso, las reglas de inclusión de datos, el esquema, la frecuencia de rastreo, etc., establecemos valores predeterminados en función de lo que funciona mejor con los datos de BambooHR. La configuración predeterminada del valor es la siguiente.

Page Configuraciones Valores predeterminados
Usuarios Permisos de acceso

Nota: Todos los datos recuperados a través del conector BambooHR Copilot son visibles para todos los usuarios del inquilino de Microsoft. Sin embargo, no estamos cambiando el comportamiento del sistema, como respetar las restricciones de acceso. Si a un usuario se le impide ver los datos de perfil de otro usuario, esos datos de perfil (incluidos los datos de BambooHR Copilot) no se compartirán ni almacenarán en la vista del usuario bloqueado. Los datos restringidos por acceso se incluirán en futuras actualizaciones cuando se implementen controles de permisos de nivel de usuario.		 Todos los perfiles son accesibles para cualquier persona.
Asignar identidades Identidades de origen de datos asignadas mediante identificadores de Microsoft Entra.
Sincronizar Rastreo incremental Frecuencia: cada 15 minutos.
Sincronizar Rastreo completo Frecuencia: todos los días.
Schema (propiedad) Descripción Propiedad en el esquema de perfil de usuario de Microsoft 365
Nombre Nombre del empleado names-first>
Apellidos Apellidos del empleado names-last>
Nombre Nombres completos del empleado names-displayName>
Correo electrónico Dirección de correo electrónico del trabajo del empleado emails-address>[type='work']

Nota: Email se convierte en el Microsoft Entra objectId del usuario final y se usa para el procesamiento interno.
Fecha de nacimiento Fecha de nacimiento del empleado anniversaries-date>[type='birthday']
Departamento de información de trabajos Departamento de trabajo del empleado, por ejemplo, recursos humanos positions-detail-company-department>>>
División de información de trabajos División de trabajo del empleado, por ejemplo, Norteamérica position-detail-company-division>>>
Número de empleado Número del empleado position-detail-employeeId>>
Eeid de empleado Id. de empleado en BambooHR webAccounts-userId>

Nota: El eeid del empleado también se usa internamente para comprobar periódicamente si hay actualizaciones de un empleado determinado en BambooHR.
Estado del empleo Estado del empleado, por ejemplo, a tiempo completo, contratista, etc. position-detail-employeeType>>
Fecha de contratación original Fecha de contratación del empleado anniversaries-date>[type='originalHireDate']
Fecha de contratación Fecha de contratación del empleado

Nota: Cuando la hora de la fecha de contratación original es nula, indexamos la hora de la fecha de contratación.		 anniversaries-date>[type='originalHireDate']
Título del trabajo de información de trabajo Puesto de trabajo del empleado, por ejemplo, administrador sénior de RR. HH. positions-detail-jobTitle>>
Id. de supervisor Identificador del administrador del empleado positions-manager-userId>>

Nota: El identificador del supervisor se utiliza para encontrar el correo electrónico del supervisor, que luego se convierte en el Microsoft Entra objectId del administrador para el procesamiento interno.
Teléfono móvil Teléfono móvil del trabajo del empleado phones-number>(type=mobile)
Teléfono del trabajo Teléfono de trabajo del empleado phones-number>(type=work)
Ubicación de la información del trabajo Ubicación de la oficina del empleado positions-positionDetail-companyDetail-officeLocation>>>
Estado Estado del empleado, por ejemplo, activo o inactivo N/D

Nota: Uso interno para filtrar empleados inactivos, lo que garantiza que se excluyen de la recuperación de datos de BambooHR.

Configuración personalizada

En la configuración personalizada, puede editar cualquiera de los valores predeterminados para los usuarios, el contenido y la sincronización.

Usuarios

El conector BambooHR Copilot solo admite datos visibles para todos. Esto significa que los datos indexados aparecen en los resultados de búsqueda de todos los usuarios. El conector BambooHR Copilot solo admite la asignación de las identidades del origen de datos con Microsoft Entra ID comprobando si la dirección de correo electrónico de los perfiles de BambooHR es la misma que UserPrincipalName (UPN) o el correo electrónico de los usuarios de Microsoft Entra ID.

Contenido

El conector BambooHR Copilot no admite la adición de nuevas propiedades ni la eliminación de las propiedades existentes en esta pestaña. En esta pestaña, hay una propiedad denominada annotationSerialized que abarca todas las propiedades predeterminadas mencionadas anteriormente.

Sincronizar

El intervalo de actualización determina la frecuencia con la que se sincronizan los datos entre el origen de datos y el índice del conector de BambooHR Copilot. Hay dos tipos de intervalos de actualización: rastreo completo y rastreo incremental. Para obtener más información, vea Actualizar configuración.

Pasos siguientes

Después de publicar la conexión, puede revisar el estado en la sección Conectores del Centro de administración. Para obtener información sobre cómo realizar actualizaciones y eliminaciones, consulte Administración del conector.

Si tiene problemas o quiere proporcionar comentarios, consulte Soporte técnico de Microsoft Graph.

  • Last updated on