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. Seleccione Salesforce.
   
3. Asigne un nombre a su trabajo para que pueda identificarlo.
   
4. Seleccione el proyecto en el que desea cargar los datos.
5. Dele una descripción a su trabajo para que conozca su propósito.
6. Haga clic en Siguiente.
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. Haga clic en 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. Puede introducir un valor entre 1 y 100 días.
    • Fecha de vencimiento: establezca la fecha en la que vencerán las credenciales. Haga clic en la casilla para abrir un calendario para elegir la fecha.
11. Haga clic en Siguiente.
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. Si es necesario, ajuste sus asignaciones de datos. Consulte la página de soporte Asignación de datos para obtener información detallada sobre los campos de asignación en 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. Haga clic en Siguiente.
21. Si lo desea, puede añadir reglas de sustitución y edición de datos para ocultar datos confidenciales o sustituir automáticamente determinadas palabras y frases en los comentarios y las interacciones del 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. Haga clic en Siguiente.
23. Si lo desea, puede añadir un filtro de conector para filtrar los datos entrantes para limitar los datos que se importan.
    
24. También puede limitar el número de registros importados en un solo job introduciendo un número en el cuadro Especificar límite de registros. Introduzca “Todos” si desea importar todos los registros.
    Consejo Q: Para los datos conversacionales, el límite se aplica en función de las conversaciones en lugar de las filas.
25. Haga clic en Siguiente.
26. Elija cuándo desea que se le notifique. Consulte Notificaciones de job para obtener más información.
    
27. Haga clic en Siguiente.
28. Seleccione cómo se gestionan los documentos duplicados. Consulte Tratamiento de duplicados para obtener más información.
    
29. Seleccione Programar ejecuciones incrementales si desea que el job se ejecute periódicamente en una programación o Configurar pull único si desea que el job se ejecute solo una vez. Consulte Programación de jobs para obtener más información.
30. Haga clic en Siguiente.
31. Revise su configuración. Si necesita cambiar una configuración específica, haga clic en el botón Editar para ir a ese paso en la configuración del conector.
32. Haga clic en Finalizar para grabar el job.

Asignación de datos predeterminados

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

• natural_id: un identificador único de un documento. Se recomienda encarecidamente tener un ID único para cada documento para procesar duplicados correctamente. Para el ID natural, puede seleccionar cualquier campo de texto o numérico de sus datos. Como alternativa, puede generar automáticamente ID añadiendo un campo personalizado.
• document_date: el campo de fecha principal asociado a un documento. Esta fecha se utiliza en informes, tendencias, alertas, etc. de XM Discover. 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.
  • También puede fijar una fecha de documento específica.
• feedback_provider: identifica los datos obtenidos de un proveedor específico. For Salesforce uploads, this attribute’s value is set to “Salesforce” and cannot be changed.
• source_value: identifica los datos obtenidos de una fuente específica. Puede ser cualquier cosa que describa el origen de los datos, como el nombre de una encuesta o una campaña de marketing móvil. By default, this attribute’s value is set to “Salesforce.” Utilice transformaciones personalizadas para establecer un valor personalizado, definir una expresión o asignarla a otro campo.
• feedback_type: identifica los datos en función de su tipo. Esto es útil para la generación de informes cuando su proyecto contiene diferentes tipos de datos (por ejemplo, encuestas y opiniones de medios sociales). By default, this attribute’s value is set “Operational Reporting”. Utilice transformaciones personalizadas para establecer un valor personalizado, definir una expresión o asignarla a otro campo.
• job_name: identifica los datos según el nombre del job utilizado para cargarlos. Puede modificar el valor de este atributo durante la configuración mediante el campo Nombre del trabajo que se muestra en la parte superior de cada página durante la configuración.
• loadDate: indica cuándo se cargó un documento en XM Discover. Este campo se fija automáticamente y no se puede modificar.