Configurazione di un processo di collegamento XM Discover
Informazioni su XM Discover Link Connector
È possibile utilizzare il connettore XM Discover Link per inviare i dati XM in XM Discover tramite un endpoint API REST, sfruttando al contempo tutte le funzionalità offerte dal framework Connettori, quali mappatura dei campi, trasformazioni, filtri, monitoraggio di lavoro e così via.
Il connettore XM Discover Link consente di inserire i dati al ritmo desiderato, mentre altri connettori recuperano i dati in base a una pianificazione.
Formati di dati supportati
Il connettore XM Discover Link supporta il caricamento dei seguenti tipi di dati:
- Feedback individuale
- Interazioni digitali
- Trascrizioni di chiamate
Tutti i documenti vengono forniti in formato JSON che dipende dal tipo di dati.
Per ulteriori informazioni sui formati di dati supportati da XM Discover, consultare XM Scopri la panoramica dei formati di dati.
Ecco come funziona il connettore XM Discover Link:
- Il primo passo per utilizzare il connettore XM Discover Link è configurare un job di elaborazione e configurare parametri e mappaggi per chiamate API future. Per i dettagli, consultare Creazione di un lavoro XM Discover Link.
- Una volta configurato un processo di elaborazione, è possibile eseguire chiamate API attraverso il processo di elaborazione corretto facendo riferimento al suo ID. Tutte le informazioni sull’endpoint API necessarie vengono fornite nel riepilogo del processo di elaborazione. Per i dettagli, consultare Informazioni endpoint API.
Configurazione della connessione
Prima di iniziare
Prima di configurare un job di collegamento XM Discover, si consiglia di preparare un file campione con dati cliente in formato JSON utilizzando uno dei seguenti tipi di dati:
- Feedback individuale: per dettagli, consultare Feedback individuale in formato JSON.
- Interazioni digitali: per i dettagli, consultare Interazioni digitali in formato JSON.
- Trascrizioni delle chiamate: per i dettagli, consultare Trascrizioni di chiamate in formato JSON.
Per configurare la connessione:
- Accedere ai connettori.
- Fare clic sul pulsante Nuovo processo nell’angolo in alto a destra della pagina Processi.
- Nella pagina Connettori, passare alla sezione SELEZIONA ORIGINE.
- Fai clic sul pulsante XM Discover Link.
Creazione di un processo XM Discover Link Inbound Connector
Dopo aver configurato la connessione, segui questi passaggi per creare un processo del connettore in entrata XM Discover Link e configurare i dati da inviare a XM Discover.
- Fase 1: fornisci nome job
- Fase 2: specificare progetto e descrizione
- Passo 3: modalità di autorizzazione
- Passaggio 4: seleziona il file di esempio
- Passaggio 5: Mappa i campi desiderati in XM Discover
- Passo 6: Sostituzione e Redazione dei Dati (Facoltativo)
- Fase 7: specificare il filtro (facoltativo)
- Passo 8: Configura opzioni aggiuntive per il job
- Passaggio 9: Conferma tutte le impostazioni del processo
Fase 1: fornisci nome job
Immettere un nome processo riconoscibile nella casella Nome processo nella parte superiore della pagina.
Fase 2: specificare progetto e descrizione
- Nella pagina Specifica progetto e descrizione, selezionare il progetto in cui devono essere caricati i dati dal menu a discesa dei progetti.
Consiglio Q: è possibile inserire una nota relativa al processo nella casella Descrizione lavoro. La descrizione processo immessa nella casella “Descrizione processo” è accessibile solo nell’elenco Connettori e non viene caricata come parte dei dati di un processo.
- Fare clic su Successivo.
Passo 3: modalità di autorizzazione
Nella pagina Authorization Mode selezionare la modalità di autorizzazione che si intende utilizzare per le chiamate API:
- Chiave API: utilizzare i token API generati da XM Discover. Per ulteriori informazioni sui token API, consultare Token API.
- OAUTH 2.0: Utilizza ID client e chiave client segreta forniti dal servizio di autenticazione XM Discover. Contatta il tuo Customer Success Manager di Qualtrics per richiedere questo metodo.
Passaggio 4: seleziona il file di esempio
- Nella pagina Seleziona file di esempio, in Scegli formato dati, selezionare il tipo di dati da elaborare da questo processo:
- Chat: elabora le interazioni digitali con più linee di dialogo tra due o più partecipanti. Le interazioni digitali devono seguire un formato predefinito; è possibile scaricare un template dopo aver selezionato il formato dei dati.
- Chiamata: carica le trascrizioni delle chiamate con più linee di dialogo tra due o più partecipanti. Le trascrizioni delle chiamate devono seguire un formato predefinito; è possibile scaricare un template dopo aver selezionato il formato dei dati.
- Feedback: documenti di processo presentati come oggetti a riga singola o “piatta”.
- Dall’elenco di riepilogo a discesa Modello, selezionare un modello da utilizzare.
Consiglio Q: Le opzioni del modello disponibili sono diverse a seconda del formato di dati scelto.
Formato dati Opzioni modello Chat - Chat (impostazione predefinita): da utilizzare per i dati delle interazioni digitali standard.
- Amazon Connect: utilizzare per interazioni digitali specifiche per Amazon Connect Chat.
Chiamata - Chiamata (default): utilizzo per i dati delle trascrizioni di chiamate standard.
- Versione: utilizzare per trascrizioni di chiamata specifiche di Verint.
Consiglio Q: per ulteriori informazioni sul formato di esportazione di Interaction Analytics di Verint, fare riferimento alla documentazione di Verint.Feedback - Nessuno (impostazione predefinita): non applicare modelli.
- Dynamics 365: utilizzare per i dati di Microsoft Dynamics.
- Nella casella Percorso JSON, specificare il percorso JSON per un sottoinsieme di JSON che contiene nodi documento.
Suggerimento Q: lasciarlo vuoto se i documenti si trovano a livello del nodo radice.
- Fare clic sul pulsante Fare clic su per selezionare il file da caricare e puntare al file di esempio o rilasciare il file nell’area di disegno grigia.
- Attendi finché XM Discover non carica il file campione e visualizza l’anteprima di seguito.
Consiglio Q: Se si visualizza un messaggio di errore e il contenuto del file grezzo invece dell’anteprima, potrebbe esserci un problema con le opzioni di formato dei dati selezionate. Per informazioni sui messaggi di errore relativi alla convalida non riuscita dei file campione, consultare Errori file campione.
- Accertarsi che i dati siano corretti.
- Fare clic su Successivo.
Passaggio 5: Mappa i campi desiderati in XM Discover
- Nella pagina Mappa i campi desiderati in XM Discover, seleziona la scheda MAPPATURA ORIGINE per collegare i campi dati sorgente ai campi dati nel tuo progetto XM Discover.
- Nella sezione Mappatura origine predefinita, configurare i campi dati predefiniti che tutti i documenti in XM Discover condividono. La seguente tabella fornisce una panoramica delle opzioni predefinite dei campi dati per il connettore in entrata XM Discover Link.
Nome campo Modificabile? Descrizione feedback_type Sì Il tipo di feedback consente di identificare i dati in base al tipo. Ciò è utile per il reporting quando il progetto contiene diversi tipi di dati (ad esempio, questionari e feedback sui social media). Per impostazione predefinita, il valore di questo attributo è impostato su:
- “chiamata” per trascrizioni di chiamate
- “chat” per interazioni digitali
- “feedback” per feedback individuale
Utilizzare la trasformazione personalizzata per impostare un valore personalizzato, definire un’espressione o mapparla a un determinato campo.
fonte d’acquisto Sì L’origine consente di identificare i dati ottenuti da un’origine specifica. Può trattarsi di qualsiasi elemento che descriva l’origine dei dati, ad esempio il nome di un’indagine o di una campagna di marketing mobile. Per impostazione predefinita, il valore di questo attributo è impostato su “XM Discover Link”.
Utilizzare la trasformazione personalizzata per impostare un valore personalizzato, definire un’espressione o mapparla a un determinato campo.
richVerbatim (per dati conversazionali)
No Per i dati conversazionali (come le interazioni chiamata e chat), XM Discover utilizza un formato verbale conversazionale per il campo richVerbatim. Questo formato supporta l’inserimento di metadati specifici della finestra di dialogo necessari per sbloccare la visualizzazione conversazionale (giri di oratori, silenzio, eventi conversazionali e così via) e arricchimenti (ora di inizio, durata e così via). Questo campo verbatim include campi “bambino” per monitorare il lato del cliente e del rappresentante della conversazione: - clientVerbatim traccia il lato del client della conversazione.
- agentVerbatim traccia il lato della conversazione del rappresentante (agente).
- Traccia il lato sconosciuto della conversazione.
Note sui verbali conversazionali:
- Le trasformazioni non sono supportate per i campi verbatim conversazionali.
- Lo stesso verbale non può essere utilizzato per diversi tipi di dati conversazionali. Se si desidera che il progetto ospiti diversi tipi di conversazione, utilizzare coppie separate di verbatim conversazionali per tipo di conversazione.
clientVerbatim (per dati di conversione)
Sì Traccia il lato della conversazione del cliente nelle interazioni di chiamata e chat. Per impostazione predefinita, questo campo è mappato a:
- clientVerbatimChat per interazioni digitali
- clientVerbatimCall per interazioni chiamata
È possibile mapparlo in un campo testuale diverso, se necessario.
agentVerbatim (per dati conversazionali)
Sì Traccia il lato del rappresentante della conversazione nelle interazioni di chiamata e chat. Per impostazione predefinita, questo campo è mappato a:
- agentVerbatimChat per interazioni digitali
- agentVerbatimCall per interazioni chiamata
È possibile mapparlo in un campo testuale diverso, se necessario.
sconosciuto (per dati conversazionali)
Sì Traccia il lato sconosciuto della conversazione nelle interazioni di chiamata e chat. Per impostazione predefinita, questo campo è mappato a:
- Unknown nVerbatimChat per interazioni digitali
- Chiamata per interazioni chiamata
È possibile mapparlo in un campo testuale diverso, se necessario.
document_date Sì Data documento è il campo data principale associato a un documento. Questa data viene utilizzata in XM Discover per report, tendenze, avvisi e così via. Per Data documento, selezionare una delle seguenti opzioni:
- conversationTimestamp (per i dati conversazionali): data e ora dell’intera conversazione.
- Se i dati sorgente contengono altri campi data, è possibile impostarne uno come Data documento selezionandolo dal menu a discesa nella colonna Nome campo.
- È anche possibile impostare una data specifica aggiungendo un campo personalizzato. Per i dettagli, consultare Impostazione di una data documento specifica.
natural_id Sì L’ID naturale funge da identificatore univoco di un documento e consente l’elaborazione corretta dei duplicati. Per l’ ID naturale, selezionare una delle seguenti opzioni:
- conversationId (per dati conversazionali): ID univoco per l’intera conversazione.
- Selezionare qualsiasi campo di testo o numerico dai propri dati nella colonna Nome campo.
- Genera automaticamente gli ID aggiungendo un campo personalizzato. Per i dettagli, consultare Generazione automatica di ID naturali.
feedback_provider No Il fornitore di feedback consente di identificare i dati ottenuti da un provider specifico. Per i caricamenti del link XM Discover, il valore di questo attributo è impostato su “Link XM Discover”.
nome_job Sì Nome job consente di identificare i dati in base al nome del job utilizzato per caricarlo. È possibile modificare il valore di questo attributo nella casella Nome processo nella parte superiore della pagina.
data di caricamento No La data di caricamento indica quando un documento è stato caricato in XM Discover. Questo campo viene impostato automaticamente.
- Nella sezione Mappatura origine, configurare il resto dei campi dati.
Consiglio Q: questa sezione contiene mappature per i campi di origine forniti tramite il file di esempio. Se non è stato fornito un file di esempio, sarà necessario creare le mappature manualmente. Per ulteriori informazioni sul mappaggio dati, consultare Configurazione del mappaggio dati.
- Fare clic su Successivo.
Passo 6: Sostituzione e Redazione dei Dati (Facoltativo)
- Nella pagina Data Substitution and Redaction, è possibile fornire regole di sostituzione e oscuramento per nascondere i dati sensibili o sostituire automaticamente determinate parole e frasi nel feedback e nelle interazioni dei clienti.
Suggerimento Q: per ulteriori informazioni sulla sostituzione e l’oscuramento dei dati, consultare Sostituzione e oscuramento dei dati.
- Fare clic su Successivo.
Fase 7: specificare il filtro (facoltativo)
- Nella pagina Specifica filtro, è possibile definire una condizione di filtro per il processo per caricare solo i dati che corrispondono al filtro.
Consiglio Q: per ulteriori informazioni sul filtro dei dati in entrata, consultare Filtro connettore.
- Fare clic su Successivo.
Passo 8: Configura opzioni aggiuntive per il job
- Nella pagina Configura opzioni aggiuntive per job, scegli come XM Discover deve gestire i documenti duplicati selezionando una delle seguenti modalità di rilevamento duplicati nella sezione Gestione di documenti nuovi ed esistenti:
- Rifiutare duplicati per documenti esistenti e creare nuovi record per nuovi documenti.
- Aggiornare attributi strutturati per documenti esistenti e creare nuovi record per nuovi documenti.
- Aggiornare gli attributi strutturati per i documenti esistenti e non creare record per nuovi documenti.
Attenzione: ogni documento deve avere un ID naturale univoco in modo che il sistema possa gestire documenti duplicati con ID naturali identici.Consiglio Q: Per ulteriori informazioni sulle modalità di rilevamento duplicati, consultare Rilevamento duplicati.
- Fare clic su Successivo.
Passaggio 9: Conferma tutte le impostazioni del processo
- Nella pagina Conferma tutte le impostazioni processo, è possibile visualizzare un riepilogo di tutte le impostazioni di un processo e modificarle, se necessario.
- Fai clic sul pulsante Fine per creare il lavoro XM Discover Link.
- Una volta creato il job XM Discover Link, è possibile utilizzarlo per eseguire chiamate API. Per i dettagli, consultare Informazioni endpoint API.
Modalità di ottenimento delle informazioni sugli endpoint API
Dopo aver configurato un processo XM Discover Link, è necessario ottenere le informazioni sul punto finale API necessarie per iniziare a caricare i dati utilizzando quel processo.
- Accedere ai connettori.
- Assicurarsi che la scheda JOBS sia aperta.
- Trova il lavoro XM Discover Link appropriato utilizzando i filtri o la ricerca.
- Espandere il menu Azioni accanto al processo e selezionare Riepilogo.
- Nell’angolo in alto a destra della finestra Dettagli job: nome job, fare clic sul collegamento Documentazione API per aprire la Documentazione API job La tabella sottostante fornisce i dettagli delle informazioni del punto finale API necessarie per avviare il caricamento dei dati utilizzando un job XM Discover Link:
Informazione | Descrizione |
URL API | L’URL del punto finale:
https://na-data.clarabridge.net/v1/cb_link?jobId={jobID}&apiKey={apiKey} where:
Consiglio Q: per ulteriori informazioni sui token API, consultare Token API.
|
Metodo | Utilizzare il metodo POST per caricare i dati. |
ID job | L’ID dell’attuale lavoro XM Discover Link. |
Corpo della richiesta | Un modello di documento JSON per i dati in entrata.
Consiglio Q: ogni richiesta API può contenere un solo documento.
|
Risposta | Un elenco di possibili risposte. |
Schema | Un modello di schema.
Consiglio Q: i campi obbligatori sono elencati nella matrice richiesta.
|