Configuración de una tarea de enlace de XM Discover

Acerca del conector del enlace XM Discover

Puede utilizar el conector Enlace de XM Discover para enviar datos de XM a XM Discover a través de un punto final de API REST al tiempo que aprovecha todas las capacidades que ofrece el framework de conectores, como la asignación de campos, las transformaciones, los filtros, la observación de tareas, etc.

El conector XM Discover Link le permite ingerir datos a su ritmo deseado, mientras que otros conectores extraen los datos según una programación.

Formatos de datos admitidos

El conector XM Discover Link admite la carga de los siguientes tipos de datos:

• Feedback individual
• Interacciones digitales
• Llamar expedientes

Todos los documentos se proporcionan en formato JSON que depende del tipo de datos.

Para obtener más información sobre los formatos de datos compatibles con XM Discover, consulte Resumen de formatos de datos de XM Discover.

Así es como funciona el conector XM Discover Link:

1. El primer paso para utilizar el conector XM Discover Link es configurar un job de procesamiento y configurar parámetros y asignaciones para llamadas API futuras. Para obtener más detalles, consulte Creación de un trabajo de enlace de XM Discover.
2. Una vez configurado un job de procesamiento, puede ejecutar llamadas API mediante el job de procesamiento adecuado haciendo referencia a su ID. Toda la información de extremo de API necesaria se proporciona en el resumen del job de procesamiento. Para obtener más detalles, consulte Información de punto final de API.

Configuración de la conexión

Antes de comenzar

Antes de configurar una tarea de XM Discover Link, le recomendamos que prepare un archivo de muestra con datos de cliente en formato JSON utilizando uno de los siguientes tipos de datos:

1. Comentarios individuales: Para obtener más detalles, consulte Feedback individual en formato JSON.
2. Interacciones digitales: para obtener más detalles, consulte Interacciones digitales en formato JSON.
3. Transcripciones de llamadas: Para obtener más detalles, consulte Llamar transcripciones en formato JSON.

Para configurar la conexión:

1. Inicie sesión en Conectores.
2. Haga clic en el botón Nuevo trabajo en la esquina superior derecha de la página Trabajos.
3. En la página Conectores, vaya a la sección SELECCIONAR UNA FUENTE.
4. Haga clic en el botón Enlace de XM Discover.

Proceso de creación de un conector de entrada de enlace XM Discover

Después de configurar la conexión, siga estos pasos para crear una tarea de conector de entrada de XM Discover Link y configure los datos que se enviarán a XM Discover.

• Paso 1: Proporcionar nombre de job
• Paso 2: Especificar proyecto y descripción
• Paso 3: Modo de autorización
• Paso 4: Seleccionar archivo de muestra
• Paso 5: Asignar campos deseados a XM Discover
• Paso 6: Sustitución y modificación de datos (opcional)
• Paso 7: Especificar filtro (opcional)
• Paso 8: Configurar opciones adicionales para el trabajo
• Paso 9: Confirmar todas las parametrizaciones de job

Paso 1: Proporcionar nombre de job

Introduzca un nombre de job reconocible en el cuadro Nombre de job en la parte superior de la página.

Paso 2: Especificar proyecto y descripción

1. En la página Especificar proyecto y descripción, seleccione el proyecto en el que se deben cargar los datos del menú desplegable de proyectos.
   Consejo Q: Tiene la opción de introducir una nota sobre el trabajo en el cuadro Descripción del puesto. Solo se puede acceder a la descripción del trabajo que introduce en el cuadro “Descripción del trabajo” en la lista Conectores y no se carga como parte de los datos de un trabajo.
2. Haga clic en Siguiente.

Paso 3: Modo de autorización

En la página Modo de autorización, seleccione el modo de autorización que planea utilizar para las llamadas API:

• CLAVE API: Utilice tokens API generados por XM Discover. Para obtener más información sobre los tokens de API, consulte Tokens de API.
• OAUTH 2.0: Utilice el ID de cliente y el secreto de cliente proporcionados por el servicio de autenticación XM Discover. Póngase en contacto con su Customer Success Manager de Qualtrics para solicitar este método.

Paso 4: Seleccionar archivo de muestra

1. En la página Seleccionar archivo de muestra, en Seleccionar formato de datos, seleccione el tipo de datos que debe procesar este trabajo:
   • Chat: Procese interacciones digitales con múltiples líneas de diálogo entre dos o más participantes. Las interacciones digitales deben seguir un formato predefinido; puede descargar una plantilla después de seleccionar el formato de datos.
   • Llamada: Sube transcripciones de llamadas con múltiples líneas de diálogo entre dos o más participantes. Las transcripciones de llamada deben seguir un formato predefinido; puede descargar una plantilla después de seleccionar el formato de datos.
   • Feedback: Procesar documentos presentados como objetos de una sola fila o “planos”.
2. En el menú desplegable Plantilla, seleccione una plantilla para utilizarla.
   Consejo Q: Las opciones de plantilla disponibles son diferentes en función del formato de datos elegido.

   Formato de los datos	Opciones de plantilla
   Chat	Chat (predeterminado): Utilizar para datos de interacciones digitales estándar. Amazon Connect: se utiliza para interacciones digitales específicas del chat de Amazon Connect.
   Llamar	Llamada (por defecto): Se utiliza para los datos de transcripciones de llamada estándar. Verint: Uso para transcripciones de llamadas específicas de Verint. Consejo Q: Para obtener más información sobre el formato de archivo de exportación de Análisis de interacción de Verint, consulte la documentación de Verint.
   Opinión	Ninguno (predeterminado): No aplicar ninguna plantilla. Dynamics 365: Uso para datos de Microsoft Dynamics.

3. En el cuadro Vía de acceso JSON, especifique la vía de acceso JSON a un subconjunto de JSON que contenga nodos de documento.
   Consejo Q: Déjelo vacío si los documentos se encuentran en el nivel de nodo raíz.
4. Haga clic en el botón Para seleccionar archivo para cargar y apunte al archivo de muestra o suelte el archivo en el lienzo gris.
5. Espere hasta que XM Discover cargue el archivo de muestra y muestre la vista previa a continuación.
   Consejo Q: Si ve un mensaje de error y el contenido del archivo sin procesar en lugar de la vista previa, puede haber un problema con las opciones de formato de datos que ha seleccionado. Para obtener información sobre los mensajes de error para la validación fallida de archivos de muestra, consulte Errores de archivo de muestra.
6. Asegúrese de que los datos sean correctos.
7. Haga clic en Siguiente.

Paso 5: Asignar campos deseados a XM Discover

1. En la página Asignar campos deseados a XM Discover, seleccione la pestaña ASIGNACIÓN DE FUENTES para conectar campos de datos fuente con campos de datos de su proyecto XM Discover.
2. En la sección Asignación de fuente predeterminada, configure los campos de datos predeterminados que comparten todos los documentos de XM Discover. La siguiente tabla proporciona un resumen de las opciones de campo de datos predeterminadas para el conector de entrada de XM Discover Link.
   

   Nombre del campo	¿Editable?	Descripción
   feedback_type	Sí	El tipo de feedback le ayuda a identificar datos en función de su tipo. Esto es útil para generar informes cuando su proyecto contiene diferentes tipos de datos (por ejemplo, encuestas y comentarios de medios sociales). Por defecto, el valor de este atributo se fija en: “Llamada” para transcripciones de llamadas “chat” para interacciones digitales “feedback” para feedback individual Utilice la transformación personalizada para fijar un valor personalizado, definir una expresión o asignarla a un campo determinado.
   fuente	Sí	La fuente le ayuda a identificar 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. De forma predeterminada, el valor de este atributo se establece en “Enlace de XM Discover”. Utilice la transformación personalizada para fijar un valor personalizado, definir una expresión o asignarla a un campo determinado.
   richVerbatim (para datos conversacionales)	No	Para los datos conversacionales (como las interacciones de llamada y chat), XM Discover utiliza un formato conversacional literal para el campo richVerbatim. Este formato admite la ingesta de metadatos específicos del diálogo necesarios para desbloquear la visualización conversacional (turnos del orador, silencio, eventos conversacionales, etc.) y enriquecimientos (hora de inicio, duración, etc.). Este campo literal incluye campos de “niño” para rastrear el lado del cliente y del representante de la conversación: clientVerbatim rastrea el lado del cliente de la conversación. agentVerbatim rastrea el lado del representante (agente) de la conversación. desconocido sigue el lado desconocido de la conversación. Notas sobre los textos conversacionales: Las transformaciones no se admiten para campos textuales conversacionales. No se puede utilizar la misma palabra para diferentes tipos de datos conversacionales. Si desea que su proyecto aloje varios tipos de conversación, utilice pares separados de palabras conversacionales por tipo de conversación.
   clientVerbatim (para datos conversacionales)	Sí	Realiza un seguimiento del lado del cliente de la conversación en las interacciones de llamada y chat. Por defecto, este campo se asigna a: clientVerbatimChat para interacciones digitales clientVerbatimCall para interacciones de llamada Puede asignarlo a un campo textual diferente si es necesario.
   agentVerbatim (para datos conversacionales)	Sí	Realiza un seguimiento del lado del representante de la conversación en las interacciones de llamada y chat. Por defecto, este campo se asigna a: agentVerbatimChat para interacciones digitales agentVerbatimLlamada para interacciones de llamada Puede asignarlo a un campo textual diferente si es necesario.
   desconocido (para datos conversacionales)	Sí	Realiza un seguimiento del lado desconocido de la conversación en las interacciones de llamada y chat. Por defecto, este campo se asigna a: unknownVerbatimChat para interacciones digitales UnknownVerbatimLlamada para interacciones de llamada Puede asignarlo a un campo textual diferente si es necesario.
   document_date	Sí	Fecha de documento es el campo de fecha principal asociado a un documento. Esta fecha se utiliza en informes, tendencias, alertas, etc. de XM Discover. Para Fecha de documento, seleccione una de las siguientes opciones: conversationTimestamp (para datos conversacionales): Fecha y hora de toda la conversación. Si los datos de origen contienen otros campos de fecha, puede fijar uno de ellos como Fecha de documento seleccionándolo en el menú desplegable de la columna Nombre de campo. También puede fijar una fecha específica añadiendo un campo personalizado. Para obtener más detalles, consulte Fijar una fecha de documento específica.
   natural_id	Sí	El ID natural sirve como identificador único de un documento y permite procesar duplicados correctamente. Para ID natural, seleccione una de las siguientes opciones: conversationId (para datos conversacionales): un ID único para toda la conversación. Seleccione cualquier campo de texto o numérico de sus datos en la columna Nombre de campo. Genere ID automáticamente añadiendo un campo personalizado. Para obtener más detalles, consulte Generación automática de ID naturales.
   feedback_provider	No	El proveedor de comentarios le ayuda a identificar los datos obtenidos de un proveedor específico. Para las cargas de enlaces de XM Discover, el valor de este atributo se fija en “Enlace de XM Discover”.
   nombre_trabajo	Sí	El nombre de job le ayuda a identificar datos en función del nombre del job utilizado para cargarlo. Puede modificar el valor de este atributo en el cuadro Nombre del trabajo en la parte superior de la página.
   Fecha de carga	No	Fecha de carga indica cuándo se cargó un documento en XM Discover. Este campo se fija automáticamente.

3. En la sección Asignación de origen, configure el resto de los campos de datos.
   Consejo Q: Esta sección contiene asignaciones para los campos fuente que ha proporcionado a través del archivo de muestra. Si no ha proporcionado un archivo de muestra, deberá crear asignaciones manualmente. Para obtener más información sobre la asignación de datos, consulte Configuración de asignación de datos.
4. Haga clic en Siguiente.

Paso 6: Sustitución y modificación de datos (opcional)

1. En la página Sustitución y redacción de datos, puede proporcionar reglas de sustitución y redacción para ocultar datos confidenciales o sustituir automáticamente determinadas palabras y frases en el feedback y las interacciones del cliente.
   Consejo Q: Para obtener más información sobre la sustitución y la redacción de datos, consulte Sustitución y modificación de datos.
2. Haga clic en Siguiente.

Paso 7: Especificar filtro (opcional)

1. En la página Especificar filtro, puede definir una condición de filtro para que el job cargue solo los datos que coincidan con el filtro.
   Consejo Q: Para obtener más información sobre cómo filtrar datos de entrada, consulte Filtro de conector.
2. Haga clic en Siguiente.

Paso 8: Configurar opciones adicionales para el trabajo

1. En la página Configurar opciones adicionales para job, elija cómo XM Discover debe gestionar los documentos duplicados seleccionando uno de los siguientes modos de detección de duplicados en la sección Gestión de documentos nuevos y existentes:
   • Rechazar duplicados para documentos existentes y crear nuevos registros para documentos nuevos.
   • Actualizar atributos estructurados para documentos existentes y crear nuevos registros para documentos nuevos.
   • Actualizar atributos estructurados para documentos existentes y no crear registros para documentos nuevos.
     Atención: Cada documento debe tener un ID natural único para que el sistema pueda gestionar documentos duplicados que tengan IDs naturales idénticos.
     Consejo Q: Para obtener más información sobre los modos de detección de duplicados, consulte Detección de duplicados.
2. Haga clic en Siguiente.

Paso 9: Confirmar todas las parametrizaciones de job

1. En la página Confirmar todas las opciones de trabajo, puede ver un resumen de todas las opciones de un trabajo y editar las opciones, si es necesario.
2. Haga clic en el botón Finalizar para crear la tarea Enlace de XM Discover.
3. Una vez creado el job Enlace de XM Discover, puede utilizarlo para ejecutar llamadas API. Para obtener más detalles, consulte Información de punto final de API.

Cómo obtener información de punto final de API

Después de configurar un job de XM Discover Link, debe obtener la información del punto final de API necesaria para iniciar la carga de datos con ese job.

1. Inicie sesión en Conectores.
2. Asegúrese de que la pestaña JOBS esté abierta.
3. Busque el trabajo adecuado de XM Discover Link utilizando filtros o búsquedas.
4. Expanda el menú de acciones junto al trabajo y seleccione Resumen.
5. En la esquina superior derecha de la ventana Detalles de job: Nombre de job, haga clic en el enlace Documentación de API para abrir la Documentación de API de job. La siguiente tabla proporciona detalles de la información del punto final de API necesaria para iniciar la carga de datos mediante un job de XM Discover Link: