Creazione di un percorso

Un journey viene definito utilizzando un tipo di risposta user_defined, che è disponibile solo nell'editor JSON. (Per ulteriori informazioni, vedere Definizione delle risposte con l'editor JSON ) Per creare un viaggio, procedere come segue:

1. Nell'editor delle azioni, creare o modificare il passo da cui si desidera iniziare il viaggio.

2. Fare clic sull'icona Passa all'editor JSON per aprire l'editor JSON.

3. Nell'array generic, crea una risposta user_defined. (Per ulteriori informazioni, vedere Definizione delle risposte con l'editor JSON )

   Un viaggio è definito utilizzando la struttura seguente:

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

   dove:

   user_defined_type

   Il tipo specifico di risposta definita dall'utente che si sta definendo. Per definire un viaggio, impostare sempre questa proprietà su IBM_BETA_JOURNEYS_TOUR.

   skip_card

   Una proprietà facoltativa che specifica se la chat web deve iniziare il viaggio immediatamente senza attendere che il cliente faccia clic sulla scheda introduttiva nella finestra della chat web. (Il valore predefinito è 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

   Il titolo da visualizzare nella scheda introduttiva che viene visualizzata nella chat Web quando è disponibile un viaggio (ad esempio, Website tour o Disputing a charge).

   card_description

   La descrizione da visualizzare sulla scheda introduttiva. Descrivi il percorso in modo che i tuoi clienti possano decidere se vogliono aprirlo.

   steps

   Una serie di risposte che definiscono i passi nel percorso.

Esempio

Il seguente esempio definisce un percorso che mostra agli utenti come contestare una spesa, utilizzando una combinazione di risposte di testo, immagine e video.

{
  "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."
          }
        ]
      }
    }
  ]
}

Iniziare un viaggio senza aprire la chat web

Anche se i viaggi fanno parte dell'integrazione della web chat, puoi rendere possibile ai tuoi clienti iniziare un viaggio direttamente dal tuo sito web senza aprire la finestra della web chat. Ad esempio, è possibile includere un pulsante Mostra sul sito Web su cui i clienti possono fare clic per avviare un tour interattivo della pagina.

Per iniziare un viaggio senza aprire la chat web:

1. Nell'azione che invia la risposta journey, modifica il JSON che definisce il journey. Includere "skip_card": true per ignorare la scheda introduttiva.

2. Sul tuo sito web, utilizza il metodo di istanza send() per inviare un messaggio all'assistente che attiva l'azione che inizia il viaggio (come Give me a tour). Inviare il messaggio in risposta a qualsiasi evento che si desidera utilizzare per attivare il viaggio (ad esempio un clic del pulsante o il caricamento della pagina).

I tuoi clienti possono ora iniziare il percorso interattivo direttamente dal sito web senza dover aprire prima la chat web. (Se la finestra di chat Web viene aperta in seguito, la scheda introduttiva per il viaggio viene visualizzata nella cronologia della conversazione.)

Limitazioni

Questa funzione beta ha attualmente i seguenti limiti:

• Il riquadro di anteprima non supporta i viaggi. Se si desidera visualizzare l'anteprima di un viaggio, utilizzare il link di anteprima condivisibile. Per ulteriori informazioni sul link di anteprima, consultare Copia di un link da condividere.

• I percorsi utilizzano il metodo view:change event o changeView e non funzionano con gli eventi window:open o window:close o i metodi dell'istanza openWindow, closeWindow e toggleOpen.

• Quando il cliente inizia un viaggio, la finestra di chat web si chiude. Se si utilizza l'evento view:change per attivare la visualizzazione di un modulo post - chat, il codice deve controllare il valore del nuovo parametro event.reason o event.newViewState.tour per decidere se mostrare il modulo è appropriato.