Formatos de datos de interacciones digitales
Contenidos de la página
Acerca de los formatos de datos de interacciones digitales
XM Discover le permite cargar interacciones digitales (es decir, conversaciones) mediante CSV, Excel o JSON. Las interacciones digitales identifican a los participantes de una conversación y atributo cada mensaje a un participante.
Normalmente, las interacciones digitales contienen una serie de campos de datos estructurados y no estructurados que representan una conversación entre un cliente y una entidad de su empresa (por ejemplo, la transcripción de texto entre un cliente y un chatbot en su sitio web, o la transcripción del chat entre un cliente y un representante de soporte en vivo). Los campos estructurados pueden contener fechas, números o datos de texto con un alto grado de organización (como nombres de marcas, nombres de participante y productos). Los campos no estructurados contienen notas, comentarios y otros campos de texto libre .
Puede cargar interacciones digitales a través de los siguientes formatos:
- CSV
- XLS o XLSX (Microsoft Excel)
- JSON
Formato CSV y Excel para interacciones digitales
Esta sección cubre el formato para opinión individuales para archivos CSV y Excel. El formato y los requisitos para ambos tipos de archivos son los mismos.
En archivos CSV y Excel, las interacciones digitales se definen utilizando varias filas. Así es como funciona:
- Cada fila contiene una línea individual de diálogo en una conversación, junto con los datos de los participante y una marca de tiempo.
- Las filas separadas que pertenecen a la misma conversación se identifican con el mismo ID de conversación.
- Los valores de campo de toda la conversación (como la fecha del documento o los atributos personalizados) se toman de la primera fila de la conversación.
- Los encabezados de columnas deben coincidir exactamente con los campos de la tabla siguiente.
Una vez que hayas creado tu archivo, ordénalo por ID de conversación de modo que todas las filas de una interacción determinada se agrupan. Luego, ordena el archivo por ConversaciónMarca de tiempo Así que las conversaciones están en orden cronológico.
Campos de interacción digital
| Encabezado de columna | Descripción |
|---|---|
ID de conversación (Requerido) | Una identificación única para toda la conversación. Cada fila que tiene el mismo ID se trata como una línea separada dentro de una sola conversación. Puedes asignar este campo al id_natural atributo para usarlo como identificador natural del documento. |
ConversaciónMarca de tiempo (Requerido) | La fecha y hora de toda la conversación. Generalmente es aquí cuando comienza la conversación. Utilice el ISO 8601 formato con precisión de segundos. Puedes asignar este campo al fecha_documento atributo para usarlo como fecha del documento. |
Id. del participante (Requerido) | El ID del participante. Cada participante único en una conversación debe tener una identificación diferente. Puedes tener el mismo ID de participante en varias conversaciones (por ejemplo, el mismo agente en muchas interacciones), pero dentro de una misma conversación, no puede ser el mismo. |
tipo de participante (Requerido) | El tipo de participante. Valores posibles:
Estos valores se transmiten a través de Tipo de Participante de CB atributo para la visualización de informes y participantes. Si no se especifica, Tipo de Participante de CB no tendrá ningún valor informativo. |
es_bot (Opcional) | Un campo booleano que indica si un participante es un chatbot o una persona.
Estos valores se transmiten a través de Tipo de Participante CB atributo para la visualización de informes y participantes. Si no se especifica, Tipo de Participante CB no tendrá ningún valor informativo. |
text (Requerido) | El texto del mensaje.
|
marca de tiempo (Requerido) | La fecha y hora del mensaje. Utilice el ISO 8601 formato con precisión de segundos. |
campos personalizados (Opcional) | Puede proporcionar varios campos para agregar atributos estructurados a la conversación. |
Formato JSON para interacciones digitales
Esta sección contiene los requisitos de formato JSON para interacciones digitales.
Objetos de nivel superior
La siguiente tabla describe los objetos de nivel superior de un nodo de documento.
| Elemento | Descripción |
|---|---|
| ID de conversación | Una identificación única para toda la conversación. Puedes asignar este campo al id_natural atributo para usarlo como identificador natural del documento. |
| ConversaciónMarca de tiempo | La fecha y hora de toda la conversación. Generalmente es aquí cuando comienza la conversación. Utilice el ISO 8601 formato con precisión de segundos. Puedes asignar este campo al fecha_documento atributo para usarlo como fecha del documento. |
| contenido | Un objeto que contiene el contenido de la conversación. Incluye estos objetos anidados:
|
| campos personalizados (atributos) | Puede proporcionar múltiples pares clave-valor para agregar atributos estructurados a la conversación. |
objeto de contenido
La siguiente tabla describe los objetos anidados dentro de la contenido objeto.
| Elemento | Descripción |
|---|---|
| participantes | Una matriz de objetos que proporciona información sobre los participantes de la conversación. Incluye estos campos:
|
| conversaciónContenido | Una matriz de objetos que contiene las líneas de la conversación. Incluye estos campos:
|
Participantes Objeto
La siguiente tabla describe los campos anidados dentro de la participantes objeto.
| Elemento | Descripción |
|---|---|
Id. del participante (obligatorio) | El ID del participante. Cada participante único en una conversación debe tener una identificación diferente. Puedes tener el mismo ID de participante en varias conversaciones (por ejemplo, el mismo agente en muchas interacciones), pero dentro de una misma conversación, no puede ser el mismo. |
tipo de participante (Requerido) | El tipo de participante. Valores posibles:
Estos valores se transmiten a través de Tipo de Participante de CB atributo para la visualización de informes y participantes. Si no se especifica, Tipo de Participante de CB no tendrá ningún valor informativo. |
es_bot (Opcional) | Un campo booleano que indica si un participante es un bot de chat o una persona.
Estos valores se transmiten a través de Tipo de Participante CB atributo para la visualización de informes y participantes. Si no se especifica, Tipo de Participante CB no tendrá ningún valor informativo. |
Objeto de contenido de conversación
La siguiente tabla describe los campos anidados dentro de la ConversaciónContenido objeto.
| Elemento | Descripción |
|---|---|
Id. del participante (Requerido) | El ID del participante que está hablando. Debe coincidir con una de las identificaciones proporcionadas en el Participantes formación. |
text (Requerido) | Transcripción del discurso.
|
marca de tiempo (Requerido) | La fecha y hora del mensaje. Utilice el ISO 8601 formato con precisión de segundos. |
identificador (Requerido) | El identificador único del mensaje. |
Ejemplo JSON
Aquí tienen un ejemplo de la transcripción de una llamada entre un agente y un cliente.
[{"conversationId": "37852","conversationTimestamp": "2020-07-30T12:42:15.000Z","contenido": {"participantes": [{"participantId": "1","tipo de participante": "AGENTE","is_bot": true},{"participantId": "2","tipo de participante": "CLIENTE","is_bot": false}],"conversationContent": [{"participantId": "1","texto": "Hola, ¿en qué puedo ayudarle?","marca de tiempo": "2020-07-30T12:42:15.000Z","id": "3785201"},{"participantId": "2","texto": "Hola, ¿están abiertos hoy?","marca de tiempo": "2020-07-30T12:42:15.000Z","id": "3785202"},{"participantId": "1","texto": "Estamos abiertos de 17:00 a 23:00.","marca de tiempo": "2020-07-30T12:42:15.000Z","id": "3785203"},{"participantId": "2","texto": "Me gustaría hacer una reserva.","marca de tiempo": "2020-07-30T12:42:15.000Z","id": "3785204"},{"participantId": "1","texto": "¡Absolutamente! ¿Qué nombre puedo usar?"marca de tiempo": "2020-07-30T12:42:15.000Z","id": "3785205"}]},"ciudad": "Boston","fuente": "Facebook"}]
¡Genial! ¡Gracias por tus comentarios!
¡Gracias por tus comentarios!