XM Scopri la panoramica dei formati di dati
Informazioni su XM Discover Data Format
XM Discover supporta 3 diversi formati di dati che puoi caricare utilizzando diversi tipi di file.
I seguenti connettori supportano il caricamento di dati tramite file:
- Connettore in entrata upload file ad hoc
- Connettore di entrata file
- Connettore XM Discover Link Inbound
Suggerimento: il connettore in entrata XM Discover Link gestisce i caricamenti di dati tramite chiamate API in cui i dati vengono presentati in formato JSON.
Feedback individuale
Il formato feedback individuale viene utilizzato per i documenti che presentano dati come oggetto a riga singola o “piatta”. Ogni documento può contenere diversi campi verbatim, ma di solito provengono da un singolo autore (ad esempio, quando un sondaggio contiene più di una domanda aperta).
È possibile caricare singoli documenti di feedback tramite:
Interazioni digitali
Il formato delle interazioni digitali viene utilizzato per i documenti che contengono dati conversazionali come le chat.
Le interazioni digitali devono seguire il formato conversazionale Qualtrics che aiuta il sistema a comprendere dettagli chiave quali altoparlanti, sequenze ed eventi conversazionali. Un formato conversazionale simile viene utilizzato per le trascrizioni delle chiamate.
È possibile caricare interazioni digitali tramite:
Trascrizioni di chiamate
Il formato delle trascrizioni di chiamate viene utilizzato per i documenti che contengono dati conversazionali come le chiamate di supporto.
Le trascrizioni delle chiamate devono seguire il formato conversazionale Qualtrics che aiuta il sistema a comprendere dettagli chiave quali altoparlanti, sequenze ed eventi conversazionali. Un formato conversazionale simile viene utilizzato per le interazioni digitali.
È possibile caricare le trascrizioni delle chiamate tramite:
Errori file campione
Diversi job del connettore consentono di caricare file campione (ad esempio upload di file ad hoc, file o job di collegamento XM Discover). Se il file di esempio non è configurato correttamente, verrà visualizzato un messaggio di errore che richiede di correggere eventuali problemi. In questa sezione vengono descritti i diversi possibili errori e come risolverli.
Errori CSV ed Excel
Per i file di esempio CSV ed Excel (XLS, XLSX) sono possibili i seguenti errori:
- Il file deve avere la proprietà richiesta “REQUIRED_FIELD”: manca un campo obbligatorio. Consultare la documentazione relativa a quel connettore specifico per ulteriori informazioni sui campi richiesti per tale connessione e assicurarsi che il campo elencato sia incluso nel file di esempio.
- Valori participantType incoerenti per l’ID participantId: ogni partecipante a una conversazione può avere un solo valore participantType definito. Rivedere il file di esempio per tutti i partecipanti con più participantType.
- Il numero di colonne non corrisponde alle intestazioni: ogni colonna deve avere un’intestazione e il numero di colonne in ogni riga deve essere uguale.
- La riga ROW_NUMBER della colonna COLUMN_NAME deve corrispondere al formato data/ora ISO 8601 AAAA-MM-GGThh:mm:ss.sZ: per le date, utilizzare il formato ISO 8601 con precisione dei secondi.
Errori JSON
Per i file JSON sono possibili i seguenti errori:
- Errore in JSON_DATA_PATH: deve essere una stringa del formato data-ora ISO 8601 AAAA-MM-GGThh:mm:ss.sZ: per le date, utilizzare il formato ISO 8601 con precisione dei secondi.
- Errore in JSON_DATA_PATH: deve essere una stringa del valore AGENT, CLIENT o TYPE_UNKNOWN: participantType nel percorso specificato non è valido. Devono essere utilizzati solo i seguenti valori:
- AGENT indica un rappresentante della società o un chatbot.
- CLIENT indica un cliente.
- TYPE_UNKNOWN indica un partecipante non identificato.
- Errore in JSON_DATA_PATH: dovrebbe essere DATA_TYPE: il valore del campo è il tipo di dati errato. Assicurarsi che il tipo di dati corrisponda a quanto contenuto nella mappatura dei dati del connettore.
- Errore in JSON_DATA_PATH: deve avere la proprietà REQUIRED_FIELD: manca un campo obbligatorio. Consultare la documentazione relativa a quel connettore specifico per ulteriori informazioni sui campi richiesti per tale connessione e assicurarsi che il campo elencato sia incluso nel file di esempio.
- Errore in JSON_DATA_PATH: impossibile trovare il partecipante con ID participantId nei partecipanti: gli ID partecipante devono corrispondere a uno degli ID forniti nell’elenco dei partecipanti. Assicurarsi che l’ID elencato sia incluso nel file di esempio.