Événement Twilio Segment

À propos des événements du segment Twilio

L’événement Twilio Segment vous permet d’intégrer Qualtrics à Twilio Segment pour l’envoi de données à Qualtrics en fonction des événements de Twilio Segment. L’événement Segment Twilio prend en charge trois cas d’utilisation principaux :

1. Lancement d’un workflow basé sur des événements de données dans Twilio Segment.
2. Mise à jour des informations de contact dans le répertoire XM en fonction des événements dans Twilio Segment.
3. Ajout de données de transaction à un contact en fonction des événements dans Twilio Segment.

Configuration d’un événement de segment Twilio

Pour utiliser l’événement Segment Twilio, vous devez effectuer une configuration dans Twilio Segment et Qualtrics. Vous devez ajouter Qualtrics comme destination Webhook dans votre instance de segment Twilio. Cette section traite de la configuration de l’intégration initiale avec Twilio Segment.

Pour configurer la connexion, vous aurez besoin des ID Qualtrics suivants :

• Votre jeton API (si vous en avez déjà un, ne générez pas un nouveau jeton)
• Votre ID de centre de données
• Si vous ajoutez ou mettez à jour des contacts dans le répertoire XM, l’ID de répertoire du répertoire dans lequel vous souhaitez que vos contacts soient enregistrés.

Connexion à Twilio Segment

1. Dans l’onglet Workflows, cliquez sur Créer un workflow.
   
2. Sélectionnez Lancé lorsqu’un événement est reçu.
3. Sélectionnez l’événement Segment Twilio.
   
4. Dans un onglet de navigateur distinct, connectez-vous à Twilio Segment. Ne fermez pas Qualtrics.
5. Accédez à l’onglet Connexions.
   
6. Cliquez sur Ajouter une destination.
7. Recherchez la connexion Qualtrics et ajoutez-la à votre espace de travail. Cliquez dessus pour commencer à configurer la connexion.
8. Donnez un Nom à la connexion. Ce nom répond à vos besoins organisationnels.
9. Saisissez votre jeton d’API Qualtrics. Voir Génération d’un jeton API si vous avez besoin d‘aide pour trouver votre jeton.
10. Saisissez votre ID de centre de données Qualtrics. Voir Localisation de l’ID du centre de données si vous avez besoin d‘aide pour trouver votre centre de données.
11. Assurez-vous que l’option Activer la destination est activée.
12. Cliquez sur Sauvegarder les modifications.
13. Dans l’onglet Mappages, cliquez sur Nouveau mappage.
14. Choisissez ce que vous souhaitez faire :
    
    • Créer et/ou mettre à jour un contact dans le répertoire XM : ajouter ou mettre à jour un contact dans le répertoire XM en fonction des événements de données dans le segment Twilio. Tous les contacts traités par cet événement seront dédupliqués selon les options de votre répertoire. Voir Ajout ou mise à jour de contacts dans le répertoire XM pour le reste de la configuration de cette option.
    • Opération Upsert de contact : ajouter des données de transaction à un contact. Si le contact n’existe pas, le contact est créé et les données de transaction sont ajoutées à ce contact. Voir Ajout de transactions aux contacts pour le reste de la configuration de cette option.
    • Démarrer un workflow dans Qualtrics : commencez un workflow Qualtrics basé sur des événements de données dans Twilio Segment. Voir Déclenchement d’un workflow Qualtrics pour le reste de la configuration de cette option.
      Astuce Qualtrics : vous pouvez utiliser toutes ces options si vous le souhaitez ! Il vous suffira de créer des mappages supplémentaires après avoir configuré le premier.

Ajout ou mise à jour de contacts dans le répertoire XM

L’événement Segment Twilio vous permet de mettre à jour les contacts dans le répertoire XM en fonction des modifications apportées à vos données dans Twilio Segment.

1. Suivez les instructions de la section Configurer un événement de segment Twilio pour intégrer Qualtrics à Twilio Segment. Sélectionnez l’option Créer et/ou mettre à jour un contact dans le répertoire XM lors de la configuration de l’intégration.
2. Ajoutez les conditions de filtre de votre choix. Ces conditions déterminent le moment où les données sont envoyées à Qualtrics.
   
   Astuce Qualtrics : par défaut, cette intégration inclut automatiquement une condition pour « Type d’événement » : « Identifier ». Vous pouvez modifier ce filtre ou en ajouter de nouveaux si nécessaire. Nous vous recommandons d’inclure au moins un filtre pour limiter les données envoyées à Qualtrics.
3. Si vous le souhaitez, utilisez la section Ajouter un événement de test pour tester quels champs peuvent être inclus dans vos mappages.
4. Dans la section Sélectionner les mappages, mappez votre ID de répertoire Qualtrics. Si vous avez plusieurs répertoires, sélectionnez le répertoire auquel vous souhaitez ajouter des contacts. Pour plus d’informations, voir Localiser l’ID du pool. 
5. Si vous le souhaitez, ajustez les mappages des champs d’événement. Consultez cette page d’assistance Twilio pour en savoir plus. Souvent, vous n’avez pas besoin d’ajuster les mappages préconfigurés.
6. Cliquez sur Enregistrer.

Ajout de transactions aux contacts

L’événement Segment Twilio vous permet d’ajouter des données de transaction aux contacts existants dans votre répertoire XM. Si le contact n’existe pas encore dans votre répertoire, il sera créé. Les données de transaction sont sauvegardées dans le contact nouvellement créé.

1. Suivez les instructions de l’événement Configurer un segment Twilio pour intégrer Qualtrics à Twilio Segment. Sélectionnez l’option de transaction Upsert de contact lors de la configuration de l’intégration.
2. Ajoutez les conditions de filtre de votre choix. Ces conditions déterminent le moment où les données sont envoyées à Qualtrics.
   Astuce Qualtrics : par défaut, cette intégration inclut automatiquement une condition pour « Type d’événement » est « Suivre » et « Nom de l’événement » est « Transaction créée ». Vous pouvez modifier ce filtre ou en ajouter de nouveaux si nécessaire. Nous vous recommandons d’inclure au moins un filtre pour limiter les données envoyées à Qualtrics.
3. Si vous le souhaitez, utilisez la section Ajouter un événement de test pour tester quels champs peuvent être inclus dans vos mappages.
4. Dans la section Sélectionner les mappages, mappez votre ID de répertoire Qualtrics. Si vous avez plusieurs répertoires, sélectionnez le répertoire auquel vous souhaitez ajouter des contacts. Pour plus d’informations, voir Localiser l’ID du pool.
5. Si vous le souhaitez, ajustez les mappages des champs d’événement (par exemple, s’il existe des champs supplémentaires à transmettre à Qualtrics). Consultez cette page d’assistance Twilio pour en savoir plus. Souvent, vous n’avez pas besoin d’ajuster les mappages préconfigurés.
6. Cliquez sur Enregistrer.

Déclenchement d’un workflow Qualtrics

L’événement Twilio Segment vous permet de commencer un workflow dans Qualtrics en fonction des événements de données de Twilio Segment.

1. Suivez les instructions de la section Configurer un événement de segment Twilio pour intégrer Qualtrics à Twilio Segment. Sélectionnez l’option Lancer un workflow dans Qualtrics lors de la configuration de l’intégration.
2. Ajoutez les conditions de filtre de votre choix. Ces conditions déterminent le moment où les données sont envoyées à Qualtrics.
   
   Astuce Qualtrics : nous vous recommandons d’inclure au moins un filtre pour limiter les données envoyées à Qualtrics.
3. Utilisez la section Ajouter un événement de test pour générer un mappage de champ de test.
   Astuce Qualtrics : vous aurez besoin d’au moins une condition de filtrage pour générer un événement de test.
4. Dans Qualtrics, revenez à l’événement Twilio Segment. Cliquez sur Copier URL.
5. Revenez à Twilio Segment. Dans la section Sélectionner les mappages, collez l’URL copiée dans le champ API HTTP pour la mapper à votre URL de workflow.
6. Si vous le souhaitez, ajustez les mappages pour les champs que vous souhaitez transmettre à Qualtrics. Dans la colonne de gauche, saisissez le nom du champ tel que vous souhaitez qu’il apparaisse dans Qualtrics.
7. Dans la colonne de droite, sélectionnez la variable d’événement que vous souhaitez transmettre à Qualtrics en cliquant sur la case et en sélectionnant un champ.
8. Activez Afficher l’aperçu de l’enregistrement de test.
   Astuce Qualtrics : vous ne pourrez pas activer cette option si vous n’avez pas généré de mise en correspondance test plus tôt. Faites défiler jusqu’à la section Ajouter un événement de test pour générer le mappage de test.
9. Mettez en surbrillance les données utiles de l’événement JSON et copiez-les.
10. Cliquez sur Enregistrer.
11. Revenez à l’événement Twilio Segment dans Qualtrics. Accédez à la section Paramètres avancés.
12. Collez les données utiles d’événement JSON que vous avez copiées précédemment dans la zone d’objet JSON.
13. Cliquez sur Ajouter un mappage de champ. Vos zones seront automatiquement mappées pour vous en fonction des données utiles JSON.
14. Accédez à la section Mapper les champs et vérifiez que vos champs sont correctement mappés. Vous pouvez ajuster vos zones si nécessaire.
15. Pour le chemin, saisissez les noms de chemin de zone de Twilio Segment pour les zones que vous voulez sauvegarder dans Qualtrics.
16. Pour le Type, sélectionnez le type de données que le champ contient :
    • Chaîne : les données sont une chaîne de texte.
    • Nombre : les données sont une valeur numérique.
    • Booléen : les données sont une valeur booléenne (c’est-à-dire, vrai ou faux).
17. Cliquez sur Ajouter un champ pour mapper des champs supplémentaires.
18. Cliquez sur le signe moins ( – ) pour supprimer une zone de votre mappage.
19. Si vous le souhaitez, vous pouvez tester l’intégration pour vérifier si les bonnes données sont transmises à Qualtrics en cliquant sur les données du test d’exécution, puis en déclenchant un événement à partir de Twilio Segment. Pour plus d’informations, voir Capture des données d’événement.
    Astuce Qualtrics : consultez la syntaxe JSONPath pour obtenir plus d’aide sur l’interprétation de votre JSON.
20. Cliquez sur Enregistrer.
21. N’oubliez pas d’ajouter une tâche à votre workflow. En règle générale, il s’agit d’une tâche du répertoire XM pour distribuer une enquête.
    Astuce Qualtrics : si vous souhaitez enregistrer ou mettre à jour les informations de contact, voir Ajouter ou mettre à jour des contacts dans le répertoire XM.
    Exemple : supposons qu’un client termine sa visite guidée d’intégration de nouveaux utilisateurs, ce qui met à jour son enregistrement dans Twilio Segment. cette modification des données peut ensuite déclencher un workflow Qualtrics, que nous pouvons utiliser pour distribuer une enquête au client en lui demandant de donner son avis sur son expérience d’intégration.