Création d'un parcours

Un parcours est défini à l'aide du type de réponse user_defined, qui est disponible uniquement dans l'éditeur JSON. (Pour plus d'informations, voir Définir des réponses à l'aide de l'éditeur JSON ) Pour créer un parcours, suivez les étapes suivantes :

1. Dans l'éditeur d'actions, créez ou modifiez l'étape à partir de laquelle vous souhaitez commencer le voyage.

2. Cliquez sur l'icône Passer à l'éditeur JSON pour ouvrir l'éditeur JSON.

3. Dans le tableau generic, créez une réponse user_defined. (Pour plus d'informations, voir Définir des réponses à l'aide de l'éditeur JSON )

   Un parcours est défini à l'aide de la structure suivante:

   "user_defined": {
     "user_defined_type": "IBM_BETA_JOURNEYS_TOUR",
     "skip_card": true|false,
     "card_title": "{title}",
     "card_description": "{description}",
     "steps": [
       ...
     ]
   }
   

   où :

   user_defined_type

   Type spécifique de réponse définie par l'utilisateur que vous définissez. Pour définir un parcours, définissez toujours cette propriété sur IBM_BETA_JOURNEYS_TOUR.

   skip_card

   Propriété facultative qui indique si la discussion Web doit démarrer immédiatement le parcours sans attendre que le client clique sur la carte d'introduction dans la fenêtre de discussion Web. (La valeur par défaut est false.)

   You can use this option to start a journey directly from your website, even if the web chat is not open. For more information, see Starting a journey without opening the web chat.

   card_title

   Titre à afficher sur la carte d'introduction qui apparaît dans la discussion Web lorsqu'un parcours est disponible (par exemple, Website tour ou Disputing a charge).

   card_description

   La description à afficher sur la carte d'introduction. Décrivez le parcours afin que vos clients puissent décider s'ils souhaitent l'ouvrir.

   steps

   Tableau de réponses définissant les étapes du parcours.

Example

L'exemple suivant définit un parcours qui montre aux utilisateurs comment contester des frais, à l'aide d'une combinaison de réponses texte, image et vidéo.

{
  "generic": [
    {
      "response_type": "user_defined",
      "user_defined": {
        "card_title": "Let’s dispute a charge!",
        "card_description": "Follow along with this guided journey to learn how to find and dispute charges.",
        "user_defined_type": "IBM_BETA_JOURNEYS_TOUR",
        "steps": [
          {
            "response_type": "text",
            "text": "Charges are listed on the Transactions page. **Click your profile photo** in the top right corner of your screen, and then **click Transactions** from the menu."
          },
          {
            "response_type": "text",
            "text": "Here you can view your charges.\n **Scroll through the Transactions page and review your charges.** Each charge contains a merchant name, transaction date, and amount charged."
          },
          {
            "response_type": "image",
            "source": "https://example.com/image.png",
            "alt_text": "Image showing location of Dispute option",
            "description": "The option to Dispute is marked in red on the right hand side of each row in the Transactions table. Just click here to file a dispute."
          },
          {
            "response_type": "video",
            "source": "https://vimeo.com/769580398",
            "description": "Watch this short video to learn what to expect now that you’ve filed a dispute."
          }
        ]
      }
    }
  ]
}

Démarrage d'un parcours sans ouverture de la discussion Web

Bien que les parcours fassent partie de l'intégration de la discussion Web, vous pouvez permettre à vos clients de commencer un parcours directement à partir de votre site Web sans ouvrir la fenêtre de discussion Web du tout. Par exemple, vous pouvez inclure un bouton Me montrer sur votre site Web sur lequel les clients peuvent cliquer pour lancer une visite interactive de la page.

Pour démarrer un parcours sans ouvrir la discussion Web:

1. Dans l'action qui envoie la réponse de parcours, éditez le JSON qui définit le parcours. Incluez "skip_card": true pour ignorer la carte d'introduction.

2. Sur votre site Web, utilisez la méthode d'instance send() pour envoyer un message à l'assistant qui déclenche l'action qui démarre le parcours (par exemple, Give me a tour). Envoyez le message en réponse à l'événement que vous souhaitez utiliser pour déclencher le parcours (par exemple, un clic sur un bouton ou un chargement de page).

Vos clients peuvent désormais commencer le parcours interactif directement à partir de votre site Web sans avoir à ouvrir d'abord la discussion Web. (Si la fenêtre de discussion Web est ouverte ultérieurement, la carte de présentation du parcours apparaît dans l'historique des discussions.)

Limitations

Cette fonction bêta présente actuellement les limitations suivantes:

• Le panneau d'aperçu ne prend pas en charge les parcours. Si vous souhaitez prévisualiser un parcours, utilisez le lien d'aperçu partageable. Pour plus d'informations sur le lien d'aperçu, voir Copie d'un lien à partager.

• Les parcours utilisent la méthode view:change event ou changeView et ne fonctionnent pas avec les événements window:open ou window:close ou les méthodes d'instance openWindow, closeWindow et toggleOpen.

• Lorsque le client démarre un parcours, la fenêtre de discussion Web se ferme. Si vous utilisez l'événement view:change pour déclencher l'affichage d'un formulaire de post-discussion, votre code doit vérifier la valeur du nouveau paramètre event.reason ou event.newViewState.tour pour décider si l'affichage du formulaire est approprié.