Connettore in entrata Salesforce

Informazioni sul connettore in entrata Salesforce

Puoi utilizzare il connettore Salesforce in entrata per caricare i dati dei rapporti operativi dal tuo account Salesforce in XM Discover.

Configurazione richiesta in Salesforce

Per connettere XM Discover a Salesforce, avrai bisogno delle seguenti informazioni sul tuo account Salesforce:

• La tua chiave cliente Salesforce (ID cliente)
• La tua chiave segreta cliente Salesforce (chiave client segreta)
• Il tuo nome utente e la tua password Salesforce
• URL ambiente dell’organizzazione Salesforce
• Una query SOQL (Salesforce Object Query Language) valida per recuperare il feedback o le interazioni chat
  Consiglio Q: SOQL ti consente di cercare informazioni specifiche nei dati Salesforce della tua organizzazione. SOQL è simile all’istruzione “SELECT” nel linguaggio SQL (Structured Query Language) ampiamente utilizzato, ma è progettato specificamente per i dati Salesforce. Per un’introduzione a SOQL, consultare questa pagina della Guida di Salesforce…

Inoltre, devi eseguire quanto segue nel tuo account Salesforce:

1. Nell’app connessa, selezionare Attiva impostazioni OAuth… Vedere questa pagina della Guida di Salesforce per ulteriori informazioni.
2. Impostare URL di callback al: https://data.us1.qualtrics.io/connectors?token_type=salesforce
3. Selezionare quanto segue Ambiti OAuth:
   • Accedere alle autorizzazioni personalizzate (custom_allows)
   • Accedi agli identificatori utente univoci (openid)
   • Accesso completo (completo)
   • Gestisci dati utente tramite API (API)
   • Eseguire richieste in qualsiasi momento (refresh_token, offline_access)
   • Accertarsi che PKCE non sia abilitato
4. Nella stessa mappa connessa, selezionare Gestisci policy di accesso OAuth… Vedere questa pagina della Guida di Salesforce per ulteriori informazioni.
5. Selezionare le seguenti opzioni:
   • Utente consentito: tutti gli utenti possono auto-autorizzare.
   • Aggiorna politica token: il token di aggiornamento è valido fino alla revoca.

Configurazione di un processo Salesforce in entrata

1. Nella pagina Processi, fare clic su Nuovo job…
   
2. Selezionare Salesforce.
   
3. Assegnare un nome al job in modo da poterlo identificare.
   
4. Selezionare il progetto in cui caricare i dati.
5. Fornisci una descrizione del tuo lavoro in modo da conoscerne lo scopo.
6. Fare clic su Successivo.
7. Scegli un account Salesforce da utilizzare, o seleziona Aggiungi nuovo per aggiungerne uno nuovo.
8. Se aggiungi un nuovo account, inserisci le seguenti informazioni sul tuo account Salesforce:
   • Nome connessione: assegnare un nome alla connessione in modo da poterla identificare.
   • ID client Salesforce: la tua chiave cliente Salesforce.
   • Chiave segreta client Salesforce: la tua chiave segreta cliente Salesforce
   • Ambiente Salesforce: URL ambiente della tua organizzazione Salesforce
   • Ambiente test: se ci si connette a un ambiente di test, abilitare questa opzione.
9. Fare clic su Autorizza.
10. Se si desidera che le credenziali scadano, configurare le seguenti opzioni:
    
    • Invia notifiche di scadenza: selezionare questa opzione per consentire la scadenza delle credenziali.
    • Giorni prima della scadenza: se si abilitano le notifiche di scadenza, immettere quanti giorni si desidera ricevere una notifica prima della scadenza. È possibile inserire un valore compreso tra 1 e 100 giorni.
    • Data di scadenza: impostare la data di scadenza delle credenziali. Fare clic sulla casella per aprire un calendario per scegliere la data.
11. Fare clic su Successivo.
12. Scegli il tipo di feedback da caricare da Salesforce:
    
    • Feedback Salesforce: carica feedback regolare.
    • Chat Salesforce: caricare interazioni agente/cliente dalla chat Salesforce.
    • Salesforce SMS Text: Carica interazioni agente/cliente da Salesforce LiveMessage.
13. In caso di caricamento Chat Salesforce, selezionare la modalità di identificazione di agenti e client:
    • Rilevamento automatico: Rileva agenti, assistenti di chat e visitatori automaticamente.
    • Il primo partecipante è un agente: il primo partecipante alla chat verrà attribuito come agente.
    • Il primo partecipante è un cliente: il secondo partecipante alla chat verrà attribuito come agente.
14. Selezionare Versione API che si desidera utilizzare.
15. Inserisci un istruzione SOQL personalizzata per limitare i dati recuperati da Salesforce.
    
    Consiglio Q: Per recuperare i dati della chat, utilizzare l’oggetto LiveChatTranscript nella query.
    Attenzione: GROUP BY non è supportato.
    Esempio: SELECT Id, CreatedDate, Body, ChatDuration FROM LiveChatTranscript.
16. Fare clic su Convalida Query per testare l’istruzione SOQL.
17. Se la validazione ha avuto esito positivo, selezionare campo data utilizzato per identificare i dati da recuperare.
    Consiglio Q: Questa lista contiene solo i campi presenti nella query SOQL.
18. Fare clic su Successivo
19. Se necessario, adattare le mappature dei dati. Consulta la pagina di supporto Mappaggio dati per informazioni dettagliate sui campi di mappatura in XM Discover. Il Sezione Mappatura dati predefinita ha informazioni sui campi specifici di questo connettore e Mappatura di campi conversazionali La sezione descrive come mappare i dati per i dati conversazionali.
    
20. Fare clic su Successivo.
21. Se lo si desidera, è possibile aggiungere regole di sostituzione e oscuramento dei dati per nascondere i dati sensibili o sostituire automaticamente determinate parole e frasi nel feedback e nelle interazioni dei clienti. Vedere Pagina di supporto Sostituzione dei Dati e Redazione…
    Consiglio Q: Fare clic su Scarica dati campione per scaricare un file Excel con dati di esempio sul computer.
22. Fare clic su Successivo.
23. Se lo si desidera, è possibile aggiungere un filtro connettore per filtrare i dati in entrata e limitare i dati importati.
    
24. È inoltre possibile limitare il numero di record importati in un singolo processo immettendo un numero nella casella Specifica limite record. Inserire “Tutti” se si desidera importare tutti i record.
    Consiglio Q: Per i dati conversazionali, il limite viene applicato in base alle conversazioni piuttosto che alle righe.
25. Fare clic su Successivo.
26. Scegli quando desideri ricevere una notifica. Per ulteriori informazioni, consultare Notifiche job.
    
27. Fare clic su Successivo.
28. Scegliere la modalità di gestione dei documenti duplicati. Consultare Gestione duplicati per ulteriori informazioni.
    
29. Selezionare Pianifica esecuzioni incrementali se si desidera che il job venga eseguito periodicamente in base a una pianificazione oppure Configura pull una tantum se si desidera che il job venga eseguito una sola volta. Per ulteriori informazioni, consultare Pianificazione job.
30. Fare clic su Successivo.
31. Rivedere la configurazione. Se è necessario modificare un’impostazione specifica, fare clic sul pulsante Modifica per passare a quella fase nella configurazione del connettore.
32. Fare clic su Fine per salvare la mansione.

Mappaggio dati predefinito

Questa sezione contiene informazioni sui campi predefiniti per i lavori Salesforce in entrata.

• natural_id: identificatore univoco di un documento. Si consiglia vivamente di disporre di un ID univoco per ogni documento per elaborare correttamente i duplicati. Per l’ ID naturale, è possibile selezionare qualsiasi campo di testo o numerico dai propri dati. In alternativa, è possibile generare automaticamente gli ID aggiungendo un campo personalizzato.
• document_date: il campo data principale associato a un documento. Questa data viene utilizzata in XM Discover per report, tendenze, avvisi e così via. Di default, questo viene mappato al campo data selezionato dopo aver specificato la query SOQL. È possibile selezionare una delle seguenti opzioni:
  • CreatedDate (predefinito): la data di creazione dell’oggetto Salesforce.
  • ClosedDate (per i dati della chat): la data in cui il caso è stato chiuso.
  • Se i dati sorgente contengono altri campi data, è possibile selezionarne uno.
  • È anche possibile impostare una data documento specifica.
• feedback_provider: identifica i dati ottenuti da un provider specifico. Per i caricamenti Salesforce, il valore di questo attributo è impostato su “Salesforce” e non può essere modificato.
• source_value: identifica i dati ottenuti da un’origine specifica. Può trattarsi di qualsiasi elemento che descriva l’origine dei dati, ad esempio il nome di un’indagine o di una campagna di marketing mobile. Per impostazione predefinita, il valore di questo attributo è impostato su “Salesforce”. Utilizzare le trasformazioni personalizzate per impostare un valore personalizzato, definire un’espressione o mapparla a un altro campo.
• feedback_type: identifica i dati in base al tipo. Ciò è utile per il reporting quando il progetto contiene diversi tipi di dati (ad esempio, questionari e feedback sui social media). Per impostazione predefinita, il valore di questo attributo è impostato su “Reporting operativo”. Utilizzare le trasformazioni personalizzate per impostare un valore personalizzato, definire un’espressione o mapparla a un altro campo.
• job_name: identifica i dati in base al nome del job utilizzato per caricarlo. È possibile modificare il valore di questo attributo durante la configurazione tramite il campo Nome job visualizzato nella parte superiore di ogni pagina durante la configurazione.
• loadDate: indica quando un documento è stato caricato in XM Discover. Questo campo viene impostato automaticamente e non può essere modificato.