Evento JSON
Suite
Customer Experience
Employee Experience
Strategy & Research
Prodotto
Qualtrics
Cosa puoi trovare in questa pagina
Consiglio Q: gli Eventi JSON sono disponibili solo per gli utenti che hanno acquistato l’accessibilità alle API di Qualtrics. Se siete interessati a questa funzione, rivolgetevi al vostro Account Executive o all’Account Services.
Informazioni sull’evento JSON
Avete mai voluto che una richiesta fatta sul vostro sito web facesse scattare un ticket in Qualtrics? Avete mai desiderato creare un’integrazione perfetta tra Qualtrics e il vostro sistema interno? Vi è mai capitato di voler triggerare un’attività nella scheda Flussi di lavoro, ma con un evento che si verifica al di fuori di Qualtrics?
Gli eventi JSON consentono a software esterni di avviare flussi di lavoro tramite richiesta HTTP. Invece di aspettare che un evento in Qualtrics attivi ulteriori azioni nella piattaforma, è possibile configurare semplicemente un evento JSON per ricevere richieste da terze parti.
Consiglio Q: è necessario generare un token API prima che questa funzione sia disponibile. Se si dispone già di un token API, non è necessario generarne uno nuovo.
Attenzione: L’impostazione di un evento JSON richiede conoscenze avanzate di programmazione. Sebbene il nostro team di assistenza sia lieto di aiutarvi con le basi dell’inserimento delle informazioni nell’evento, non possiamo fornire assistenza sugli aspetti di programmazione. Puoi invece provare a domandare alla nostra community di utenti esperti.
Limitazioni
L’evento JSON non è compatibile con le seguenti impostazioni e configurazioni:
- Tutto ciò che non è HTTP (ad esempio, coda di messaggi, SMS).
- Chiamate HTTP in uscita.
- Elaborare XML (il corpo della richiesta XML sarà ignorato).
- Elaborare qualsiasi cosa che non sia JSON.
- Autenticarsi in qualsiasi altro modo che non sia un’intestazione X-API-TOKEN o il nostro HTTP basic auth modificato. Consiglio Q: OAuth e altre forme di autenticatori sono incompatibili con gli eventi JSON.
- Qualsiasi parsing JSON che non può essere soddisfatto utilizzando le query JSONPath sul corpo JSON.
- Chiamate che superano il limite della tariffa API di 3.000 al minuto.
- Carichi utili superiori a 100 KB.
- 10 campi di immissione manuale. Consiglio Q: una volta che le informazioni sono state acquisite con la cattura degli eventi, saranno aggiunte al corpo JSON. L’acquisizione degli eventi è l’unico modo per aggiungere più di 10 campi.
Tipi di autorizzazione supportati
Autenticazione basata su token / Autenticazione tramite intestazione
È possibile autenticarsi passando il proprio token API nell’intestazione della richiesta come X-API-TOKEN.
Esempio: Nel seguente esempio di POST, in cURL si specificano l’URL di base, il Content-Type e il Token nell’intestazione. L’ID del sondaggio e il formato dell’esportazione sono specificati nel corpo
.curl -X POST -H 'X-API-TOKEN: yourapitokenhere' -H 'Content-Type: application/json' -d '{
”
surveyId": "SV_012345678912345",
"format": "csv"
}' 'https://yourdatacenterid.qualtrics.com/API/v3/responseexports'
Autenticazione di base HTTP
Basic Auth è solitamente una versione codificata Base64 di nome utente:password. Tuttavia, per una maggiore sicurezza, Qualtrics utilizza una stringa codificata Base64 di username:x-api-token.
Per utilizzare Basic Auth, è necessario impostare le intestazioni sulla richiesta HTTP. L’intestazione specifica è AUTORITÀ.
Esempio: Supponiamo che il vostro nome utente di Qualtrics sia demo@qualtrics.com e che il vostro TOKEN API sia f8gIK7G6GFH985Y4. Per prima cosa scrivete,
demo@qualtrics.com:f8gIK7G6GFH985Y4Dopo la codifica Base64, questo apparirà come,
Base ZGVtb0BxdWFsdHJpY3MuY29tOmY4Z0lLN0c2R0ZIOTg1WTQ=Quindi l’intestazione Autorizzazione aggiunta alla richiesta HTTP avrà il valore Basic ZGVtb0BxdWFsdHJpY3MuY29tOmY4Z0lLN0c2R0ZIOT1WTQ=.
Consiglio Q: dare un’occhiata a questi strumenti per la codifica di base64 e la decodifica di base64.
Impostazione di un evento JSON
Per prima cosa, è necessario creare un flusso di lavoro. Andate alla pagina Flussi di lavoro autonomi.
Consiglio Q: è possibile utilizzare eventi JSON anche nel metodo Flusso di lavoro in un progetto o nella Directory XM. Si consiglia di aggiungere un flusso di lavoro a un progetto specifico solo se sono esplicitamente correlati (ad esempio, se si distribuisce il progetto con l’evento JSON). L’evento JSON può essere utilizzato in tutte le aree di lavoro, ad eccezione dei progetti da dati importati.
Assicuratevi di essere nella scheda Flussi di lavoro .
Fare clic su Crea un flusso di lavoro.
Selezionare Avviato alla ricezione di un evento.
Selezionare l’evento JSON .
Se lo si desidera, specificare un sommario del Trigger, che dovrebbe descrivere lo scopo dell’evento JSON.
Verrà fornito un URL. Utilizzate questa opzione per richiamare il vostro nuovo flusso di lavoro dall’esterno di Qualtrics, utilizzando Postman, il vostro sistema interno o altre applicazioni simili. Per copiarlo, fare clic su Copia URL.
Per impostazione predefinita, gli eventi JSON richiedono l’autenticatore. Se si desidera consentire richieste non autenticate, è possibile disabilitare la richiesta di autenticazione da parte di QUALTRICS.
Ora è possibile definire i dati dell’evento. In questo modo si acquisiscono i dati della richiesta in entrata. Per iniziare, fare clic su Impostazioni avanzate.
Consiglio Q: per informazioni sulla sezione Test, vedere Acquisizione di eventi di seguito.
Nella casella a sinistra, indicare il nome del campo JSON. Nella casella a destra, indicare la posizione all’interno dei dati dell’evento (corpo della richiesta HTTP).
Consiglio Q: le posizioni devono essere in formato JSONPath! Vedere la tabella seguente per una guida rapida alla sintassi di JSONPath.
Per aggiungere un altro campo, fare clic su Aggiungi un campo JSON.
Se si desidera aggiungere un parametro QUERY, aggiungerlo nella sezione Parametri QUERY . Per ulteriori informazioni su cosa sono questi parametri e come funzionano nelle API, consultare la nostra Documentazione API sui parametri.
Attenzione: Non è consigliabile passare dati di identificazione personale attraverso parametri QUERY. Tutte le informazioni personali o i dati sensibili devono essere passati attraverso il corpo POST quando possibile, in quanto il POST è più sicuro.
Per rimuovere un campo, fare clic sul segno meno ( – ).
Per salvare le modifiche, fare clic su Salva.
Ora è possibile aggiungere condizioni e un’attività al flusso di lavoro facendo clic sul segno più ( + ). Le condizioni determinano l’esecuzione di un flusso di lavoro, mentre le attività sono il risultato del flusso di lavoro. Vedere il Creazione di flussi di lavoro per ulteriori informazioni.
Consiglio Q: fare clic sull’evento JSON per modificare i parametri e i campi JSON.
Attenzione: Un evento JSON può essere lanciato via API solo dallo stesso account che ha creato l’evento. Se si utilizza un account diverso per lanciare l’API per un evento JSON, è possibile che si riceva una risposta API 202-success, tuttavia ciò significa che è stato utilizzato un token API valido per effettuare una richiesta valida, ma non significa necessariamente che sia stato utilizzato il token API corretto o che l’evento JSON sia stato attivato correttamente. Se si riceve un messaggio API 202-success, è necessario controllare la piattaforma per verificare che sia stata utilizzata l’API corretta.
Cattura degli eventi
Quando si crea un evento API esterno, potrebbe essere necessario analizzare i dati dal corpo del post. Tuttavia, a volte può essere difficile analizzare questi dati. Se si vuole capire cosa sta inviando l’API esterna, seguire questi passaggi.
Fare clic sull’evento JSON.
Per impostazione predefinita, l’opzione Cattura campi JSON dai risultati del test in modo che possano essere utilizzati come testo trasferito in altre attività di questo flusso di lavoro sarà attivata. Questa opzione fa sì che i campi analizzati nel corpo del payload siano automaticamente disponibili come testo trasferito quando si aggiungono le attività del flusso di lavoro.
Fare clic su Esegui un nuovo test.
Verrà visualizzato un messaggio che indica che Qualtrics è in attesa di ricevere l’evento dal sistema esterno. Attivare l’API esterna.
Consiglio Q: per annullare il test, fare clic su Annulla test.
Se il test è riuscito, verrà visualizzato il messaggio Connessione riuscita al server. Il carico utile verrà analizzato e aggiunto alla finestra.
Se si desidera, fare clic su Esegui un nuovo test per eseguire un altro test. Dopo aver cliccato su questa opzione, è necessario eseguire la chiamata API avanti.
Fare clic su Salva.
Sintassi di JSONPath
La tabella seguente fornisce alcune delle basi della sintassi di JSONPath. Si noti che questi non sono stabiliti da Qualtrics, ma sono standard utilizzati con JSON.
Attenzione: L’impostazione di un evento JSON richiede conoscenze avanzate di programmazione. Sebbene il nostro team di assistenza sia lieto di aiutarvi con le basi dell’inserimento delle informazioni nell’evento, non possiamo fornire assistenza sugli aspetti di programmazione. Potete sempre provare a chiedere alla nostra comunità di utenti dedicati.
| Percorso JSON | Descrizione | Esempio |
|---|---|---|
| $ | L’oggetto/elemento principale | $.negozi[0].nome |
| @ | L’oggetto/elemento corrente | $.stores[?(@.name==”ACME Store”)] |
| . | Operatore bambino | $.eventDescription |
| .. | Operatore discendente ricorsivo | $.negozi[0]..prezzo |
| * | Jolly | $.negozi[*].nome |
| [] | Operatore di pedice | $.negozi[0].nome |
| [,] | Operatore dell’Unione | $.negozi[0,1] |
| [inizio:fine:passo] | Operatore di taglio della matrice | $.stores[0:10:2] |
| ?() | APPLICA un filtro | $.stores[?(@.name==”ACME Store”)] |
| () | Espressione di script | $.stores[(@.length-1)] |
Esempio di sintassi JSONPath
In questo esempio mostreremo come, dato un oggetto JSON, si possa utilizzare la tabella JSONPath.
Questo è il nostro oggetto JSON:
{
"eventDescription": "Entrate mensili",
"negozi": [
{
"nome": "Acme Store",
"total": 1000000,
"topItem":
{ "price": "50", "descrizione": "Incudine" }
},
{
"nome": "Il chiosco delle banane",
"totale": 250000,
"topItem":
{ "prezzo": "4", "descrizione": "Il Gob" }
},
{
"name": "Pizza Planet",
"totale": 80000,
"topItem":
{ "prezzo": "15", "descrizione": "Pepperoni" }
}
]
}
Ora dovremmo aggiungere i valori di ritorno che vediamo nella tabella JSONPath per rendere il tutto più chiaro.
$ -> Acme Store
@ -> [
{
"nome": "Acme Store",
"total": 1000000,
"topItem":
{ "price": "50", "descrizione": "Incudine" }
}
]
. -> Entrate mensili
... -50
-> ["Acme Store", "The Banana Stand", "Pizza Planet"]
[] -> Acme Store
[,] -> [
Macro sconosciuta: {"nome"}
,
Macro sconosciuta: {"nome"}
]
**Cambia l'Esempio di [inizio:fine:passo] con "$.negozi[1:3:1]"
[start:end:step] -> [
{
"nome": "Il chiosco delle banane",
"total": 250000,
"topItem":
{ "price": "4", "descrizione": "Il Gob" }
},
{
"name": "Pizza Planet",
"totale": 80000,
"topItem":
{ "prezzo": "15", "descrizione": "Pepperoni" }
}
]
?() -> [{
"nome": "Acme Store",
"total": 1000000,
"topItem":
{ "price": "50", "descrizione": "Incudine" }
}]
() -> [
{
"nome": "Pizza Planet",
"totale": 80000,
"topItem":
{ "prezzo": "15", "descrizione": "Pepperoni" }
}
] Esempio di API in Node Javascript
L’esempio che segue è un modello di base da seguire per la formattazione dei dati degli eventi.
Attenzione: L’impostazione di un evento JSON richiede conoscenze avanzate di programmazione. Sebbene il nostro team di assistenza sia lieto di aiutarvi con le basi dell’inserimento delle informazioni nell’evento, non possiamo fornire assistenza sugli aspetti di programmazione. Potete sempre provare a chiedere alla nostra comunità di utenti dedicati.
var request = require('request-promise');
var surveyId = "SV_XXXXXXXXXX";
var triggerId = "OC_XXXXXXXXX";
var brandId = "YOUR_BRAND_ID";
var userId = "UR_XXXXXXXXXXXXX";
var datacenter = "xx1";
var apiToken = "YOUR_QUALTRICS_API_TOKEN";
var url = "https://" + datacenter + ".qualtrics.com/inbound-event/v1/event/JSON/trigger" +
"?contextId=" + surveyId + "&userId=" + userId + "&brandId=" + brandId + "&triggerId=" + triggerId;
var payload = {
"text": "Questo è un testo",
"object": {
"number": 4
},
"array": ["a", "b", "c", "d"]
};
var options = {
url: url,
json: true,
body: payload,
headers: {
"Content-Type": "application/json", // OBBLIGATORIO!!!
"X-API-TOKEN": token API
}
};
request.post(options).then(function (ret) {
console.log("success:", url, payload);
}).catch(function (err) {
console.log("error: ", url);
console.log(err);
}); Esempio: Integrazione con Freshdesk
Consiglio Q: questa attività è separata da quella di Freshdesk.
L’evento JSON può essere utilizzato per l’integrazione con Freshdesk come regola Webhook in Dispatch’r. Ciò significa che gli eventi in Freshdesk possono attivare attività in Qualtrics, come la creazione di un ticket o la distribuzione di un sondaggio.
Consiglio Q: il Supporto Qualtrics può aiutarvi a configurare il vostro Evento JSON e a collegarlo tramite Freshdesk. Tuttavia, potrebbero esserci alcune domande sulle funzionalità di Freshdesk a cui non possono rispondere. Se avete domande sull’AFFIANCATO di Freshdesk, provate a consultare la documentazione sulle Regole di Dispatch.
In QUALTRICS, impostare l’evento su Evento JSON.
Copiare l’URL.
In una nuova scheda, accedere a Freshdesk.
Nella sezione Amministrazione, selezionare l’opzione più adatta al tipo di regola che si desidera impostare.
Consiglio Q: Scopri la differenza tra Dispatch’r, Supervisor e Observernella documentazione di supporto di Freshdesk.
Creare una nuova regola.
Impostare le condizioni per determinare quale evento di Freshdesk debba innescare un’attività in QUALTRICS.
Esempio: Forse quando un agente Freshdesk fa in modo che lo stato del ticket passi da qualsiasi stato a Risolto, si desidera inviare un sondaggio CSAT utilizzando QUALTRrics.
Aggiungere una nuova azione e selezionare Trigger Web Hook.
Impostare il tipo di richiesta su POST.
In URL di callback, incollare l’URL dell’evento JSON dal passaggio 2.
Per utilizzare l’autenticazione con token, aggiungere intestazioni personalizzate, inserire X-API-TOKEN: e impostarlo uguale al token API.
Per utilizzare l’autenticazione HTTP Basic, fare clic su Requires Authentication, aggiungere il nome utente di Qualtrics e, al posto della password, inserire il token API.
Assicurarsi che la codifica sia JSON.
Selezionare manualmente il contenuto da trasmettere o scegliere Avanzate per inserire un corpo JSON.
Salvate la vostra regola.
In Qualtrics, terminate il flusso di lavoro. In questo esempio, probabilmente aggiungeremo un’attivitàInvia sondaggio tramite e-mail o Invia sondaggio tramite SMS.
Non dimenticate di pubblicare le modifiche al sondaggio quando siete pronti a lanciarlo.
Consiglio Q: per ulteriori informazioni sui Webhook di Freshdesk, consultare la documentazione collegata sul sito di supporto.
Esempio: Integrazione con ServiceNow
Consiglio Q: questa attività è separata da quella di ServiceNow.
L’evento JSON può essere utilizzato per integrarsi con ServiceNow. Ciò significa che gli eventi in ServiceNow possono attivare attività in Qualtrics, come la creazione di un ticket o la distribuzione di un sondaggio.
Consiglio Q: il Supporto Qualtrics può aiutarvi a configurare il vostro Evento JSON e a collegarlo tramite ServiceNow. Tuttavia, potrebbero esserci delle domande sulle funzionalità di ServiceNow a cui non possono rispondere. Se avete domande su come accedere e attivare la vostra istanza ServiceNow per sviluppatori, provate a consultare la documentazione sulle Istanze personali per sviluppatori.
In QUALTRICS, impostare l’evento su Evento JSON.
Copiare l’URL.
In una nuova scheda, accedere alla propria istanza di ServiceNow developer.
Selezionare Messaggio REST.
Fare clic su Nuovo.
Date un nome al vostro messaggio di riposo.
Nel campo Endpoint, incollare l’URL copiato nel passaggio 2.
Cambiare il tipo di Autenticatore in Basic.
Andare alla scheda Richiesta HTTP.
Fare doppio clic per aggiungere X-API-TOKEN API.
In una nuova riga, aggiungere il nome Content-type.
Impostare il valore su application/json.
Fai clic su Invia.
Riaprire il messaggio di riposo.
In Metodi HTTP, fare clic su Nuovo.
Assegnare un nome al metodo.
Impostare il metodo HTTP su POST.
Impostare il tipo di Autenticità su Eredita dal genitore.
Fai clic su Invia.
Riaprite il metodo HTTP POST appena creato.
In fondo alla pagina, selezionare Anteprima uso script.
Copiare il testo.
Cercare e selezionare Regole di business.
Selezionare Nuovo.
Selezionare una tabella.
Selezionare Avanzate.
Determinare quando viene eseguita la regola aziendale.
Esempio: Se per la tabella è stato selezionato Incidente e si desidera inviare un sondaggio CSAT per i ticket risolti, è possibile aggiungere una condizione che indichi che la regola deve essere eseguita quando lo stato di Incidente cambia in Risolto.
Consiglio Q: il Supporto Qualtrics può aiutarvi a configurare il vostro Evento JSON e a collegarlo tramite ServiceNow. Tuttavia, potrebbero esserci delle domande sulle funzionalità di ServiceNow a cui non possono rispondere. Se avete domande su come e quando vengono eseguite le regole aziendali, consultate la documentazione di ServiceNow sul funzionamento delle regole aziendali.
Andare alla scheda Avanzate.
Incollare il contenuto copiato dal passaggio 22, dove si dice Aggiungi il tuo codice qui.
Aggiungere un corpo. Qui si comunicano le informazioni che si desidera trasmettere a Qualtrics.
Esempio: Questo è un esempio del codice finale da inserire in questo campo. La maggior parte di questo codice è il messaggio in uscita fornito da ServiceNow e varia da un esempio all’altro. Purtroppo, il Supporto Qualtrics non può aiutarvi con la codifica personalizzata; se avete problemi con il codice, rivolgetevi alla comunità di ServiceNow per ricevere assistenza.
La parte in grassetto del codice include tre funzioni aggiuntive non incluse nel codice originale: un corpo JSON che estrae l’ID utente e lo stato dell’incidente e una chiamata che recupera l’indirizzo e-mail del cliente che ha subito l’incidente, in modo da inviargli il CSAT (in corsivo). Consultate la documentazione di ServiceNow e consultate la loro comunità se avete ulteriori domande.
(function executeRule(current, previous /*null when async*/) {
// Aggiungete il vostro codice qui
try {
var r = new sn_ws.RESTMessageV2('Qualtrics JSON Event ', 'JSON Event POST')
;var body = {
"User ID": gs.getUserID()
"incident state": current.state.getDisplayValue()
}
;
var destinazione = new GlideRecord('sys_user');
destinazione.addQuery('sys_id', '=', current.caller_id);
destinazione.query();
while(destinazione.next()) {
body["email"] = destinazione.email.getDisplayValue();
}
var response = r.execute();
var responseBody = response.getBody();
var httpStatus = response.getStatusCode();
gs.addInfoMessage(httpStatus);
}
catch(ex) {
var message = ex.message;
gs.addInfoMessage("Error communicating w QUALTRrics " + message);
}
}(current, previous);
Aggiungere il corpo alla richiesta. Aggiungete quanto segue sotto la parte di codice in grassetto e in corsivo del passo precedente:
r.setRequestBody(JSON.stringify(body)); Fai clic su Invia.
In Qualtrics, terminate il flusso di lavoro. Per continuare l’esempio del sondaggio CSAT, probabilmente aggiungeremo un’attività di invio del sondaggio tramite e-mail o di invio del sondaggio tramite SMS.
Non dimenticate di pubblicare le modifiche al sondaggio quando siete pronti a lanciarlo.
Esempio: Integrazione con Microsoft Dynamics attraverso Microsoft Flow
Consiglio Q: questa attività è separata da quella di Microsoft Dynamics.
L’Evento JSON consente agli eventi di Microsoft Dynamics di attivare attività in Qualtrics, come la creazione di un ticket o la distribuzione di un sondaggio. Ad esempio, ogni volta che si elimina un account in Microsoft, è possibile distribuire al proprietario dell’account un sondaggio di Qualtrics che pone domande di uscita. (ad esempio, Ci dispiace vederti andare via! Com’è stato il tempo trascorso con noi? Come possiamo migliorare?)
Per integrare l’Evento JSON con le azioni che si svolgono in Microsoft Dynamics, è necessario eseguire l’impostazione all’interno di Microsoft Flow anziché in Dynamics. Non preoccupatevi: Microsoft Flow viene fornito gratuitamente con ogni account Microsoft Dynamics, quindi potete accedere a Flow con i vostri dati Dynamics qui.
Consiglio: il Supporto Qualtrics può aiutarvi a configurare il vostro Evento JSON e a collegarlo attraverso Microsoft Flow e Microsoft Dynamics. Tuttavia, potrebbero esserci alcune domande sulle funzionalità Microsoft a cui non possono rispondere. Se avete domande sul lato Microsoft, provate a consultare la documentazione per Flow e le risorse per Dynamics.
In QUALTRICS, impostare l’evento su Evento JSON.
Copiare l’URL.
In una scheda separata, accedere a https://us.flow.microsoft.com/en-us/ e utilizzare i dati di Microsoft Dynamics per accedere a Flow.
Selezionare I miei flussi a sinistra.
Fare clic su Nuovo e selezionare Automatico – da vuoto.
Dare un nome al flusso.
Selezionare un trigger. Questo è l’evento che si verifica in Microsoft e che avvia l’attività in Qualtrics. Potete scegliere quello che vi serve, ma per questo esempio sceglieremo “Quando un record viene eliminato (Dynamics 365)”
Fare clic su Crea.
Alla voce Nome organizzazione, accedere al proprio account Dynamics.
In Nome entità, scegliere il tipo di record o di file. Per il nostro esempio, useremo “Account”
Fare clic su AVANTI e selezionare Aggiungi un’azione.
Selezionare HTTP.
Cambiare il metodo in POST.
Incollare l’URL dell’evento JSON nel campo URI.
Utilizzare un token di autenticazione. In Intestazioni, inserire X-API-TOKEN e nel campo avanti incollare il token API.
Alla voce Corpo, è possibile inserire un corpo JSON. Questo aiuta a decidere quali informazioni passare da Dynamics a Qualtrics.
Consiglio Q: Utilizzate il pulsante Aggiungi contenuto dinamico per selezionare i campi del record Dynamics che desiderate trasferire a Qualtrics. Assicurarsi di seguire il formato JSON corretto, come mostrato nella schermata. Per assistenza nella risoluzione dei problemi relativi ai contenuti dinamici, rivolgersi all’assistenza Microsoft.
Al termine, fare clic su Salva.
In Qualtrics, terminate il flusso di lavoro. In questo esempio, probabilmente aggiungeremo un’attivitàInvia sondaggio tramite e-mail o Invia sondaggio tramite SMS.
Non dimenticate di pubblicare le modifiche al sondaggio quando siete pronti a lanciarlo.
Consiglio Q: Microsoft Flow è preferibile per questi passaggi perché è in grado di inviare più informazioni a Qualtrics nel corpo JSON. Se si imposta questa impostazione all’interno di Microsoft Dynamics invece che in Flow, solo i campi modificati durante l’evento Dynamics saranno inviati a Qualtrics. Ad esempio, se si sceglie di effettuare il trigger in base all’aggiornamento di un record e viene modificato solo il campo “e-mail”, i campi “nome” e “indirizzo” non verranno inviati a TRIGGER, anche se questi campi vengono richiesti specificamente nel corpo del messaggio. Flow invierà a Qualtrics tutto ciò che è stato richiesto, indipendentemente dal fatto che il campo sia stato modificato nell’evento che lo ha scatenato.
Esempio: Integrazione con Genesys PureCloud
Consiglio Q: Per impostare questa integrazione, è necessario avere accesso a Genesys Cloud Architect e a Genesys Web Service Data Actions.
Utilizzando eventi JSON, è possibile integrarsi con Genesys PureCloud per inviare ai clienti un follow-up del sondaggio dopo aver completato un’interazione telefonica o via chat.
Per l’evento del flusso di lavoro, selezionare l’evento JSON .
Fare clic su Copia URL per copiare l’endpoint dell’evento negli appunti.
Senza chiudere la finestra dell’evento JSON, aprire una nuova scheda nel browser e navigare verso Genesys.
Andare in Amministrazione.
Fare clic su Azioni.
Fare clic su Aggiungi azione.
Selezionare Azioni dati servizi web come nome dell’integrazione.
Consiglio Q: se non si ha la possibilità di selezionare le Azioni dati dei servizi Web, è necessario abilitare l’integrazione. Per ulteriori informazioni, consultare questa pagina.
Assegnare un nome all’azione.
Fare clic su Aggiungi.
Passare alla scheda Impostazione.
Andare alla scheda Contratti.
In Contratto di input, selezionare JSON.
Configurare le proprietà che vengono inviate a Qualtrics.
Esempio: Ad esempio, il codice seguente passerà l’indirizzo e-mail, il numero di telefono, il nome e il cognome.
{
"tipo": "object",
"properties": {
"emailAddress": {
"type": "string"
},
"phoneNumber": {
"type": "string"
},
"firstName": {
"type": "string"
},
"lastname": {
"tipo": "string"
}
},
"additionalProperties": true
}
Andare alla scheda Configurazione .
Cambiare il tipo di richiesta in POST.
Nel campo Modello di URL della richiesta, incollare l’URL dell’evento JSON in Qualtrics.
Fare clic su Aggiungi intestazione.
Nella casella Chiave , inserire X-API-TOKEN API.
Andare alla scheda Test.
Immettere i valori di prova per le proprietà.
Fare clic su Esegui azione.
Genesys vi dirà se l’azione è andata a buon fine. Se l’operazione non è riuscita, verrà visualizzata la risposta all’errore per aiutare l’utente a risolvere il problema.
Tornare all’Evento JSON in Qualtrics e verificare che le proprietà siano state passate a Qualtrics con successo.
Fai clic su Salva.
Fare clic sul segno più ( + ) e poi su Attività per impostare l’attività che si desidera seguire quando viene triggerato l’evento JSON. Nel nostro caso, vogliamo inviare un sondaggio ai rispondenti, quindi selezioniamo l’attivitàInvia sondaggio tramite e-mail o Invia sondaggio tramite SMS.
Consiglio Q: Quando si imposta l’attività, utilizzare il menu Testo trasferito per utilizzare i valori trasmessi da Genesys (ad esempio, e-mail del cliente, nome, ecc.).
Dopo aver impostato l’attività in Qualtrics, tornare a Genesys e fare clic su Salva e Pubblica.
Fare clic su Sì.
Andare in Amministrazione.
Fare clic su Architetto.
Selezionare Invito al sondaggio nel menu a discesa del flusso.
Fare clic su Aggiungi.
Date al vostro flusso un nome, una descrizione e una divisione.
Fare clic su Crea flusso.
Nella sezione Dati della casella degli strumenti, selezionare l’azione Chiama dati e trascinarla nella casella di riepilogo del flusso.
Date un nome alla vostra azione.
Per la categoria, selezionare Azione dati servizi web.
Per Azione dati, selezionare l’azione dati creata in precedenza.
Avanti a ciascuna proprietà, fare clic sul menu a discesa e selezionare Espressione.
Per i valori delle proprietà, inserire i dati da inviare per ciascuna proprietà. La casella compila automaticamente i campi man mano che si digita.
Consiglio Q: in questa pagina sono presenti tutte le proprietà predefinite incluse nel flusso dell’invito al sondaggio. È possibile utilizzare espressioni complesse anche in situazioni in cui le informazioni sul contatto con il cliente sono mancanti o richiedono una formattazione aggiuntiva.
Consiglio Q: le informazioni di contatto sono precedute da Sondaggio.CustomerContact.
Fare clic sulla casella più in basso del flusso.
Selezionare Casella degli strumenti, quindi Invito al sondaggio, quindi Interrompi sondaggio.
Selezionare optOut per la disposizione.
Fare clic su Pubblica. Genesys convalida il flusso e lo pubblica. Una volta fatto questo, il flusso è pronto e inizierà a inviare sondaggi ai clienti quando completano le interazioni di assistenza.
FAQs
L'evento JSON mi consente l'integrazione con _?
L'evento JSON mi consente l'integrazione con _?
Per eseguire l'integrazione tramite l'evento JSON, la terza parte deve soddisfare i seguenti requisiti:
- Può essere configurato per effettuare chiamate HTTP POST in uscita (ad es. webhook, applicazione personalizzata)
- Può eseguire l'autenticazione trasmettendo un token testata
- Imposta la testata Content-Type su “application/json” e formatta i corpi della richiesta come JSON valido (facoltativo per dati evento)
Quanti eventi al minuto posso fare al mio evento JSON (op_start) prima di essere strozzato?
Quanti eventi al minuto posso fare al mio evento JSON (op_start) prima di essere strozzato?
L’evento JSON è soggetto ai limiti API Qualtrics standard. Se si inizia a ricevere la limitazione, il server riceverà un codice di risposta HTTP di 429.
Come faccio a sapere se il flusso di lavoro dell'evento JSON non riesce?
Come faccio a sapere se il flusso di lavoro dell'evento JSON non riesce?
Se il flusso di lavoro è in attesa, la risposta di op_start sarà 202 (Accettato). Questo non garantisce che il flusso di lavoro venga effettivamente eseguito e certamente non comunica il risultato dell'esecuzione. È possibile ottenere i risultati dell'esecuzione del flusso di lavoro anche tramite Flussi di lavoro Rapporti.
Che cosa sono i flussi di lavoro? / Dove sono le azioni?
Che cosa sono i flussi di lavoro? / Dove sono le azioni?
Le azioni sono state rinominate flussi di lavoro per rappresentare meglio l'esperienza del prodotto e riflettere il modo in cui gli utenti interagiscono con il prodotto. Consultare la pagina Panoramica di base dei flussi di lavoro per ulteriori informazioni sull'utilizzo dei flussi di lavoro.
Non sono presenti modifiche alla funzionalità del flusso di lavoro come parte di questo aggiornamento.
Non sono presenti modifiche alla funzionalità del flusso di lavoro come parte di questo aggiornamento.
Molte delle pagine di questo sito sono state tradotte dall'originale in inglese mediante traduzione automatica. Sebbene in Qualtrics abbiamo profuso il massimo impegno per avere le migliori traduzioni automatiche possibili, queste non sono mai perfette. Il testo originale inglese è considerato la versione ufficiale, e qualsiasi discrepanza tra questo e le traduzioni automatiche non è legalmente vincolante.
È fantastico! Grazie per il tuo feedback!
Grazie per il tuo feedback!