-
Qualtrics Platform -
Customer Journey Optimizer -
XM Discover -
Qualtrics Social Connect
Formatos de dados de interações digitais
Sobre formatos de dados de interações digitais
O XM Discover permite que você carregue interações digitais (ou seja, conversas) via CSV, Excel ou JSON. As interações digitais identificam os participantes em uma conversa e atribuem cada mensagem a um participante.
Normalmente, as interações digitais contêm vários campos de dados estruturados e não estruturados que representam uma conversa entre um cliente e uma entidade em sua empresa (por exemplo, a transcrição de texto entre um cliente e um chatbot em seu site ou a transcrição do chat entre um cliente e um representante de suporte ao vivo). Os campos estruturados podem conter datas, números ou dados de texto com um alto grau de organização (como nomes de marcas, nomes de participantes e produtos). Os campos não estruturados contêm notas, comentários e outros campos de texto aberto.
Você pode carregar interações digitais por meio dos seguintes formatos:
- CSV
- XLS ou XLSX (Microsoft Excel)
- JSON
Formatação CSV e Excel para interações digitais
Esta seção abrange a formatação para feedback individual para arquivos CSV e Excel. A formatação e os requisitos para os dois tipos de arquivo são os mesmos.
Em arquivos CSV e Excel, as interações digitais são definidas utilizando várias linhas. Veja como funciona:
- Cada linha contém uma linha individual de diálogo em uma conversação, juntamente com os dados do participante e um registro da hora.
- As linhas separadas são roladas em uma única conversação compartilhando o mesmo ID de conversação.
- Os valores de campo para toda a conversação (como Data do documento ou atributos personalizados) são retirados da primeira linha da conversação.
- Column headers should exactly match the fields in the table below.
The following table describes the fields in a digital interaction.
| Column Header | Descrição |
| conversationId
(obrigatório) |
Um código exclusivo para toda a conversação. Cada linha que tem o mesmo código é tratada como uma linha separada em uma única conversação.
Você pode mapear este campo para o atributo natural_id para usá-lo como o ID natural do documento. |
| conversationTimestamp
(obrigatório) |
The date and time for the entire conversation. Usually, this is when the conversation begins. Use o formato ISO 8601 com precisão de segundos.
Você pode mapear este campo para o atributo document_date para usá-lo como Data do documento. |
| participantId
(obrigatório) |
O código do participante. Each unique participant in a conversation must have a different ID.
You can have the same participant ID across multiple conversations (e.g., the same agent across many interactions) but within a conversation, it can’t be the same. |
| participantType
(obrigatório) |
O tipo do participante. Valores possíveis:
Esses valores são transferidos para o atributo Tipo de participante CB para relatórios e visualização de participantes. Se não especificado, o Tipo de Participante CB não terá valor relatável. |
| is_bot
(opcional) |
Um campo booleano que indica se um participante é um chatbot ou uma pessoa.
Esses valores são transferidos para o atributo Tipo de participante CB para relatórios e visualização de participantes. Se não especificado, o tipo de participante CB não terá valor sujeito a notificação. |
| texto
(obrigatório) |
O texto da mensagem.
Atenção: um total de todos os elementos de texto não pode exceder 100.000 caracteres. If it does, the conversation is skipped.
|
| timestamp
(obrigatório) |
A data e hora da mensagem. Use o formato ISO 8601 com precisão de segundos. |
| campos personalizados
(opcional) |
Você pode fornecer vários campos para adicionar atributos estruturados à conversação. |
Formatação JSON para interações digitais
Objetos de nível superior
A tabela a seguir descreve os objetos de nível superior de um nó de documento.
| Elemento | Descrição |
| conversationId | Um código exclusivo para toda a conversação.
Você pode mapear este campo para o atributo natural_id para usá-lo como o ID natural do documento. |
| conversationTimestamp | The date and time for the entire conversation. Usually, this is when the conversation begins. Use o formato ISO 8601 com precisão de segundos.
Você pode mapear este campo para o atributo document_date para usá-lo como Data do documento. |
| conteúdo | Um objeto que contém o conteúdo da conversação. Inclui estes objetos aninhados:
|
| campos personalizados (atributos) | Você pode fornecer vários pares chave-valor para adicionar atributos estruturados à conversação. |
Objeto de conteúdo
A tabela seguinte descreve os objetos aninhados dentro do objeto de conteúdo.
| Elemento | Descrição |
| participantes | Uma matriz de objetos que fornece informações sobre os participantes da conversação. Inclui estes campos:
|
| conversationContent | Uma matriz de objetos que contém as linhas da conversação. Inclui estes campos:
|
objeto participante
A tabela seguinte descreve os campos aninhados dentro do objeto de participantes.
| Elemento | Descrição |
| participantId
(obrigatório) |
O código do participante. Each unique participant in a conversation must have a different ID.
You can have the same participant ID across multiple conversations (e.g., the same agent across many interactions) but within a conversation, it can’t be the same. |
| participantType
(obrigatório) |
O tipo do participante. Valores possíveis:
Esses valores são transferidos para o atributo Tipo de participante CB para relatórios e visualização de participantes. Se não especificado, o Tipo de Participante CB não terá valor relatável. |
| is_bot
(opcional) |
Um campo booleano que indica se um participante é um chatbot ou uma pessoa.
Esses valores são transferidos para o atributo Tipo de participante CB para relatórios e visualização de participantes. Se não especificado, o tipo de participante CB não terá valor sujeito a notificação. |
Objeto conversationContent
A tabela seguinte descreve os campos aninhados dentro do objeto conversationContent.
| Elemento | Descrição |
| participantId
(obrigatório) |
O ID do participante que está falando. Deve corresponder a um dos códigos fornecidos na matriz de participantes. |
| texto
(obrigatório) |
Transcrição da fala.
Atenção: um total de todos os elementos de texto não pode exceder 100.000 caracteres. If it does, the conversation is skipped.
|
| timestamp
(obrigatório) |
A data e hora da mensagem. Use o formato ISO 8601 com precisão de segundos. |
| id
(obrigatório) |
O código exclusivo da mensagem. |
JSON de exemplo
Aqui está um exemplo de uma transcrição de chamada entre um agente e um cliente.
[
{
"conversationId": "37852",
"conversationTimestamp": "2020-07-30T12:42:15.000Z",
"content": {
"participant" "participant": [
"participantId": "
,
participantType":
"ENT AG_bot", "
" "
" "
",
"timestamp": "2020-07-30T12:42:15.000Z",
"id": "3785201"
},
{
"participantId": "2",
"text": "Oi, você está aberto hoje?",
"timestamp": "2020-07-30T12:42:15.000Z",
"id": "3785202"
},
"participantId": "1",
"text": "We're open from 17:00 till 23:00.",
"timestamp": "2020-07-30T12:42:15.000Z",
"make"id": "
" "
" "
" "
" "
" "
" "
" "
" "
" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "
" "" "" "
" "" "" "" "" "" Que nome posso usar?",
"timestamp": "2020-07-30T12:42:15.000Z",
"id": "3785205"
}
]
},
"city": "Boston",
"source": "Facebook"
}
]