Evento Twilio Segment

Informazioni sugli eventi del segmento Twilio

L’evento Segmento Twilio ti permette di integrare Qualtrics con Twilio Segment per l’invio di dati a Qualtrics sulla base degli eventi nel segmento Twilio. L’evento Segmento Twilio supporta 3 casi di utilizzo principali:

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

Configurazione di un evento segmento Twilio

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

Per configurare la connessione, avrai bisogno dei seguenti ID Qualtrics:

• Token API (se si dispone già di un token, non generarne uno nuovo)
• Il tuo ID datacenter
• Se si aggiungono o aggiornano contatti nella directory XM, l’ID della directory in cui si desidera salvare i contatti.

Connessione a segmento Twilio

1. Nella scheda Workflow, fare clic su Crea un workflow.
   
2. Selezionare Avviato quando si riceve un evento.
3. Selezionare l’evento Segmento Twilio.
   
4. In una scheda del browser separata, accedere a Twilio Segment. Non chiudere da Qualtrics.
5. Passare alla scheda Connessioni.
   
6. Fare clic su Aggiungi destinazione.
7. Cercare la connessione Qualtrics e aggiungerla al proprio 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. Immettere il Token API Qualtrics. Vedere Generazione di un token API se è necessaria assistenza nella ricerca del token.
10. Inserisci il tuo ID datacenter Qualtrics. Consultare Individuazione dell’ID 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 verranno deduplicati in base alle impostazioni della tua directory. Vedere Aggiunta o aggiornamento di contatti nella directory XM per il resto della configurazione di questa opzione.
    • Upsert transazione contatto: aggiungi dati transazione a un contatto. Se il contatto non esiste, verrà creato e a esso verranno aggiunti i dati della transazione. 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 sugli eventi dati nel segmento Twilio. Vedere Avvio di un flusso di lavoro Qualtrics per il resto della configurazione di questa opzione.
      Qtip: Puoi utilizzare tutte queste opzioni se vuoi! Sarà sufficiente creare mappaggi aggiuntivi dopo aver configurato il primo.

Aggiunta o aggiornamento di contatti nella directory XM

L’evento Segmento Twilio ti permette di aggiornare i contatti nella directory XM in base alle modifiche apportate ai tuoi dati nel segmento Twilio.

1. Seguire le istruzioni riportate in Impostazione di un evento Twilio Segment per integrare Qualtrics con Twilio Segment. Seleziona l’opzione Crea e/o aggiorna il contatto nella directory XM durante la configurazione dell’integrazione.
2. Aggiungere le condizioni di filtro desiderate. Queste condizioni determinano quando i dati vengono inviati a Qualtrics.
   
   Consiglio Q: di default, 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 si dispone di più directory, selezionare la directory a cui aggiungere i contatti. Per ulteriori informazioni, vedere Individuazione dell’ID pool. 
5. Se si desidera, adeguare i mapping dei campi evento. Per ulteriori informazioni, consulta questa pagina Twilio Support. Spesso non sarà necessario apportare modifiche ai mappaggi preconfigurati.
6. Fai clic su Salva.

Aggiunta di transazioni ai contatti

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

1. Seguire le istruzioni riportate in Impostazione di un evento Twilio Segment per integrare Qualtrics con Twilio Segment. Selezionare l’opzione Upsert contact transaction (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: di default, 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 si dispone di più directory, selezionare la directory a cui aggiungere i contatti. Per ulteriori informazioni, vedere Individuazione dell’ID pool.
5. Se lo desideri, adegua i mapping dei campi evento (ad esempio, se sono presenti campi supplementari da passare a Qualtrics). Per ulteriori informazioni, consulta questa pagina Twilio Support. Spesso non sarà necessario apportare modifiche ai mappaggi preconfigurati.
6. Fai clic su Salva.

Avvio di un flusso di lavoro Qualtrics

L’evento Segmento Twilio ti permette di iniziare un flusso di lavoro in Qualtrics basato sugli eventi dati nel segmento Twilio.

1. Seguire le istruzioni riportate in Impostazione di un evento Twilio Segment per integrare Qualtrics con Twilio Segment. Scegliere l’opzione Avvia un flusso di lavoro in Qualtrics durante la configurazione dell’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 del campo di prova.
   Consiglio Q: sarà necessaria almeno 1 condizione del filtro per generare un evento di test.
4. In Qualtrics, tornare all’evento Segmento Twilio. Fare clic su Copia URL.
5. Ritorno a Twilio Segmento. 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 da trasmettere a Qualtrics. Nella colonna di sinistra, inserire il nome del campo come si desidera che compaia in Qualtrics.
7. Nella colonna a destra, scegli la variabile evento che vuoi passare a Qualtrics facendo clic sulla casella e selezionando un campo.
8. Attivare Visualizza anteprima record test.
   Consiglio Q: non sarà possibile attivare questa opzione se non è stata precedentemente generata la mappatura di test. Scorrere fino alla sezione Aggiungi evento di prova per generare il mapping di test.
9. Evidenziare il payload dell’evento JSON e copiarlo.
10. Fai clic su Salva.
11. Tornare all’evento Segmento Twilio 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, inserire i nomi dei percorsi campo da Segmento Twilio per i campi da 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 es. vero o falso).
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 accendendo un evento da Twilio Segment. Per ulteriori informazioni, vedere Acquisizione dei dati evento.
    Consiglio Q: Controlla la sintassi JSONPath per ulteriore aiuto nell’interpretazione del tuo JSON.
20. Fai clic su Salva.
21. Non dimenticare di aggiungere un task al flusso di lavoro. Di solito si tratta di un’attività di Directory XM per distribuire un sondaggio.
    Consiglio Q: se vuoi salvare o aggiornare le informazioni di contatto, consulta Aggiunta o aggiornamento dei contatti nella directory XM.
    Esempio: Supponiamo che un cliente completi il tour di onboarding del nuovo utente, aggiornando così il proprio record nel segmento Twilio. Questa modifica ai dati può quindi attivare 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.