Journey erstellen

Eine Journey wird mit dem Antworttyp user_defined definiert, der ausschließlich im JSON-Editor verfügbar ist. (Weitere Informationen finden Sie unter "Antworten mit dem JSON-Editor definieren ".) Um eine Reise zu erstellen, befolgen Sie diese Schritte:

1. Erstellen oder bearbeiten Sie im Aktionseditor den Schritt, von dem aus Sie die Reise starten möchten.

2. Klicken Sie zum Öffnen des JSON-Editors auf das Symbol Zu JSON-Editor wechseln .

3. Erstellen Sie im Array generic eine user_defined-Antwort. (Weitere Informationen finden Sie unter "Antworten mit dem JSON-Editor definieren ".)

   Eine Reise wird mit der folgenden Struktur definiert:

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

   Dabei gilt:

   user_defined_type

   Der spezifische Typ der benutzerdefinierten Antwort, die Sie definieren. Wenn Sie eine Reise definieren möchten, setzen Sie diese Eigenschaft immer auf IBM_BETA_JOURNEYS_TOUR.

   skip_card

   Eine optionale Eigenschaft, die angibt, ob der Web-Chat die Reise sofort starten soll, ohne darauf zu warten, dass der Kunde auf die Einführungskarte im Web-Chat-Fenster klickt. (Der Standardwert ist 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

   Der Titel, der auf der Einführungskarte angezeigt werden soll, die im Web-Chat angezeigt wird, wenn eine Journey verfügbar ist (z. B. Website tour oder Disputing a charge)

   card_description

   Die Beschreibung, die auf der Einführungskarte angezeigt werden soll. Beschreiben Sie die Customer Journey, damit Ihre Kunden entscheiden können, ob sie sie öffnen möchten.

   steps

   Ein Array von Antworten, die die Schritte in der Journey definieren

Beispiel

Das folgende Beispiel definiert eine Reise, die Benutzern zeigt, wie sie eine Gebühr anzweifeln können, indem sie eine Kombination aus Text-, Bild-und Videoantworten verwenden.

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

Reise starten, ohne den Web-Chat zu öffnen

Obwohl Journeys Teil der Web-Chat-Integration sind, können Sie es Ihren Kunden ermöglichen, eine Journey direkt von Ihrer Website aus zu starten, ohne das Web-Chat-Fenster zu öffnen. Sie können beispielsweise eine Schaltfläche Show me auf Ihrer Website einfügen, auf die Kunden klicken können, um eine interaktive Tour der Seite zu starten.

So starten Sie eine Reise, ohne den Web-Chat zu öffnen:

1. Bearbeiten Sie in der Aktion, die die Journey-Antwort sendet, die JSON-Datei, die die Journey definiert. Schließen Sie "skip_card": true ein, um die Einführungskarte zu umgehen.

2. Verwenden Sie auf Ihrer Website die Instanzmethode send(), um eine Nachricht an den Assistenten zu senden, die die Aktion auslöst, mit der die Journey gestartet wird (z. B. Give me a tour). Senden Sie die Nachricht als Reaktion auf das Ereignis, das Sie zum Auslösen der Journey verwenden möchten (z. B. durch Klicken auf eine Schaltfläche oder Laden einer Seite).

Ihre Kunden können die interaktive Reise jetzt direkt von Ihrer Website aus starten, ohne zuerst den Web-Chat öffnen zu müssen. (Wenn das Web-Chat-Fenster später geöffnet wird, wird die Einführungskarte für die Reise im Chatverlauf angezeigt.)

Einschränkungen

Dieses Beta-Feature weist derzeit die folgenden Einschränkungen auf:

• Das Vorschaufenster unterstützt keine Journeys. Wenn Sie eine Vorschau einer Reise anzeigen möchten, verwenden Sie den gemeinsam nutzbaren Vorschaulink. Weitere Informationen zum Vorschaulink finden Sie unter Link zum Teilen kopieren.

• Journey verwenden die Methode view:change event oder changeView und funktionieren nicht mit den window:open-oder window:close-Ereignissen oder den openWindow-, closeWindow-und toggleOpen-Instanzmethoden.

• Wenn der Kunde eine Reise startet, wird das Web-Chat-Fenster geschlossen. Wenn Sie das Ereignis view:change verwenden, um die Anzeige eines Post-Chat-Formulars auszulösen, sollte Ihr Code den Wert des neuen Parameters event.reason oder event.newViewState.tour überprüfen, um zu entscheiden, ob das Anzeigen des Formulars geeignet ist.