ボットの会話でカードを操作する

WhatsAppでカードを構成するときは、次の考慮事項に留意してください。

• WhatsAppは、カードで最大3つのボタンをサポートします。 3つ以上のボタンを設定すると、エラーが発生します。
• WhatsAppのサポートは、テキストの戻るボタンに限定されています。 WhatsAppはURLボタンをサポートしていません。
• お客様は、各テキストの戻るボタンを1回選択でき、1つの選択肢に限定されません。 ボットの動作は、ユーザーが複数のオプションを選択する可能性があるシナリオを考慮に入れる必要があります。
• WhatsAppはカードのボットレスポンスのdefaultActionをサポートしていません。
• 画像や動画を含むカードには、タイトルが表示されません。 テキストのみを使用する場合は、タイトルが表示されます。

たとえば、「ノルウェー行きのフライトが50％オフ」というタイトルのカードを設定し、画像を含めると、タイトルは表示されません。

タイトルを使用して画像を使用せずにカードを構成すると、タイトルがカードに表示されます。

1. Genesys AppFoundryからAmazon Lex統合をインストールする
2. Amazon Lex アプリのアクセス権限を使用して IAM ロールを設定します。
3. Genesys CloudでのLexインテグレーションの設定とアクティブ化
4. AWS Lex Consoleでクイック返信オプションを設定するには、このカスタムJSONを使用して、ボットのインテントに対する返信を定義します。 

{
    "genesys_prompt": "String", // optional message text
    "genesys_carousel": [
         {
              "title": "String", // mandatory cards title line
              "description": "String", // optional cards body text explaining its purpose
              "image": "URL", // optional a URL pointing to the image shown in the card
              "defaultAction":  {
                    "type": "String", //Describes the type of action. Valid values Link Postback
                    "text": "String", //The response text from the button click
                    "payload": "String", // Text to be returned as the payload from a ButtonResponse when a button is clicked.
                    "url": "String" //A URL of a web page to direct the user to.
              },
              "actions": [
                    {                                       
                         "type": "String", //Describes the type of action.  Valid values Link Postback
                         "text": "String", //The response text from the button click
                         "payload": "String" // Text to be returned as the payload from a ButtonResponse when a button is clicked.
                    },
                    {
                         "type": "String", //Describes the type of action.  Valid values Link Postback
                         "text": "String", //The response text from the button click
                         "url": "String" //A URL of a web page to direct the user to.
                    }
              ]
         }
    ]
}

カードオプションを使用してボットのスロットを埋めるには、AWSコンソールカードエディターを使用します。

画像をクリックして拡大します。

カードオプションを使用してボットのインテントを切り替えるには、AWS Lex Consoleで、前のセクションのカスタムJSONを[Response]入力フィールドにコピーします。

画像をクリックして拡大します。

もっと詳しく知る：

• Amazon Lexの統合について
• レスポンスカードの使用 AWS開発者ガイド
• AWS Developers GuideのManaging MessagesページにあるResponse Cards

1. Genesys AppFoundryからGoogle Dialogflow統合をインストールする
2. Google Dialogflowプラットフォームサービスアカウントの認証情報を構成します。
3. Google Dialogflow統合を有効にする
4. Dialogflowコンソールでクイック返信オプションを設定するには、このカスタムJSONを使用して、ボットの目的のオプションを定義します。

{
    "genesys_prompt": "String", // optional message text
    "genesys_carousel": [
         {
              "title": "String", // mandatory cards title line
              "description": "String", // optional cards body text explaining its purpose
              "image": "URL", // optional a URL pointing to the image shown in the card
              "defaultAction":  {
                    "type": "String", //Describes the type of action. Valid values Link Postback
                    "text": "String", //The response text from the button click
                    "payload": "String", // Text to be returned as the payload from a ButtonResponse when a button is clicked.
                    "url": "String" //A URL of a web page to direct the user to.
              },
              "actions": [
                    {                                       
                         "type": "String", //Describes the type of action.  Valid values Link Postback
                         "text": "String", //The response text from the button click
                         "payload": "String" // Text to be returned as the payload from a ButtonResponse when a button is clicked.
                    },
                    {
                         "type": "String", //Describes the type of action.  Valid values Link Postback
                         "text": "String", //The response text from the button click
                         "url": "String" //A URL of a web page to direct the user to.
                    }
              ]
         }
    ]
}

カードオプションを使用してボットのインテントを切り替えるには、Dialogflowコンソールで、前のセクションのカスタムJSONを[応答]入力フィールドに追加します。

Google Cloud Dialogflow ESの例

画像をクリックして拡大します。

Google Cloud Dialogflow CXの例

画像をクリックして拡大します。

カードオプションを使用してボットのスロットを埋めるには、前のセクションのカスタムJSONをWebhookに使用します。 この目的でAWSLambdaを使用することもできます。 詳しくは、Google Cloud Dialogflow ESガイドのWebhook for slot filling を参照。

もっと詳しく知る：

• Google Dialogflow統合について
• スロット充填用のWebhook Google Cloud DialogflowESガイド

1. Genesys Bot Connectorの仕様に準拠したボットを作成する. 
2. Genesysボットコネクタ統合を構成する。
3. PostTextMessage カードオブジェクトを使用してカードを定義する.

もっと詳しく知る：

• Genesysボットコネクタについて
• postUtterance 応答例 - カード