Formati dei dati delle interazioni digitali
Cosa puoi trovare in questa pagina
Informazioni sui formati dei dati delle interazioni digitali
XM Discover consente di caricare le interazioni digitali (cioè le conversazioni) tramite CSV, Excel o JSON. Le interazioni digitali identificano i partecipanti a una conversazione e attribuiscono ogni messaggio a un partecipante.
In genere, le interazioni digitali contengono una serie di campi dati strutturati e non strutturati che rappresentano una conversazione tra un cliente e un'entità della vostra azienda (ad esempio, la trascrizione del testo tra un cliente e un chatbot sul vostro sito web o la trascrizione della chat tra un cliente e un rappresentante dell'assistenza dal vivo). I campi strutturati possono contenere date, numeri o dati testuali con un alto grado di organizzazione (come nomi di brand, nomi di partecipanti e prodotti). I campi non strutturati contengono note, commenti e altre risposte aperte.
È possibile caricare le interazioni digitali nei seguenti formati:
- CSV
- XLS o XLSX (Microsoft Excel)
- JSON
Formattazione CSV ed Excel per le interazioni digitali
Questa sezione tratta la formattazione dei feedback individuali per i file CSV ed Excel. La formattazione e i requisiti per entrambi i tipi di file sono gli stessi.
Nei file CSV ed Excel, le interazioni digitali vengono definite utilizzando più righe. Ecco come funziona:
- Ogni riga contiene una singola riga di dialogo di una conversazione, insieme ai dati dei partecipanti e a un timestamp.
- Le righe separate che appartengono alla stessa conversazione sono identificate dallo stesso ID di conversazione.
- I valori dei campi personalizzati (come la data del documento o gli attributi personalizzati) vengono presi dalla prima riga della conversazione.
- Le intestazioni delle colonne devono corrispondere esattamente ai campi della tabella seguente.
Una volta creato il file, ordinalo in base al conversationId in modo che tutte le righe relative a una determinata interazione siano raggruppate insieme. Quindi, ordinare il file per conversationTimestamp in modo che le conversazioni siano in ordine cronologico.
Campi di interazione digitale
| Intestazione della colonna | Descrizione |
|---|---|
iD conversazione (Richiesto) | Un ID unico per l'intera conversazione. Ogni riga con lo stesso ID viene trattata come una riga separata all'interno di una singola conversazione. È possibile associare questo campo all'attributo natural_id per utilizzarlo come ID naturale del documento. |
conversazioneTimestamp (Richiesto) | La data e l'ora dell'intera conversazione. Di solito, è a questo punto che inizia la conversazione. Utilizzare il formato ISO 8601 con la precisione dei secondi. È possibile associare questo campo all'attributo " document_date " per utilizzarlo come "Data del documento". |
partecipanteId (Richiesto) | L'ID del partecipante. Ogni singolo partecipante a una conversazione deve avere un ID diverso. È possibile utilizzare lo stesso ID partecipante in più conversazioni (ad esempio, lo stesso agente in diverse interazioni), ma all’interno di una stessa conversazione non può essere lo stesso. |
partecipanteTipo (Richiesto) | Il tipo di partecipante. Valori possibili:
Questi valori vengono trasmessi all'attributo " Tipo di partecipante CB " ai fini della rendicontazione e della visualizzazione dei partecipanti. Se non specificato, il “Tipo di partecipante CB” non avrà alcun valore da segnalare. |
is_bot (Facoltativo) | Campo booleano che indica se il partecipante è un chatbot o una persona.
Questi valori vengono trasferiti all'attributo " Tipo di partecipante " del CB ai fini della rendicontazione e della visualizzazione dei partecipanti. Se non specificato, il campo “Tipo di partecipante CB” non avrà alcun valore da segnalare. |
testo (Richiesto) | Il testo del messaggio.
|
timestamp (Richiesto) | La data e l'ora del messaggio. Utilizzare il formato ISO 8601 con la precisione dei secondi. |
campi personalizzati (Facoltativo) | È possibile fornire più campi per aggiungere attributi strutturati alla conversazione. |
Formattazione JSON per le interazioni digitali
Questa sezione contiene i requisiti di formattazione JSON per le interazioni digitali.
Oggetti di livello superiore
La tabella seguente descrive gli oggetti di primo livello di un nodo documento.
| Elemento | Descrizione |
|---|---|
| iD conversazione | Un ID unico per l'intera conversazione. È possibile associare questo campo all'attributo natural_id per utilizzarlo come ID naturale del documento. |
| conversazioneTimestamp | La data e l'ora dell'intera conversazione. Di solito, è a questo punto che inizia la conversazione. Utilizzare il formato ISO 8601 con la precisione dei secondi. È possibile associare questo campo all'attributo " document_date " per utilizzarlo come "Data del documento". |
| contenuto | Un oggetto che contiene il contenuto della conversazione. Include questi oggetti annidati:
|
| campi personalizzati (attributi) | È possibile fornire più coppie chiave-valore per aggiungere attributi strutturati alla conversazione. |
contenuto Oggetto
La tabella seguente descrive gli oggetti annidati all'interno dell'oggetto "contenuto ".
| Elemento | Descrizione |
|---|---|
| partecipanti | Un array di oggetti che fornisce informazioni sui partecipanti alla conversazione. Include questi campi:
|
| conversazioneContenuto | Un array di oggetti che contiene le righe della conversazione. Include questi campi:
|
pARTECIPANTI Oggetto
La tabella seguente descrive i campi contenuti nell'oggetto " partecipanti ".
| Elemento | Descrizione |
|---|---|
partecipanteId (Obbligatorio) | L'ID del partecipante. Ogni singolo partecipante a una conversazione deve avere un ID diverso. È possibile utilizzare lo stesso ID partecipante in più conversazioni (ad esempio, lo stesso agente in diverse interazioni), ma all’interno di una stessa conversazione non può essere lo stesso. |
partecipanteTipo (Richiesto) | Il tipo di partecipante. Valori possibili:
Questi valori vengono trasmessi all'attributo " Tipo di partecipante CB " ai fini della rendicontazione e della visualizzazione dei partecipanti. Se non specificato, il “Tipo di partecipante CB” non avrà alcun valore da segnalare. |
is_bot (Facoltativo) | Campo booleano che indica se il partecipante è un chat bot o una persona.
Questi valori vengono trasferiti all'attributo " Tipo di partecipante " del CB ai fini della rendicontazione e della visualizzazione dei partecipanti. Se non specificato, il campo “Tipo di partecipante CB” non avrà alcun valore da segnalare. |
oggetto conversationContent
La tabella seguente descrive i campi contenuti all'interno dell'oggetto conversationContent.
| Elemento | Descrizione |
|---|---|
partecipanteId (Richiesto) | L'ID del partecipante che sta parlando. Deve corrispondere a uno degli ID forniti nell'array dei partecipanti. |
testo (Richiesto) | Trascrizione del discorso.
|
timestamp (Richiesto) | La data e l'ora del messaggio. Utilizzare il formato ISO 8601 con la precisione dei secondi. |
id (Richiesto) | L'ID univoco del messaggio. |
Esempio di JSON
Ecco un esempio di trascrizione di una chiamata tra un operatore e un cliente.
[{"conversationId": "37852","conversationTimestamp": "2020-07-30T12:42:15.000Z","content": {"partecipanti": [{"partecipanteId": "1","partecipanteType": "AGENT","is_bot": true},{"participantId": "2","participantType": "CLIENT","is_bot": false}],"conversationContent": [{"participantId": "1","text": "Salve, come posso aiutarla?","timestamp": "2020-07-30T12:42:15.000Z","id": "3785201"},{"participantId": "2","text": "Ciao, siete aperti oggi?","timestamp": "2020-07-30T12:42:15.000Z","id": "3785202"},{"participantId": "1","text": "Siamo aperti dalle 17:00 alle 23:00.","timestamp": "2020-07-30T12:42:15.000Z","id": "3785203"},{"participantId": "2","text": "Vorrei effettuare una prenotazione.","timestamp": "2020-07-30T12:42:15.000Z","id": "3785204"},{"participantId": "1","text": "Certamente! "Che nome posso usare?","timestamp": "2020-07-30T12:42:15.000Z","id": "3785205"}]},"città": "Boston","fonte": "Facebook"}]
È fantastico! Grazie per il tuo feedback!
Grazie per il tuo feedback!