Partilhar via

Conector de Microsoft 365 Copilot BambooHR

O conector Microsoft 365 Copilot para dados de pessoas permite que as organizações indexem dados de sistemas externos, incluindo o BambooHR, para o Microsoft 365. O conector de Microsoft 365 Copilot BambooHR permite que as organizações indexem perfis do BambooHR para o Microsoft Graph para torná-los acessíveis em todas as experiências do Microsoft 365, incluindo Microsoft 365 Copilot e Microsoft Search.

Este guia destina-se a administradores do Microsoft 365 ou a qualquer pessoa responsável por configurar, gerir e monitorizar o conector BambooHR Copilot.

O vídeo seguinte fornece uma descrição geral do conector BambooHR.

Recursos

  • A indexação abrangente de perfis sincroniza automaticamente as informações essenciais dos colaboradores do BambooHR, incluindo nomes, detalhes de contacto, cargos, departamentos, datas de contratação e hierarquia organizacional.
  • As experiências de Microsoft 365 Copilot melhoradas permitem que os seus utilizadores finais façam perguntas de linguagem natural sobre colegas e recebam respostas inteligentes com base nos dados de perfil do BambooHR. Utilize a Pesquisa Semântica no Copilot para ajudar os utilizadores a encontrar colegas relevantes com base em palavras-chave, competências, departamentos, localizações e relações organizacionais.
  • A sincronização de dados em tempo real mantém as informações dos funcionários atualizadas com sincronizações incrementais predefinidas a cada 15 minutos e sincronização completa diariamente.
  • A integração totalmente integrada do Microsoft 365 torna os dados de perfil detetáveis em todas as experiências do Microsoft 365, melhorando a colaboração e a sensibilização organizacional.
  • O mapeamento de identidade automatizado corresponde de forma inteligente aos perfis do BambooHR com Microsoft Entra ID utilizadores para uma correlação de identidades entre plataformas precisa.

Para obter mais informações, veja Microsoft 365 Copilot conector para dados de pessoas.

Observação

Quando pergunta a Copilot sobre uma pessoa, a citação aparece como office.com em vez de BambooHR, porque as informações de perfil no Microsoft 365 podem ser provenientes de várias fontes. Por exemplo, os títulos de trabalho podem ser provenientes de BambooHR, enquanto os nomes e outros detalhes podem ser provenientes de Microsoft Entra ou de outros sistemas ligados.

Limitações

  • O âmbito da indexação de dados está focado nas informações principais do perfil dos colaboradores para otimizar as experiências do Microsoft 365 e o Copilot. As folgas, documentos, benefícios, formações, recursos, notas, emergência, inclusão, exclusão e propriedades personalizadas estão fora do âmbito de indexação atual.
  • As permissões de acesso permitem ao conector indexar dados de perfil acessíveis a todos os utilizadores no seu inquilino da Microsoft, garantindo uma ampla deteção das informações dos colaboradores nas experiências do Microsoft 365 e no Copilot. Os controlos de permissão granulares ao nível do utilizador estarão disponíveis em atualizações futuras.
  • O mapeamento de identidades requer endereços de e-mail de trabalho no BambooHR para corresponder ao UserPrincipalName (UPN) ou endereços de e-mail no Microsoft Entra para um mapeamento de perfil bem-sucedido. Isto garante uma correlação de identidade precisa entre sistemas.
  • A configuração do esquema utiliza um conjunto predefinido de propriedades de perfil de funcionário otimizadas para a integração do Microsoft 365 e copilot. Para obter uma lista completa das propriedades indexadas, veja a tabela de mapeamento de esquemas.
  • O foco dos colaboradores ativos filtra automaticamente para incluir apenas funcionários ativos, garantindo que o diretório do Microsoft 365 e o Copilot refletem a estrutura organizacional atual.

    Observação

    A BambooHR trata os funcionários sem uma data de contratação preenchida (ou contratação original) como inativos e estes perfis são excluídos da indexação.

Pré-requisitos

  1. Aceda ao portal do programador do BambooHR e inicie sessão com as credenciais existentes da conta de programador do BambooHR ou crie uma nova conta de programador se não tiver uma. Tenha em atenção que o portal do programador está separado da sua instância principal do BambooHR e é utilizado especificamente para criar e gerir aplicações de API que se integram com o BambooHR.

  2. No portal do programador, crie uma nova aplicação BambooHR ao fornecer um nome de aplicação exclusivo (por exemplo, "Microsoft 365 Copilot conector" ou o nome da sua organização).

    Captura de ecrã a mostrar a opção Adicionar aplicação.

  3. Na secção de detalhes da aplicação, adicione o URL de redirecionamento que o Microsoft 365 utilizará para comunicar com o BambooHR durante a autenticação. Copie e cole este URL exato: https://gcs.office.com/v1.0/admin/oauth/callback

    Captura de ecrã dos Detalhes da Aplicação.

    Captura de ecrã do formulário Urls Diretos.

  4. Na secção âmbitos da aplicação, selecione as permissões necessárias que permitem ao conector aceder a dados específicos dos colaboradores a partir do BambooHR. Selecione os seguintes âmbitos com acesso só de leitura para garantir que o conector consegue obter as informações de perfil necessárias:

    Categoria Escopos necessários
    Declarações email
    openid
    Funcionário funcionário
    employee:contact
    employee:identification
    employee:job
    employee:management
    employee:name
    employee_directory
    sensitive_employee:protected_info
    Diversos campo
    offline_access
    public.user
    Relatórios relatório

    Captura de ecrã a mostrar a opção Selecionar Âmbitos.

    Captura de ecrã a mostrar a Seleção de Âmbito.

  5. Navegue para a secção de credenciais da aplicação para obter o ID do cliente da aplicação e o segredo do cliente da aplicação. Estas credenciais serão utilizadas para autenticar o conector do Microsoft 365 com a sua aplicação BambooHR durante a configuração.

    Captura de ecrã a mostrar o ID de Cliente e a Secção Segredo do Cliente.

Introdução

Adicione conector de Microsoft 365 Copilot BambooHR.

Captura de ecrã a mostrar a adição do conector de Microsoft 365 Copilot BambooHR a partir do Catálogo.

1. Escolha um nome a apresentar

Escolha um nome a apresentar, por exemplo, Perfis BambooHR, que ajuda os utilizadores a reconhecer facilmente perfis associados numa resposta copilot.

2. Adicionar o URL da instância

Introduza o URL da instância de BambooHR, por exemplo, https://contoso.bamboohr.com/

3. Escolha o tipo de autenticação

Selecione OAuth 2.0 na lista de tipos de autenticação e introduza o ID de cliente e o segredo do cliente no portal do Programador do BambooHR. Quando clica em Autorizar, tem de iniciar sessão com as suas credenciais de administrador da instância do BambooHR que contém os dados dos seus funcionários e consentir as permissões necessárias.

Para outras definições, como permissões de acesso, regras de inclusão de dados, esquema, frequência de pesquisa, etc., definimos predefinições com base no que funciona melhor com os dados no BambooHR. As predefinições de valor são as seguintes.

Page Configurações Valores predefinidos
Usuários Permissões de Acesso

Nota: todos os dados obtidos através do conector BambooHR Copilot estão visíveis para todas as pessoas no seu inquilino da Microsoft. No entanto, não estamos a alterar o comportamento do sistema, como respeitar as restrições de acesso. Se um utilizador não conseguir ver os dados de perfil de outro utilizador, esses dados de perfil (incluindo os dados do BambooHR Copilot) não serão partilhados ou armazenados na vista do utilizador bloqueado. Os dados restritos de acesso serão incluídos em atualizações futuras quando forem implementados controlos de permissão ao nível do utilizador.		 Todos os perfis são acessíveis a qualquer pessoa.
Identidades do mapa Identidades de origem de dados mapeadas com Microsoft Entra IDs.
Sincronização Pesquisa incremental Frequência: a cada 15 minutos.
Sincronização Pesquisa completa Frequência: todos os dias.
Propriedade esquema Descrição Propriedade no esquema de perfil de utilizador do Microsoft 365
Nome Nome próprio do funcionário names-first>
Sobrenome Apelido do funcionário names-last>
Nome Nomes completos dos funcionários names-displayName>
Email Endereço de e-mail profissional do funcionário email-address>[type='work']

Nota: Email é convertido no Microsoft Entra objectId do utilizador final e é utilizado para processamento interno.
Data de nascimento Data de nascimento do funcionário anniversaries-date>[type='birthday']
Departamento de informações de tarefas Departamento de trabalhos dos funcionários, por exemplo, recursos humanos positions-detail-company-department>>>
Divisão de informações da tarefa Divisão de trabalhos dos funcionários, por exemplo, América do Norte position-detail-company-division>>>
Número do funcionário Número do funcionário position-detail-employeeId>>
Funcionário Eeid ID do funcionário em BambooHR webAccounts-userId>

Nota: o eeid do funcionário também é utilizado internamente para marcar periodicamente para quaisquer atualizações para um determinado Funcionário em BambooHR.
Status de emprego Estado do Funcionário, por exemplo, a tempo inteiro, empreiteiro, etc. position-detail-employeeType>>
Data e hora da contratação original Data de contratação do funcionário anniversaries-date>[type='originalHireDate']
Hora da data de contratação Data de contratação do funcionário

Nota: quando a data de contratação original é nula, indexamos a Data de Contratação		 anniversaries-date>[type='originalHireDate']
Cargo de tarefa de informações da tarefa Cargo de funcionário, por exemplo, Administrador de RH Sénior positions-detail-jobTitle>>
Supervisor ID Identificador do gestor do funcionário positions-manager-userId>>

Nota: o ID do supervisor é utilizado para localizar o e-mail do supervisor, que é depois convertido no Microsoft Entra objectId do gestor para processamento interno.
Telefone celular Telemóvel de trabalho do funcionário phones-number>(type=mobile)
Telefone comercial Telefone de trabalho do funcionário phones-number>(type=work)
Localização das informações da tarefa Localização do escritório do funcionário positions-positionDetail-companyDetail-officeLocation>>>
Status A status do funcionário, por exemplo, ativa ou inativa N/D

Nota: utilização interna para filtrar funcionários inativos, garantindo que são excluídos da obtenção de dados do BambooHR.

Configuração personalizada

Na configuração personalizada, pode editar qualquer um dos valores predefinidos para utilizadores, conteúdos e sincronização.

Usuários

O conector BambooHR Copilot só suporta dados visíveis para Todos. Isto significa que os dados indexados são apresentados nos resultados da pesquisa para todos os utilizadores. O conector BambooHR Copilot só suporta o mapeamento das suas identidades de origem de dados com Microsoft Entra ID ao verificar se o endereço de e-mail dos perfis do BambooHR é o mesmo que UserPrincipalName (UPN) ou o e-mail dos utilizadores no Microsoft Entra ID.

Conteúdo

O conector BambooHR Copilot não suporta a adição de novas propriedades nem a remoção de propriedades existentes neste separador. Neste separador, existe uma propriedade com o nome annotationSerialized que abrange todas as propriedades predefinidas mencionadas anteriormente.

Sincronização

O intervalo de atualização determina a frequência com que os dados são sincronizados entre a origem de dados e o índice do conector BambooHR Copilot. Existem dois tipos de intervalos de atualização: pesquisa completa e pesquisa incremental. Para obter mais informações, veja Definições de atualização.

Próximas etapas

Depois de publicar a ligação, pode rever a status na secção Conectores do centro de administração. Para saber como fazer atualizações e eliminações, consulte Gerir o conector.

Se tiver problemas ou quiser fornecer comentários, consulte Suporte do Microsoft Graph.

  • Last updated on