Evento Twilio Segment

Informazioni sugli eventi di Twilio Segment

L’evento Twilio Segment consente di integrare Qualtrics con Twilio Segment per l’invio di dati a Qualtrics sulla base degli eventi in Twilio Segment. L’evento Twilio Segment supporta 3 principali casi di utilizzo:

1. Avvio di un flusso di lavoro basato su eventi di dati in Twilio Segment.
2. Aggiornamento delle informazioni di contatto nella directory XM in base agli eventi nel segmento Twilio.
3. Aggiunta di dati di transazione a un contatto in base agli eventi in Twilio Segment.

Creazione di un evento Twilio Segment

Per utilizzare l’evento Twilio Segment, è necessario completare una configurazione sia all’interno di Twilio Segment che di Qualtrics. Devi aggiungere Qualtrics come destinazione webhook all’interno della tua istanza Twilio Segment. Questa sezione tratterà l’impostazione dell’integrazione iniziale con Twilio Segment.

Per configurare la connessione, sono necessari i seguenti ID Qualtrics:

• Token API (se si dispone già di un token, non generarne uno nuovo)
• ID datacenter
• Se aggiungi o aggiorna contatti nella directory XM, l’ID directory della directory in cui desideri salvare i tuoi contatti.

Connessione al segmento Twilio

1. Nella scheda Workflow, fare clic su Crea un workflow.
   
2. Selezionare Avviato quando si riceve un evento.
3. Selezionare l’evento Twilio Segment.
   
4. In una scheda del browser separata, accedi a Twilio Segment. Non chiudere Qualtrics.
5. Passare alla scheda Connessioni.
   
6. Fare clic su Aggiungi destinazione.
7. Cerca la connessione Qualtrics e aggiungila al tuo workspace. Fare clic su di esso per iniziare a configurare la connessione.
8. Assegnare un Nome alla connessione. Questo nome serve per scopi organizzativi specifici dell’utente.
9. Immetti il tuo Token API Qualtrics. Vedere Generazione di un token API per assistenza nella ricerca del token.
10. Inserisci l’ID del tuo Datacenter Qualtrics. Consultare Individuazione dell’ID del centro dati per assistenza nella ricerca del centro dati.
11. Assicurarsi che l’opzione Abilita destinazione sia attivata.
12. Fare clic su Salva modifiche.
13. Nella scheda Mappature, fare clic su Nuova mappatura.
14. Scegli cosa vuoi fare:
    
    • Crea e/o aggiorna il contatto nella directory XM: aggiungi o aggiorna un contatto nella directory XM in base agli eventi dati nel segmento Twilio. Tutti i contatti elaborati da questo evento saranno deduplicati in base alle impostazioni della tua directory. Vedere Aggiunta o aggiornamento di contatti nella directory XM per il resto della configurazione per questa opzione.
    • Transazione di contatto upsert: aggiungere i dati della transazione a un contatto. Se il contatto non esiste, verrà creato e i dati della transazione verranno aggiunti a tale contatto. Vedere Aggiunta di transazioni ai contatti per il resto della configurazione di questa opzione.
    • Avvia un flusso di lavoro in Qualtrics: inizia un flusso di lavoro Qualtrics basato su eventi dati nel segmento Twilio. Vedere Avvio di un flusso di lavoro Qualtrics per il resto della configurazione di questa opzione.
      Qtip: È possibile utilizzare tutte queste opzioni se si desidera! Sarà sufficiente creare ulteriori mappaggi dopo aver configurato il primo.

Aggiunta o aggiornamento di contatti nella directory XM

L’evento Twilio Segment consente di aggiornare i contatti nella directory XM in base alle modifiche apportate ai dati in Twilio Segment.

1. Segui le istruzioni contenute in Configurazione di un evento Twilio Segment per integrare Qualtrics con Twilio Segment. Scegli l’opzione Crea e/o aggiorna il contatto nella directory XM quando configura l’integrazione.
2. Aggiungere le condizioni di filtro desiderate. Queste condizioni determinano quando i dati vengono inviati a Qualtrics.
   
   Consiglio Q: per impostazione predefinita, questa integrazione include automaticamente una condizione per “Tipo di evento” è “Identifica”. È possibile modificare questo filtro o aggiungerne di nuovi in base alle esigenze. Ti consigliamo di includere almeno 1 filtro per limitare i dati inviati a Qualtrics.
3. Se lo si desidera, utilizzare la sezione Aggiungi evento di prova per verificare quali campi possono essere inclusi nei mapping.
4. Nella sezione Seleziona mappature, mappa il tuo ID Directory Qualtrics. Se disponi di più directory, scegli quella a cui vuoi aggiungere contatti. Per ulteriori informazioni, consultare Locating the PoolID. 
5. Se lo si desidera, adeguare i mapping dei campi dell’evento. Per ulteriori informazioni, consulta questa pagina di supporto Twilio. Spesso non sarà necessario apportare modifiche ai mappaggi preconfigurati.
6. Fai clic su Salva.

Aggiunta di transazioni ai contatti

L’evento Twilio Segment consente di aggiungere dati di transazione ai contatti esistenti nella directory XM. Se il contatto non esiste ancora nella tua directory, verrà creato. I dati di transazione verranno salvati nel contatto appena creato.

1. Segui le istruzioni contenute in Configurazione di un evento Twilio Segment per integrare Qualtrics con Twilio Segment. Selezionare l’opzione di transazione Contatto Upsert durante la configurazione dell’integrazione.
2. Aggiungere le condizioni di filtro desiderate. Queste condizioni determinano quando i dati vengono inviati a Qualtrics.
   Consiglio Q: per impostazione predefinita, questa integrazione include automaticamente una condizione per “Tipo di evento” è “Traccia” e “Nome evento” è “Transazione creata”. È possibile modificare questo filtro o aggiungerne di nuovi in base alle esigenze. Ti consigliamo di includere almeno 1 filtro per limitare i dati inviati a Qualtrics.
3. Se lo si desidera, utilizzare la sezione Aggiungi evento di prova per verificare quali campi possono essere inclusi nei mapping.
4. Nella sezione Seleziona mappature, mappa il tuo ID Directory Qualtrics. Se disponi di più directory, scegli quella a cui vuoi aggiungere contatti. Per ulteriori informazioni, consultare Locating the PoolID.
5. Se lo desideri, regola le mappature dei campi dell’evento (ad esempio, se ci sono campi in più che vuoi trasferire a Qualtrics). Per ulteriori informazioni, consulta questa pagina di supporto Twilio. Spesso non sarà necessario apportare modifiche ai mappaggi preconfigurati.
6. Fai clic su Salva.

Avvio di un flusso di lavoro Qualtrics

L’evento Twilio Segment ti consente di avviare un flusso di lavoro in Qualtrics basato sui dati in Twilio Segment.

1. Segui le istruzioni contenute in Configurazione di un evento Twilio Segment per integrare Qualtrics con Twilio Segment. Scegli l’opzione Avvia un flusso di lavoro in Qualtrics quando configura l’integrazione.
2. Aggiungere le condizioni di filtro desiderate. Queste condizioni determinano quando i dati vengono inviati a Qualtrics.
   
   Consiglio Q: ti consigliamo di includere almeno 1 filtro per limitare i dati inviati a Qualtrics.
3. Utilizzare la sezione Aggiungi evento di prova per generare un mapping dei campi di prova.
   Consiglio Q: Avrai bisogno di almeno 1 condizione di filtro per generare un evento di prova.
4. In Qualtrics, torna all’evento Twilio Segment. Fare clic su Copia URL.
5. Torna a Twilio Segment. Nella sezione Seleziona mappature, incollare l’URL copiato nel campo API HTTP per mapparlo all’URL del workflow.
6. Se lo desideri, regola le mappature per i campi che desideri trasferire a Qualtrics. Nella colonna di sinistra, inserisci il nome del campo così come vuoi che appaia in Qualtrics.
7. Nella colonna di destra, scegli la variabile evento che desideri trasmettere a Qualtrics facendo clic sulla casella e selezionando un campo.
8. Abilita Mostra anteprima record di prova.
   Consiglio Q: Non sarà possibile abilitare questa opzione se non è stata generata in precedenza la mappatura di test. Scorrere fino alla sezione Aggiungi evento di prova per generare il mapping di prova.
9. Evidenziare il payload dell’evento JSON e copiarlo.
10. Fai clic su Salva.
11. Torna all’evento Twilio Segment in Qualtrics. Navigare alla sezione Impostazioni avanzate.
12. Incollare il payload dell’evento JSON copiato in precedenza nel campo dell’oggetto JSON.
13. Fare clic su Aggiungi mapping dei campi. I campi verranno mappati automaticamente in base al payload JSON.
14. Navigare alla sezione Mappa campi e verificare che i campi siano mappati correttamente. È possibile adattare i campi in base alle esigenze.
15. Per il Percorso, inserisci nel campo i nomi dei percorsi da Twilio Segment per i campi che vuoi salvare in Qualtrics.
16. Per il Tipo, selezionare il tipo di dati che il campo contiene:
    • Stringa: i dati sono una stringa di testo.
    • Numero: i dati sono un valore numerico.
    • Booleano: i dati sono un valore booleano (ad esempio, true o false).
17. Fare clic su Aggiungi un campo per mappare campi supplementari.
18. Fare clic sul segno meno ( – ) per rimuovere un campo dalla mappatura.
19. Se lo desideri, puoi testare l’integrazione per verificare se i dati corretti vengono passati a Qualtrics facendo clic sui dati Esegui test e quindi attivando un evento da Twilio Segment. Per ulteriori informazioni, vedere Acquisizione dei dati dell’evento.
    Qtip: Controlla la sintassi di JSONPath per maggiori informazioni sull’interpretazione del tuo JSON.
20. Fai clic su Salva.
21. Non dimenticare di aggiungere un task al tuo flusso di lavoro. Di solito si tratta di un‘attività della Directory XM per distribuire un sondaggio.
    Consiglio Q: Se desideri salvare o aggiornare le informazioni di contatto, consulta Aggiunta o aggiornamento di contatti nella directory XM.
    Esempio: supponiamo che un cliente completi il tour di onboarding del nuovo utente, che aggiorna il proprio record in Twilio Segment. Questa modifica ai dati può quindi avviare un flusso di lavoro Qualtrics, che possiamo utilizzare per distribuire un sondaggio al cliente chiedendo loro di fornire un feedback sulla loro esperienza di onboarding.