ステップバイステップガイド：フルフィルメント

1. 「カスタムイベント」の応答タイプを追加してください。

   • カスタムイベントを追加したいテンプレートキーを探してください。 この場合は、「TrackPackageResponse」 テンプレートキーを使用してください。

   • テンプレートキーに「カスタムイベント」の応答タイプを追加します。

2. カスタムイベントレスポンスを設定してください。

   • イベント名とイベントペイロードを追加してください：

     1. カスタムイベントレスポンスには、イベント名を入力してください。 この場合は、 'TrackPack_Exit'。

     2. フローに渡されるデータを含むイベントペイロードを追加します。 これはJSON形式でなければなりません。 この例では、 {"PackageNumber":"${entity.PackageNum}"}。

3. フローでイベントペイロードを使用してください。

   • バーチャルエージェントV2のアクティビティメタデータへのアクセス：

     1. ボイスフローの設定では、追加したイベントペイロードは、Virtual Agent V2のアクティビティメタデータの一部として使用できます。

     2. フロー変数 PackageNum を作成してください。

     3. Parseアクティビティを使用して、Virtual Agent V2のアクティビティメタデータを入力変数として選択します。

     4. 出力変数を「PackageNum」に、そのパス式を （エージェントレスポンスで設定されたイベントペイロードの構造に基づいて）「$.PackageNum」に設定します。

   • HTTP アクティビティでメタデータを使用する:

     1. フローで処理されたメタデータの「PackageNum」変数を使用して、 パッケージを追跡します。

     2. 添付のフローをインポートして、HTTPアクティビティの詳細を調べてください。

     3. フロー変数「推定配達」を定義し、それを「$」に設定します。 estimated_delivery'と別のフロー変数 'PackStatus'を追加して、 $.statusに設定します。

   • HTTP アクティビティに基づいて条件を追加してください:

     1. フローに新しいConditionアクティビティを追加してください。 このアクティビティは、HTTPアクティビティの応答（パッケージが存在するかどうか、 およびそのステータス） を確認するために使用されます。

        この例では、{{ HTTPRequest_8l3.httpStatusCode == 404 }}この表現を使用して、パッケージが見つからなかったかどうかを確認します。

4. 条件に基づいたセット変数アクティビティを追加：

   1. パッケージが存在しない状態の場合：

      • パッケージが見つからないブランチの下に、Set Variable アクティビティを追加してください。
      • PackageRep（別のフロー変数）を次のように設定します。

        これらの詳細を含むパッケージは見つかりませんでした。

   2. パッケージが存在する条件について：

      • パッケージが見つかったブランチ（つまり、 HTTPステータスコードが404と等しくない）の下に、別の「変数を設定」アクティビティを追加します。

      • PackageRep（別のフロー変数）を次のように設定します。

        あなたの荷物は受け取りました。 それは {{推定配達}} によって配達されます。

   3. イベント名とイベントデータを設定するために、さらに2つのSet variableアクティビティを追加してください。 このデータはバーチャルエージェントV2のアクティビティに渡されます。

      • event_nameフロー変数を作成し、event_data

      • {'PackageResp': '{{PackageResp}} ' | json} event_name TrackPack_Entry event_data におよび設定してください。

5. バーチャルエージェントV2のアクティビティに戻ってください：

   • バーチャルエージェントV2のアクティビティを設定します：

     1. 最後の変数設定アクティビティをバーチャルエージェントV2アクティビティに接続します。

     2. イベント名を {{event_name}} に設定してください。

     3. イベントデータを {{event_data}} に設定してください。

6. 仮想エージェントで受信イベントを処理します。

   1. 新しいテンプレートキーを追加してください：

      1. 左側のパネルの「回答」タブに移動します。

      2. PackageStatusという名前の新しいテンプレートキーを追加してください。

   2. 受信イベントを設定する：

      1. 音声チャネルで、着信イベントをTrackPack_Entry（またはフロー内のVirtual Agent V2アクティビティに送信されたもの）に設定します。

   3. レスポンスを設定してください:

      1. 応答を <speak><say-as interpret-as="date"> $ {EventStore.PackageResp</say-as>} に設定してください。 他に何か手伝ってもいいですか？</speak>

         この応答は、フローのペイロードで送信された変数を使用しています。 イベントデータの一部として送信される変数はすべて、開発者が$ { eventStoreとしてアクセスできます。< variable_name >}。

         これもSSMLタグを使います。 特に、SSMLタグを使用すると、 テキストを音声合成エンジンがどのように解釈し、読み上げるかを制御できます。 このタグを使って、数字、日付、時刻、住所、 その他のテキストの発音方法を指定できます。 ここではデートに使います。