Salesforce Inbound Connector

About the Salesforce Inbound Connector

You can use the Salesforce inbound connector to load operational reporting data from your Salesforce account into XM Discover.

Required Setup in Salesforce

To connect XM Discover to Salesforce, you will need the following information about your Salesforce account:

• Your Salesforce Consumer Key (client ID)
• Your Salesforce Consumer Secret (client secret)
• Your Salesforce username and password
• Your Salesforce organization’s environment URL
• A valid Salesforce Object Query Language (SOQL) query to retrieve feedback or chat interactions
  Qtip: SOQL enables you to search your organization’s Salesforce data for specific information. SOQL is similar to the “SELECT” statement in the widely used Structured Query Language (SQL) but is designed specifically for Salesforce data. For an introduction to SOQL, please see this Salesforce help page.

Additionally, you must perform the following in your Salesforce account:

1. In your connected app, select Enable OAuth Settings. See this Salesforce help page for more information.
2. Set the Callback URL to: https://data.us1.qualtrics.io/connectors?token_type=salesforce
3. Select the following OAuth Scopes:
   • Access custom permissions (custom_permissions)
   • Access unique user identifiers (openid)
   • Full access (full)
   • Manage user data via APIs (api)
   • Perform requests at any time (refresh_token, offline_access)
   • Make sure PKCE is not enabled
4. In the same connected map, select Manage OAuth Access Policies. See this Salesforce help page for more information.
5. Choose the following options:
   • Permitted User: All users may self-authorize.
   • Refresh Token Policy: Refresh token is valid until revoked.

Setting Up a Salesforce Inbound Job

1. On the Jobs page, click New Job.
   
2. Selecione Salesforce.
   
3. Dê um nome ao seu job para poder identificá-lo.
   
4. Selecione o projeto para o qual os dados devem ser carregados.
5. Dê uma descrição ao seu cargo para que você saiba o seu objetivo.
6. Clique em Seguinte.
7. Choose a Salesforce account to use, or select Add New to add a new one.
8. If adding a new account, enter the following information about your Salesforce account:
   • Connection Name: Give the connection a name so you can identify it.
   • Salesforce Client ID: Your Salesforce Consumer Key.
   • Salesforce Client Secret: Your Salesforce Consumer Secret
   • Salesforce Environment: Your Salesforce organization’s environment URL
   • Test environment: If connecting to a test environment, enable this option.
9. Clique em Autorizar.
10. If you want your credentials to expire, then configure the following options:
    
    • Send Expiration Notifications: Select this option to allow your credentials to expire.
    • Days prior expiration: If enabling expiration notifications, enter how many days you’d like to be notified before the expiration. Você pode inserir um valor entre 1 e 100 dias.
    • Data de vencimento: defina a data em que as credenciais expirarão. Clique na caixa para abrir um calendário e selecionar a data.
11. Clique em Seguinte.
12. Choose the type of feedback to upload from Salesforce:
    
    • Salesforce Feedback: Upload regular feedback.
    • Salesforce Chat: Upload agent/client interactions from Salesforce Chat.
    • Salesforce SMS Text: Upload agent/client interactions from Salesforce LiveMessage.
13. If uploading Salesforce Chat, select how agents and clients are identified:
    • Auto-detect: Detect agents, chat assistants, and visitors automatically.
    • The first participant is an agent: The first chat participant will be assigned as an agent.
    • The first participant is a client: The second chat participant will be assigned as an agent.
14. Select the API Version you’d like to use.
15. Enter a custom SOQL statement to limit the data retrieved from Salesforce.
    
    Qtip: To retrieve chat data, use the LiveChatTranscript object in the query.
    Attention: GROUP BY is not supported.
    Example: SELECT Id, CreatedDate, Body, ChatDuration FROM LiveChatTranscript.
16. Click Validate Query to test your SOQL statement.
17. If the validation was successful, choose the date field used to identify data to be retrieved.
    Qtip: This list only contains fields that are present in your SOQL query.
18. Click Next
19. Se necessário, ajuste seus mapeamentos de dados. Consulte a página de suporte Mapeamento de dados para obter informações detalhadas sobre campos de mapeamento no XM Discover. The Default Data Mapping section has information on the fields specific to this connector and the Mapping Conversational Fields section covers how to map data for conversational data.
    
20. Clique em Seguinte.
21. Se desejar, você pode adicionar regras de substituição e ocultação de dados para ocultar dados confidenciais ou substituir automaticamente determinadas palavras e frases no feedback e nas interações do cliente. See the Data Substitution and Redaction support page.
    Qtip: Click Download Sample Data to download an Excel file with sample data to your computer.
22. Clique em Seguinte.
23. Se desejar, você pode adicionar um filtro de conector para filtrar os dados de entrada a fim de limitar quais dados são importados.
    
24. Você também pode limitar o número de registros importados em um único job inserindo um número na caixa Indicar limite de registros. Insira “Todos” se quiser importar todos os registros.
    Qdica: Para dados conversacionais, o limite é aplicado com base em conversas em vez de linhas.
25. Clique em Seguinte.
26. Escolha quando você deseja ser notificado. Consulte Notificações de job para mais informações.
    
27. Clique em Seguinte.
28. Escolha como os documentos duplicados são tratados. Consulte Tratamento de duplicados para obter mais informações.
    
29. Selecione Programar execuções incrementais se você quiser que seu job seja executado periodicamente em uma programação ou Configurar pull único se quiser que o job seja executado somente uma vez. Consulte Escalonamento do job para mais informações.
30. Clique em Seguinte.
31. Revise sua configuração. Se você precisar modificar uma configuração específica, clique no botão Editar para ir para essa etapa na configuração do conector.
32. Clique em Concluir para salvar o trabalho.

Mapeamento de dados padrão

This section contains information on the default fields for Salesforce inbound jobs.

• natural_id: Um identificador exclusivo de um documento. É altamente recomendado ter um ID único para cada documento para processar duplicados corretamente. Para ID natural, você pode selecionar qualquer campo de texto ou numérico a partir de seus dados. Como alternativa, você pode gerar IDs automaticamente adicionando um campo personalizado.
• document_date: o campo de data principal associado a um documento. Esta data é usada em relatórios, tendências, alertas do XM Discover e assim por diante. By default, this is mapped to the date field selected after specifying the SOQL query. You can choose one of the following options:
  • CreatedDate (default): The date when the Salesforce object was created.
  • ClosedDate (for chat data): The date when the case was closed.
  • If your source data contains other date fields, you can choose one of them.
  • Você também pode definir uma data específica do documento.
• feedback_provider: identifica dados obtidos de um provedor específico. For Salesforce uploads, this attribute’s value is set to “Salesforce” and cannot be changed.
• source_value: identifica dados obtidos de uma fonte específica. Isso pode ser qualquer coisa que descreva a origem dos dados, como o nome de uma pesquisa ou uma campanha de marketing móvel. By default, this attribute’s value is set to “Salesforce.” Use transformações personalizadas para definir um valor personalizado, definir uma expressão ou mapeá-la para outro campo.
• feedback_type: Identifica dados com base em seu tipo. Isso é útil para relatórios quando seu projeto contém diferentes tipos de dados (por exemplo, pesquisas e feedback de mídias sociais). By default, this attribute’s value is set “Operational Reporting”. Use transformações personalizadas para definir um valor personalizado, definir uma expressão ou mapeá-la para outro campo.
• job_name: identifica dados com base no nome do trabalho usado para carregá-lo. Você pode modificar o valor deste atributo durante a configuração por meio do campo Nome do job que é exibido na parte superior de cada página durante a configuração.
• loadDate: indica quando um documento foi carregado no XM Discover. Este campo é definido automaticamente e não pode ser modificado.