-
Qualtrics Platform -
Customer Journey Optimizer -
XM Discover -
Qualtrics Social Connect
Plantilla de artículo
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 haya creado su archivo, ordénelo por ID de conversación De esta forma, todas las filas de una interacción dada 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.
Puede asignar este campo a la identificación natural atributo para usarlo como ID 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.
Puede asignar este campo a la fecha del 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.
Puede tener el mismo ID de participante en múltiples conversaciones (por ejemplo, el mismo agente en muchas interacciones), pero dentro de una conversación, no puede ser el mismo. |
| tipo de participante
(Requerido) |
El tipo de participante. Valores posibles:
Estos valores se transmiten a la Tipo de Participante del CB atributo para informes y visualización de participantes. Si no se especifica, Tipo de Participante del CB no tendrá valor declarable. |
| es_bot
(Opcional) |
Un campo booleano que indica si un participante es un chatbot o una persona.
Estos valores se transmiten a la CB Tipo de Participante atributo para informes y visualización de participantes. Si no se especifica, CB Tipo de Participante no tendrá valor declarable. |
| texto
(Requerido) |
El texto del mensaje.
Atención: Una suma de todo texto Los elementos no pueden exceder los 100.000 caracteres. Si es así, se omite la conversación.
|
| 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
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.
Puede asignar este campo a la identificación natural atributo para usarlo como ID 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.
Puede asignar este campo a la fecha del 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 del 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 del Participantes objeto.
| Elemento | Descripción |
| Id. del participante
(requerido) |
El ID del participante. Cada participante único en una conversación debe tener una identificación diferente.
Puede tener el mismo ID de participante en múltiples conversaciones (por ejemplo, el mismo agente en muchas interacciones), pero dentro de una conversación, no puede ser el mismo. |
| tipo de participante
(Requerido) |
El tipo de participante. Valores posibles:
Estos valores se transmiten a la Tipo de Participante del CB atributo para informes y visualización de participantes. Si no se especifica, Tipo de Participante del CB no tendrá valor declarable. |
| es_bot
(Opcional) |
Un campo booleano que indica si un participante es un bot de chat o una persona.
Estos valores se transmiten a la CB Tipo de Participante atributo para informes y visualización de participantes. Si no se especifica, CB Tipo de Participante no tendrá valor declarable. |
Objeto de contenido de conversación
La siguiente tabla describe los campos anidados dentro del 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. |
| texto
(Requerido) |
Transcripción del discurso.
Atención: Una suma de todo texto Los elementos no pueden exceder los 100.000 caracteres. Si es así, se omite la conversación.
|
| marca de tiempo
(Requerido) |
La fecha y hora del mensaje. Utilice el ISO 8601 formato con precisión de segundos. |
| identificación
(Requerido) |
El identificador único del mensaje. |
Ejemplo JSON
A continuación se muestra un ejemplo de una transcripción de una llamada entre un agente y un cliente.
[
{
"conversationId": "37852",
"conversationTimestamp": "2020-07-30T12:42:15.000Z",
"contenido": {
"participantes": [
{
"participanteId": "1",
"participantType": "AGENTE",
"is_bot": verdadero
},
{
"participanteId": "2",
"participantType": "CLIENTE",
"is_bot": falso
}
],
"contenido de la conversación": [
{
"participanteId": "1",
"text": "Hola, ¿en qué puedo ayudarle?",
"marca de tiempo": "2020-07-30T12:42:15.000Z",
"id": "3785201"
},
{
"participanteId": "2",
"text": "Hola, ¿estás abierto hoy?",
"marca de tiempo": "2020-07-30T12:42:15.000Z",
"id": "3785202"
},
{
"participanteId": "1",
"text": "Estamos abiertos desde las 17:00 hasta las 23:00.",
"marca de tiempo": "2020-07-30T12:42:15.000Z",
"id": "3785203"
},
{
"participanteId": "2",
"text": "Me gustaría hacer una reserva.",
"marca de tiempo": "2020-07-30T12:42:15.000Z",
"id": "3785204"
},
{
"participanteId": "1",
"texto": "¡Por supuesto! ¿Qué nombre puedo utilizar?",
"marca de tiempo": "2020-07-30T12:42:15.000Z",
"id": "3785205"
}
]
},
"ciudad": "Boston",
"fuente": "Facebook"
}
]