Compartilhar via

Conector do Microsoft Graph crm 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 administradores do Microsoft 365 ou a qualquer pessoa que configure, execute e monitorize um conector do Microsoft Graph crm do Salesforce.

Importante

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

Recursos

  • Indexar contactos, oportunidades, oportunidades potenciais, casos e objetos de contas na sua instância do Salesforce
  • Filtrar conteúdo com base no que pretende indexar
  • Aceder aos dados CRM do Salesforce com o poder da pesquisa semântica
  • Reter ACLs definidas pela sua organização
  • Personalizar a frequência de pesquisa
  • Criar agentes e fluxos de trabalho com esta ligação e plug-ins do Microsoft Copilot Studio

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

Pré-requisitos

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.

Introdução

Captura de ecrã que mostra o ecrã de criação de ligações para o Microsoft Graph Connector para o Salesforce CRM.

1. Nome a apresentar

Um nome a apresentar é utilizado para identificar cada referência no Copilot, ajudando os utilizadores a reconhecer facilmente o ficheiro ou item associado. O nome a apresentar também significa conteúdo fidedigno. O nome a apresentar também é utilizado como um filtro de origem de conteúdo. Está presente um valor predefinido para este campo, mas pode personalizá-lo para um nome que os utilizadores na sua organização reconhecem.

2. URL do CRM do Salesforce

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.

3. Tipo de Autenticação

Para autenticar e sincronizar conteúdos do Salesforce CRM, selecione OAuth 2.0. Introduza o ID de cliente e o Segredo do cliente que obteve a partir da instância do Salesforce e selecione Autorizar.

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.
  • Certifique-se de que a conta do Salesforce que está a ser utilizada para iniciar sessão no conector do Graph é a mesma que o utilizador que já iniciou sessão no Salesforce.
  • Certifique-se de que o utilizador que inicia sessão tem todas as permissões de objeto necessárias para a organização.

Verifique se a ligação foi bem-sucedida ao procurar um tick verde que mostre as credenciais corretas, 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

4. Implementar para público-alvo limitado

Implemente esta ligação numa base de utilizadores limitada se pretender validá-la no Copilot e noutras superfícies de Pesquisa antes de expandir a implementação para uma audiência mais ampla. Para saber mais sobre a implementação limitada, veja Implementação faseada.

Neste momento, está pronto para criar a ligação para o Salesforce CRM. Pode clicar em Criar para publicar o conteúdo da ligação e do índice a partir da instância do Salesforce.

Para outras definições, como Permissões de Acesso, Regras de Inclusão de Dados, Esquema, Frequência de pesquisa, etc., temos predefinições com base no que funciona melhor com os dados Jira. Pode ver os valores predefinidos abaixo:

Usuários Descrição
Permissões de acesso Apenas pessoas com acesso a conteúdos na Origem de dados.
Mapear Identidades Identidades de origem de dados mapeadas com Microsoft Entra IDs.
Conteúdo Descrição
Objetos do Salesforce Todos os objetos são indexados.
Filtrar dados Todos os objetos são indexados. Não é aplicado nenhum filtro de tempo ou critérios SOQL .
Gerir Propriedades Para marcar propriedades predefinidas e o respetivo esquema, veja conteúdo.
Sincronização Descrição
Pesquisa Incremental Frequência: a cada 15 minutos
Pesquisa Completa Frequência: Todos os Dias

Se quiser editar qualquer um destes valores, tem de escolher a opção "Configuração Personalizada".

Configuração Personalizada

A configuração personalizada destina-se aos administradores que pretendem editar os valores predefinidos das definições listadas na tabela acima. Depois de clicar na opção "Configuração Personalizada", verá mais três separadores : Utilizadores, Conteúdo e Sincronização.

Usuários

Captura de ecrã a mostrar o separador Utilizadores, onde pode configurar as permissões de acesso e as regras de mapeamento de utilizadores.

Permissões de Acesso

O conector CRM do Salesforce suporta permissões de pesquisa visíveis para Todos ou Apenas pessoas com acesso a esta origem de dados. Se escolher Todos, os dados indexados serão apresentados nos resultados da pesquisa para todos os utilizadores. Se escolher Apenas as pessoas com acesso a esta origem de dados, os dados indexados serão apresentados nos resultados da pesquisa para os utilizadores que têm acesso aos mesmos. Escolha o mais adequado para a sua organização.

Identidades de Mapeamento

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-Microsoft Entra" como o tipo de identidade.

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

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

Observação

Atualizações a grupos que regem as permissões de acesso são sincronizados apenas em pesquisas completas. As pesquisas incrementais não suportam o processamento de atualizações para permissões.

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.

Conteúdo

Escolher objetos do Salesforce e filtrar dados

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

Gerir Propriedades

Aqui, pode adicionar ou remover propriedades disponíveis da sua origem de dados CRM do Salesforce, atribuir um esquema à propriedade (definir se uma propriedade é pesquisável, queryable, recuperável ou refinável), alterar a etiqueta semântica e adicionar um alias à propriedade. Embora este passo não seja obrigatório, ter algumas etiquetas de propriedade melhora a relevância e garante melhores resultados para os utilizadores finais. Por predefinição, algumas das Etiquetas como "Título", "URL", "CreatedBy" e "LastModifiedBy" já foram atribuídas propriedades de origem. As propriedades selecionadas por predefinição estão listadas abaixo.

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.

Pré-visualizar Dados

Utilize o botão de resultados de pré-visualização para verificar os valores de exemplo das propriedades selecionadas e do filtro de consulta.

Sincronização

Captura de ecrã que mostra o separador Sincronizar onde pode configurar a frequência de pesquisa.

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 do Graph. Existem dois tipos de intervalos de atualização: pesquisa completa e pesquisa incremental. Para obter mais detalhes, veja definições de atualização.

Se quiser, pode alterar os valores predefinidos do intervalo de atualização a partir daqui.

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.

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.