Compartilhar via

Conector do Microsoft Graph do Salesforce

  • Artigo

O conector do Microsoft Graph do Salesforce permite que a sua organização indexe contactos, oportunidades, oportunidades potenciais, casos e objetos de contas na sua instância do Salesforce. Depois de configurar o conector e o conteúdo do índice a partir do Salesforce, os utilizadores finais podem procurar esses itens a partir de qualquer cliente microsoft Search e Microsoft 365 Copilot.

Este artigo destina-se a qualquer pessoa que configure, execute e monitorize um conector do Microsoft Graph do Salesforce. Complementa o processo de configuração geral e mostra instruções que se aplicam apenas ao conector do Microsoft Graph do Salesforce. Este artigo também inclui informações sobre Limitações.

Importante

O conector do Microsoft Graph do Salesforce suporta atualmente o Verão de 19 ou posterior.

Antes de começar

Para ligar à instância do Salesforce, precisa do URL da instância do Salesforce, do ID de cliente e do segredo do cliente para a autenticação OAuth. Os passos seguintes explicam como o utilizador ou o administrador do Salesforce podem obter estas informações a partir da sua conta do Salesforce:

  • Inicie sessão na instância do Salesforce e aceda a Configuração

  • Navegue para Aplicações -> Gestor de Aplicações.

  • Selecione Nova aplicação ligada.

  • Conclua a secção API da seguinte forma:

    • Selecione a caixa de verificação Ativar definições de Oauth.

    • Especifique o URL de Chamada de Retorno como: Para M365 Enterprise: https://gcs.office.com/v1.0/admin/oauth/callback, para M365 Government: https://gcsgcc.office.com/v1.0/admin/oauth/callback

    • Selecione estes âmbitos OAuth necessários.

      • Aceda e faça a gestão dos seus dados (API).

      • Efetue pedidos em seu nome em qualquer altura (refresh_token, offline_access).

    • Selecione a caixa de verificação Exigir segredo para o fluxo do servidor Web.

    • Guarde a aplicação.

      Secção API na instância do Salesforce depois de o administrador ter introduzido todas as configurações necessárias listadas acima.

  • Copie a chave de consumidor e o segredo do consumidor. Estas informações são utilizadas como o ID de cliente e o segredo do cliente quando configura as definições de ligação para o conector do Microsoft Graph do Salesforce no portal de administração do Microsoft 365.

    Resultados devolvidos pela secção API na instância do Salesforce depois de o administrador ter submetido todas as configurações necessárias. A Chave de Consumidor está na parte superior da coluna esquerda e o Segredo do Consumidor está na parte superior da coluna direita.

  • Antes de fechar a instância do Salesforce, siga estes passos para garantir que os tokens de atualização não expiram:

    • Aceda a Aplicações –> Gestor de Aplicações.
    • Localize a aplicação que criou e selecione o menu pendente à direita. Selecione Gerenciar.
    • Selecione editar políticas.
    • Para a política de token de atualização, selecione O token de atualização é válido até ser revogado.

    Selecione a Política de Token de Atualização com o nome

Agora, pode utilizar o Centro de Administração Microsoft 365 para concluir o resto do processo de configuração do seu conector do Microsoft Graph.

Passo 1: adicionar um conector no Centro de administração do Microsoft 365

Adicionar conector do Salesforce

Siga as instruções de configuração gerais.

Passo 2: atribuir um nome à ligação

Siga as instruções de configuração gerais.

Passo 3: Configurar as definições de ligação

Para o URL da Instância, utilize https://[domínio].my.salesforce.com em que o domínio seria o domínio do Salesforce para a sua organização.

Introduza o ID de cliente e o Segredo do cliente que obteve na sua instância do Salesforce e selecione Iniciar sessão.

Quando tentar iniciar sessão pela primeira vez com estas definições, receberá um pop-up a pedir-lhe para iniciar sessão no Salesforce com o seu nome de utilizador e palavra-passe de administrador. A captura de ecrã abaixo mostra o pop-up. Introduza as suas credenciais e selecione "Iniciar Sessão".

Pop-up de início de sessão a pedir nome de utilizador e palavra-passe.

Observação

Se o pop-up não aparecer, poderá estar a ser bloqueado no browser, pelo que tem de permitir pop-ups e redirecionamentos.

Verifique se a ligação foi bem-sucedida ao procurar uma faixa verde que diga "ligação com êxito", conforme mostrado na captura de ecrã abaixo.

Captura de ecrã a mostrar o início de sessão com êxito. A faixa verde que diz

Passo 4: selecionar propriedades

Selecione os objetos do Salesforce que pretende que o conector pesquise e inclua nos resultados da pesquisa. Se a opção Contacto estiver selecionada, a opção Conta também é selecionada automaticamente.

Observação

Se um campo tiver segurança ao nível do campo (FLS) definida para um perfil, o conector não ingere esse campo para quaisquer perfis nessa organização do Salesforce. Como resultado, os utilizadores não poderão procurar valores para esses campos nem aparecer nos resultados.

Filtrar dados

Pode continuar a optar por filtrar os conteúdos do Salesforce indexados de duas formas:

  • Especifique o período de tempo modificado do item. Esta opção só indexará os conteúdos do Salesforce criados ou modificados no período de tempo selecionado sem interrupções com base na pesquisa atual.
  • Introduza a consulta do Salesforce (SOQL) que especifica o que pretende indexar com a cláusula WHERE .

Captura de ecrã das opções de filtragem no conector do Salesforce

Dica

Pode deixar a cláusula WHERE vazia se quiser indexar todo o conteúdo da entidade específica

Passo 5: Gerir permissões de pesquisa

Terá de escolher os utilizadores que veem os resultados da pesquisa desta origem de dados. Se permitir que apenas determinados utilizadores Microsoft Entra ID ou não Azure AD vejam os resultados da pesquisa, certifique-se de que mapeia as identidades.

Passo 5.a: Selecionar permissões

Pode optar por ingerir Controle de Acesso Listas (ACLs) da sua instância do Salesforce ou permitir que todas as pessoas na sua organização vejam os resultados da pesquisa desta origem de dados. As ACLs podem incluir identidades Microsoft Entra (utilizadores federados do Microsoft Entra ID para o Salesforce), identidades não Azure AD (utilizadores nativos do Salesforce que têm identidades correspondentes no Microsoft Entra ID) ou ambos.

Observação

Se utilizar um Fornecedor de Identidade de terceiros, como Ping ID ou secureAuth, deve selecionar "non-AAD" como o tipo de identidade.

Selecione o ecrã de permissões que foi concluído por um administrador. O administrador selecionou a opção

Se optou por ingerir uma ACL a partir da sua instância do Salesforce e selecionou "não AAD" para o tipo de identidade, consulte Mapear as identidades não Azure AD para obter instruções sobre como mapear as identidades.

Passo 5.b: Mapear identidades Microsoft Entra

Se optou por ingerir uma ACL a partir da sua instância do Salesforce e selecionou "AAD" para o tipo de identidade, consulte Mapear as suas identidades de Microsoft Entra para obter instruções sobre como mapear as identidades. Para saber como configurar Microsoft Entra SSO para o Salesforce, veja este tutorial.

Aplicar o mapeamento de utilizadores para sincronizar as identidades do Salesforce com Microsoft Entra identidades

Neste vídeo, pode ver o processo de autenticação na sua instância do Salesforce, sincronizar as suas identidades não Microsoft Entra com as suas identidades Microsoft Entra e aplicar as limitações de segurança adequadas aos seus itens do Salesforce.

Passo 6: Atribuir etiquetas de propriedade

Pode atribuir uma propriedade de origem a cada etiqueta ao escolher a partir de um menu de opções. Embora este passo não seja obrigatório, ter algumas etiquetas de propriedade melhora a relevância da pesquisa e garante melhores resultados de pesquisa para os utilizadores finais. Por predefinição, algumas das Etiquetas como "Título", "URL", "CreatedBy" e "LastModifiedBy" já foram atribuídas propriedades de origem.

A lista de propriedades que selecionar aqui pode afetar a forma como pode filtrar, procurar e ver os resultados em Microsoft 365 Copilot.

Propriedade Source Label Descrição
Autores authors Nome das pessoas que participaram/colaboraram no item na origem de dados.
CreatedBy createdBy Nome da pessoa que criou o item na fonte de dados.
CreatedDate createdDateTime Data e hora em que o item foi criado na origem de dados.
Url url A URL de destino do item na fonte de dados.
LastModifiedBy lastModifiedBy Nome da pessoa que editou o item mais recentemente na fonte de dados.
DataeHoraDaÚltimaModificação lastModifiedDateTime Data e hora em que o item foi modificado pela última vez na origem de dados.
Nome title O título do item que pretende mostrar na pesquisa e noutras experiências.

Passo 7: Gerir o esquema

Pode selecionar que propriedades de origem devem ser indexadas para que sejam apresentadas nos resultados da pesquisa. Por predefinição, o assistente de ligação seleciona um esquema de pesquisa com base num conjunto de propriedades de origem. Pode modificá-lo ao selecionar as caixas de marcar para cada propriedade e atributo na página de esquema de pesquisa. Os atributos de esquema de pesquisa incluem Pesquisa, Consulta, Obter e Refinar. Refinar permite-lhe definir as propriedades que podem ser utilizadas posteriormente como refinadores personalizados ou filtros na experiência de pesquisa.

Selecione o esquema para cada propriedade de origem. As opções são Consulta, Pesquisa, Obter e Refinar.

Passo 8: Definir a agenda de atualização

O conector do Salesforce só suporta agendas de atualização para pesquisas completas atualmente.

Importante

Uma pesquisa completa localiza os objetos eliminados e os utilizadores que foram sincronizados anteriormente com o índice do Microsoft Search.

A agenda recomendada é de uma semana para uma pesquisa completa.

Passo 9: Rever a ligação

Siga as instruções de configuração gerais.

Dica

Tipo de resultado predefinido

  • O conector do Salesforce regista automaticamente um tipo de resultado assim que o conector for publicado. O tipo de resultado utiliza um esquema de resultados gerado dinamicamente com base nos campos selecionados no passo 3.
  • Pode gerir o tipo de resultado ao navegar para Tipos de resultados no Centro de administração do Microsoft 365. O tipo de resultado predefinido chama-se "ConnectionIdPredefinição". Por exemplo, se o seu ID de ligação for Salesforce, o esquema de resultados tem o nome: "SalesforceDefault".
  • Além disso, pode optar por criar o seu próprio tipo de resultado, se necessário.

Limitações

  • Atualmente, o conector do Microsoft Graph do Salesforce não suporta partilhas e partilhas baseadas no território baseadas em Apex através de grupos pessoais do Salesforce.
  • Existe um erro conhecido na API do Salesforce que o conector utiliza, em que as predefinições privadas em toda a organização para oportunidades potenciais não são atualmente respeitadas.
  • Se um campo tiver segurança ao nível do campo (FLS) definida para um perfil, o conector não ingere esse campo para quaisquer perfis nessa organização do Salesforce. Como resultado, os utilizadores não poderão procurar valores para esses campos nem aparecer nos resultados.
  • No ecrã gerir esquema, estes nomes de propriedade padrão comuns são listados uma vez, as opções são Consulta, Pesquisa, Obter e Refinar e aplicam-se a todos ou a nenhum.
    • Nome
    • Url
    • Descrição
    • Fax
    • Telefone
    • MobilePhone
    • Email
    • Tipo
    • Título
    • AccountId
    • AccountName
    • AccountUrl
    • AccountOwner
    • AccountOwnerUrl
    • Proprietário
    • OwnerUrl
    • CreatedBy
    • CreatedByUrl
    • LastModifiedBy
    • LastModifiedByUrl
    • LastModifiedDate
    • ObjectName

Solução de problemas

Depois de publicar a ligação, pode rever a status no separador Origens de Dados no centro de administração. Para saber como fazer atualizações e eliminações, consulte Gerir o conector.

Pode encontrar passos de resolução de problemas frequentemente vistos aqui.

Se tiver problemas ou quiser fornecer comentários, contacte o Microsoft Graph | Suporte.