ジャーニーの作成

Journey は、JSON エディターでのみ使用可能な user_defined 応答タイプを使用して定義されます。 （詳細については 、「JSON エディタを使用したレスポンスの定義 」を参照してください。） 旅を作成するには、以下の手順に従います

1. アクションエディタで、旅を開始したいステップを作成または編集します。

2. 「JSON エディターに切り替え」 アイコン をクリックして、JSON エディターを開きます。

3. generic 配列で、 user_defined 応答を作成します。 （詳細については 、「JSON エディタを使用したレスポンスの定義 」を参照してください。）

   Journey は、以下の構造を使用して定義されます。

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

   ここで、

   user_defined_type

   定義しようとしているユーザー定義応答の特定のタイプ。 Journey を定義するには、常にこのプロパティーを IBM_BETA_JOURNEYS_TOUR に設定します。

   skip_card

   顧客が Web チャット・ウィンドウで導入カードをクリックするのを待たずに、Web チャットがジャーニーを即時に開始するかどうかを指定するオプション・プロパティー。 （デフォルト値は 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

   Journey が使用可能な場合に Web チャットに表示される、導入カードに表示されるタイトル (例えば、 Website tour または Disputing a charge)。

   card_description

   紹介カードに表示する説明文。 顧客がオープンするかどうかを決定できるように、ジャーニーについて説明してください。

   steps

   Journey のステップを定義する応答の配列。

例

以下の例では、テキスト、イメージ、およびビデオの応答の組み合わせを使用して、課金に異議を唱える方法をユーザーに示すジャーニーを定義します。

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

Web チャットを開かずにジャーニーを開始する

Journey は Web チャット統合の一部ですが、Web チャット・ウィンドウをまったく開かずに、顧客が Web サイトから直接ジャーニーを開始できるようにすることができます。 例えば、顧客がクリックしてページの対話式ツアーを起動できる 「Show me」 ボタンを Web サイトに組み込むことができます。

Web チャットを開かずにジャーニーを開始するには、以下の手順に従ってください。

1. Journey 応答を送信するアクションで、journey を定義する JSON を編集します。 "skip_card": true を含めて、導入カードをバイパスします。

2. Web サイトで、 send() インスタンス・メソッドを使用して、Journey を開始するアクション ( Give me a tour など) をトリガーするメッセージをアシスタントに送信します。 ジャーニーをトリガーするために使用する任意のイベント (ボタン・クリックやページ・ロードなど) に応答してメッセージを送信します。

お客様は、最初に Web チャットを開くことなく、Web サイトから直接対話式のジャーニーを開始できるようになりました。 (後で Web チャット・ウィンドウを開くと、ジャーニーの概要カードがチャット履歴に表示されます。)

制限

このベータ機能には現在、以下の制限があります。

• プレビュー・ペインは Journey をサポートしていません。 Journey をプレビューする場合は、共有可能プレビュー・リンクを使用します。 プレビュー・リンクについて詳しくは、 共有へのリンクのコピー を参照してください。

• Journey は view:change イベントまたは changeView メソッドを使用し、 window:open イベントまたは window:close イベント、あるいは openWindow、 closeWindow 、および toggleOpen インスタンス・メソッドでは機能しません。

• 顧客がジャーニーを開始すると、Web チャット・ウィンドウが閉じます。 view:change イベントを使用してチャット後のフォームの表示をトリガーする場合は、コードで新しい event.reason または event.newViewState.tour パラメーターの値を確認して、フォームを表示することが適切かどうかを判断する必要があります。