Zendesk Inbound Connector

About the Zendesk Inbound Connector

You can use the Zendesk inbound connector to load chat data from Zendesk into XM Discover.

Setting up a Zendesk Inbound Job

1. En la página Jobs, haga clic en Job nuevo.
   
2. Seleccione Zendesk.
   
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 the Zendesk account to use, or select Add New to add a new one.
   
8. If adding a new account, enter the following information about your Zendesk account:
   • Connection Name: Give the connection a name so you can identify it.
   • Zendesk Email: The email address for your Zendesk account.
   • Zendesk API token: Your Zendesk account API token.
   • Zendesk Host: Your Zendesk subdomain.
9. 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.
10. Haga clic en Siguiente.
11. Choose the data type you want to import into XM Discover:
    
    • Process Chat Tickets as conversations: Zendesk chat tickets are imported as conversations.
    • Process All Tickets as documents: All Zendesk tickets are imported as documents.
12. You can choose whether you want to include unfinished tickets in the upload. Select the Process only closed tickets option to upload only closed tickets. Deselect this option to upload both closed and open tickets.
13. Haga clic en Siguiente.
14. 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.
15. Haga clic en Siguiente.
16. 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.
17. Haga clic en Siguiente.
18. Si lo desea, puede añadir un filtro de conector para filtrar los datos entrantes para limitar los datos que se importan.
    
19. 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.
20. Haga clic en Siguiente.
21. Elija cuándo desea que se le notifique. Consulte Notificaciones de job para obtener más información.
    
22. Haga clic en Siguiente.
23. Seleccione cómo se gestionan los documentos duplicados. Consulte Tratamiento de duplicados para obtener más información.
    
24. 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.
25. Haga clic en Siguiente.
26. 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.
27. Haga clic en Finalizar para grabar el job.

Asignación de datos predeterminados

This section contains information on the default fields for Zendesk 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. By default, XM Discover uses source IDs prefixed by the connector’s name via a custom transformation:Natural ID = Connector-name;Source-ID.
• 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:
  • updated_at (default): Date and time when the chat activity was most recently updated.
  • created_at: Date and time when the chat activity was created.
  • También puede fijar una fecha de documento específica.
• feedback_provider: identifica los datos obtenidos de un proveedor específico. For Zendesk uploads, this attribute’s value is set to “Zendesk” 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 “Zendesk.” 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 to “Messaging Platform”. 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.