Condividi tramite

Connettore Microsoft Graph di Salesforce CRM

  • Articolo

Il connettore Salesforce Microsoft Graph consente all'organizzazione di indicizzare contatti, opportunità, lead, case e oggetti account nell'istanza di Salesforce. Dopo aver configurato il connettore e il contenuto dell'indice da Salesforce, gli utenti finali possono cercare tali elementi da qualsiasi client di Microsoft Search e Microsoft 365 Copilot.

Questo articolo è destinato agli amministratori di Microsoft 365 o a chiunque configura, esegue e monitora un connettore Microsoft Graph di Salesforce CRM.

Importante

Il connettore Salesforce Microsoft Graph supporta attualmente Summer '19 o versione successiva.

Funzionalità

  • Indicizzare gli oggetti contatti, opportunità, lead, case e account nell'istanza di Salesforce
  • Filtrare il contenuto in base a ciò che si vuole indicizzare
  • Accedere ai dati di Salesforce CRM usando la potenza della ricerca semantica
  • Conservare gli ACL definiti dall'organizzazione
  • Personalizzare la frequenza di ricerca per indicizzazione
  • Creare agenti e flussi di lavoro usando questa connessione e plug-in da Microsoft Copilot Studio

Limitazioni

  • Il connettore Salesforce Microsoft Graph attualmente non supporta la condivisione e la condivisione basata su Apex basate sul territorio tramite gruppi personali di Salesforce.
  • Esiste un bug noto nell'API Salesforce usata dal connettore, in cui le impostazioni predefinite a livello di organizzazione privata per i lead non vengono attualmente rispettate.
  • Se un campo ha la sicurezza a livello di campo (FLS) impostata per un profilo, il connettore non inserirà tale campo per i profili nell'organizzazione Salesforce. Di conseguenza, gli utenti non saranno in grado di cercare i valori per tali campi o di visualizzarli nei risultati.
  • Nella schermata gestisci schema questi nomi di proprietà standard comuni sono elencati una sola volta, le opzioni sono Query, Search, Retrieve e Refine e si applicano a tutti o nessuno.
    • Nome
    • Url
    • Descrizione
    • Fax
    • Telefono
    • MobilePhone
    • Posta elettronica
    • Tipo
    • Titolo
    • AccountId
    • AccountName
    • AccountUrl
    • AccountOwner
    • AccountOwnerUrl
    • Proprietario
    • OwnerUrl
    • CreatedBy
    • CreatedByUrl
    • LastModifiedBy
    • LastModifiedByUrl
    • LastModifiedDate
    • ObjectName

Prerequisiti

Per connettersi all'istanza di Salesforce, sono necessari l'URL dell'istanza di Salesforce, l'ID client e il segreto client per l'autenticazione OAuth. I passaggi seguenti illustrano come l'utente o l'amministratore di Salesforce può ottenere queste informazioni dall'account Salesforce:

  • Accedere all'istanza di Salesforce e passare al programma di installazione

  • Passare ad App -> Gestione app.

  • Selezionare Nuova app connessa.

  • Completare la sezione API come indicato di seguito:

    • Selezionare la casella di controllo Abilita impostazioni Oauth.

    • Specificare l'URL di callback come: Per M365 Enterprise: https://gcs.office.com/v1.0/admin/oauth/callback, per M365 Government: https://gcsgcc.office.com/v1.0/admin/oauth/callback

    • Selezionare questi ambiti OAuth necessari.

      • Accedere ai dati (API) e gestirli.

      • Eseguire richieste per conto dell'utente in qualsiasi momento (refresh_token, offline_access).

    • Selezionare la casella di controllo Richiedi segreto per il flusso del server Web.

    • Salvare l'app.

      Sezione API nell'istanza di Salesforce dopo che l'amministratore ha immesso tutte le configurazioni necessarie elencate in precedenza.

  • Copiare la chiave consumer e il segreto del consumer. Queste informazioni vengono usate come ID client e segreto client quando si configurano le impostazioni di connessione per il connettore Salesforce Microsoft Graph nel portale di amministrazione di Microsoft 365.

    Risultati restituiti dalla sezione API nell'istanza di Salesforce dopo che l'amministratore ha inviato tutte le configurazioni necessarie. La chiave consumer si trova nella parte superiore della colonna sinistra e il segreto consumer si trova in alto a destra.

  • Prima di chiudere l'istanza di Salesforce, seguire questa procedura per assicurarsi che i token di aggiornamento non scadano:

    • Passare ad App -> Gestione app.
    • Trovare l'app creata e selezionare l'elenco a discesa a destra. Selezionare Gestisci.
    • Selezionare Modifica criteri.
    • Per i criteri del token di aggiornamento, selezionare Aggiorna token valido fino a quando non viene revocato.

    Selezionare il criterio del token di aggiornamento denominato

È ora possibile usare Amministrazione Microsoft 365 Center per completare il resto del processo di installazione per il connettore Microsoft Graph.

Introduzione

Screenshot che mostra la schermata di creazione della connessione per Connettore Microsoft Graph per Salesforce CRM.

1. Nome visualizzato

Un nome visualizzato viene usato per identificare ogni riferimento in Copilot, consentendo agli utenti di riconoscere facilmente il file o l'elemento associato. Il nome visualizzato indica anche contenuto attendibile. Il nome visualizzato viene usato anche come filtro dell'origine di contenuto. Per questo campo è presente un valore predefinito, ma è possibile personalizzarlo in base a un nome riconosciuto agli utenti dell'organizzazione.

2. URL CRM di Salesforce

Per l'URL dell'istanza usare https://[dominio].my.salesforce.com in cui il dominio sarà il dominio Salesforce per l'organizzazione.

3. Tipo di autenticazione

Per autenticare e sincronizzare il contenuto da Salesforce CRM, scegliere OAuth 2.0. Immettere l'ID client e il segreto client ottenuti dall'istanza di Salesforce e selezionare Autorizza.

La prima volta che si è tentato di accedere con queste impostazioni, verrà visualizzato un popup che chiede di accedere a Salesforce con il nome utente e la password dell'amministratore. Lo screenshot seguente mostra il popup. Immettere le credenziali e selezionare "Accedi".

Viene visualizzato l'account di accesso che richiede nome utente e password.

Nota

  • Se il popup non viene visualizzato, potrebbe essere bloccato nel browser, quindi è necessario consentire popup e reindirizzamenti.
  • Assicurarsi che l'account Salesforce usato per accedere per il connettore Graph sia lo stesso dell'utente che ha già eseguito l'accesso a Salesforce.
  • Assicurarsi che l'accesso utente disponga di tutte le autorizzazioni necessarie per l'oggetto per l'organizzazione.

Verificare che la connessione sia riuscita cercando un segno di spunta verde che mostri le credenziali corrette, come illustrato nello screenshot seguente.

Screenshot dell'accesso riuscito. Il banner verde

4. Distribuire a un pubblico limitato

Distribuire questa connessione in una base di utenti limitata se si vuole convalidarla in Copilot e in altre aree di ricerca prima di espandere l'implementazione a un pubblico più ampio. Per altre informazioni sull'implementazione limitata, vedere Implementazione a fasi.

A questo punto, si è pronti per creare la connessione per Salesforce CRM. È possibile fare clic su Crea per pubblicare il contenuto della connessione e dell'indice dall'istanza di Salesforce.

Per altre impostazioni, ad esempio autorizzazioni di accesso, regole di inclusione dati, schema, frequenza di ricerca per indicizzazione e così via, sono disponibili impostazioni predefinite basate su ciò che funziona meglio con i dati Jira. Di seguito sono riportati i valori predefiniti:

Utenti Descrizione
Autorizzazioni di accesso Solo gli utenti con accesso al contenuto nell'origine dati.
Identità mappa Identità dell'origine dati mappate tramite ID Microsoft Entra.
Contenuto Descrizione
Oggetti Salesforce Tutti gli oggetti sono indicizzati.
Filtrare i dati Tutti gli oggetti sono indicizzati. Non viene applicato alcun filtro temporale o criteri SOQL .
Gestisci proprietà Per controllare le proprietà predefinite e il relativo schema, vedere contenuto.
Sincronizza Descrizione
Ricerca per indicizzazione incrementale Frequenza: ogni 15 minuti
Ricerca per indicizzazione completa Frequenza: ogni giorno

Per modificare uno di questi valori, è necessario scegliere l'opzione "Installazione personalizzata".

Installazione personalizzata

L'installazione personalizzata è destinata agli amministratori che vogliono modificare i valori predefiniti per le impostazioni elencate nella tabella precedente. Dopo aver fatto clic sull'opzione "Installazione personalizzata", vengono visualizzate altre tre schede: Utenti, Contenuto e Sincronizzazione.

Utenti

Screenshot che mostra la scheda Utenti in cui è possibile configurare le autorizzazioni di accesso e le regole di mapping degli utenti.

Autorizzazioni di accesso

Il connettore CRM salesforce supporta le autorizzazioni di ricerca visibili a tutti o solo agli utenti con accesso a questa origine dati. Se si sceglie Tutti, i dati indicizzati verranno visualizzati nei risultati della ricerca per tutti gli utenti. Se si sceglie Solo le persone con accesso a questa origine dati, i dati indicizzati verranno visualizzati nei risultati della ricerca per gli utenti che hanno accesso a tali origini. Scegliere quella più appropriata per l'organizzazione.

Mapping delle identità

È possibile scegliere di inserire Controllo di accesso Elenchi (ACL) dall'istanza di Salesforce o consentire a tutti gli utenti dell'organizzazione di visualizzare i risultati della ricerca da questa origine dati. Gli elenchi di controllo di accesso possono includere identità Microsoft Entra (utenti federati da Microsoft Entra ID a Salesforce), identità non Azure AD (utenti salesforce nativi con identità corrispondenti in Microsoft Entra ID) o entrambi.

Nota

Se si usa un provider di identità di terze parti, ad esempio Ping ID o secureAuth, è necessario selezionare "non Microsoft Entra" come tipo di identità.

Se si sceglie di inserire un ACL dall'istanza di Salesforce e si seleziona "ID non ME" per il tipo di identità, vedere Eseguire il mapping delle identità non Microsoft Entra per istruzioni sul mapping delle identità.

Se si è scelto di inserire un elenco di controllo di accesso dall'istanza di Salesforce e si è selezionato "ME-ID" per il tipo di identità, vedere Mapping delle identità Microsoft Entra per istruzioni sul mapping delle identità. Per informazioni su come configurare Microsoft Entra SSO per Salesforce, vedere questa esercitazione.

Nota

Aggiornamenti ai gruppi che controllano le autorizzazioni di accesso vengono sincronizzati solo in ricerche per indicizzazione complete. Le ricerche per indicizzazione incrementali non supportano l'elaborazione degli aggiornamenti alle autorizzazioni.

In questo video è possibile visualizzare il processo di autenticazione nell'istanza di Salesforce, sincronizzare le identità non Microsoft Entra con le identità Microsoft Entra e applicare le limitare di sicurezza appropriate agli elementi Salesforce.

Contenuto

Scegliere oggetti Salesforce e filtrare i dati

Selezionare gli oggetti Salesforce da sottoporre a ricerca per indicizzazione e includere nei risultati della ricerca. Se l'opzione Contatto è selezionata, viene selezionata automaticamente anche l'opzione Account.

Nota

Se un campo ha la sicurezza a livello di campo (FLS) impostata per un profilo, il connettore non inserirà tale campo per i profili nell'organizzazione Salesforce. Di conseguenza, gli utenti non saranno in grado di cercare i valori per tali campi o di visualizzarli nei risultati.

Filtrare i dati

È inoltre possibile scegliere di filtrare il contenuto salesforce indicizzato in due modi:

  • Specificare il periodo di tempo modificato dell'elemento. Questa opzione indicicherà solo il contenuto salesforce creato o modificato nel periodo di tempo selezionato in sequenza in base alla ricerca per indicizzazione corrente.
  • Immettere la query Salesforce (SOQL) che specifica gli elementi da indicizzare usando la clausola WHERE .

Screenshot delle opzioni di filtro nel connettore Salesforce

Consiglio

È possibile lasciare vuota la clausola WHERE se si desidera indicizzare tutto il contenuto dell'entità specifica

Gestisci proprietà

In questo caso, è possibile aggiungere o rimuovere le proprietà disponibili dall'origine dati Salesforce CRM, assegnare uno schema alla proprietà (definire se una proprietà è ricercabile, ricercabile, recuperabile o perfezionabile), modificare l'etichetta semantica e aggiungere un alias alla proprietà. Anche se questo passaggio non è obbligatorio, l'avere alcune etichette di proprietà migliora la rilevanza e garantisce risultati migliori per gli utenti finali. Per impostazione predefinita, ad alcune etichette come "Title", "URL", "CreatedBy" e "LastModifiedBy" sono già state assegnate proprietà di origine. Di seguito sono elencate le proprietà selezionate per impostazione predefinita.

L'elenco di proprietà selezionate può influire su come filtrare, cercare e visualizzare i risultati in Microsoft 365 Copilot.

Proprietà source Etichetta Descrizione
Autori authors Nome delle persone che hanno partecipato o collaborato all'elemento nell'origine dati.
CreatedBy createdBy Nome della persona che ha creato l'elemento nell'origine dati.
CreatedDate createdDateTime Data e ora di creazione dell'elemento nell'origine dati.
Url url URL di destinazione dell'elemento nell'origine dati.
LastModifiedBy lastModifiedBy Nome della persona che ha modificato l'elemento più di recente nell'origine dati.
LastModifiedDateTime lastModifiedDateTime Data e ora dell'ultima modifica dell'elemento nell'origine dati.
Nome title Titolo dell'elemento che si vuole visualizzare nella ricerca e in altre esperienze.

Anteprima dei dati

Usare il pulsante dei risultati dell'anteprima per verificare i valori di esempio delle proprietà e del filtro di query selezionati.

Sincronizza

Screenshot che mostra la scheda Sincronizza in cui è possibile configurare la frequenza di ricerca per indicizzazione.

L'intervallo di aggiornamento determina la frequenza con cui i dati vengono sincronizzati tra l'origine dati e l'indice del connettore Graph. Esistono due tipi di intervalli di aggiornamento: ricerca per indicizzazione completa e ricerca per indicizzazione incrementale. Per altri dettagli, vedere Impostazioni di aggiornamento.

È possibile modificare i valori predefiniti dell'intervallo di aggiornamento da qui, se si vuole.

Consiglio

Tipo di risultato predefinito

  • Il connettore Salesforce registra automaticamente un tipo di risultato dopo la pubblicazione del connettore. Il tipo di risultato usa un layout dei risultati generato dinamicamente in base ai campi selezionati nel passaggio 3.
  • È possibile gestire il tipo di risultato passando a Tipi di risultato nel interfaccia di amministrazione di Microsoft 365. Il tipo di risultato predefinito è denominato "ConnectionIdDefault". Ad esempio, se l'ID connessione è Salesforce, il layout dei risultati è denominato "SalesforceDefault".
  • È anche possibile scegliere di creare un tipo di risultato personalizzato, se necessario.

Risoluzione dei problemi

Dopo aver pubblicato la connessione, è possibile esaminare lo stato nella scheda Origini datinell'interfaccia di amministrazione. Per informazioni su come eseguire aggiornamenti ed eliminazioni, vedere Gestire il connettore.

È possibile trovare i passaggi per la risoluzione dei problemi più comuni qui.

In caso di problemi o se si desidera fornire commenti e suggerimenti, contattare Microsoft Graph | Supporto.