Facebook Messengerでアプリケーション・シークレットおよびページ・アクセス・トークンを生成します。

1. Facebook開発者のアカウントにログインします。

2. ボットをホストするFacebookページを作成します。ページに追加する説明、イメージおよびカバー・ページにより、そのユーザーはボットを識別します。

3. 次に、このページにリンクするFacebookアプリケーションを作成します。これはメッセンジャ・アプリケーションであるため、「Apps for Messenger」を選択して、「Create App ID」をクリックします。
   
   図の設定の説明-fbapp.png
   

   このダイアログで「Apps for Messenger」オプションを選択しなかった場合(テスト・アプリケーションを作成している場合)は、左側のナビゲーション・バーで「Add Product」をクリックし、「Product Setup」ページから「Messenger」を選択して「Get Started」をクリックします。
   
   図add-product.pngの説明
   

4. Facebookアプリケーションの「Dashboard」ページで、アプリケーション・シークレットをコピーして、使用中のシステムの任意の場所に貼り付けます。
   
   図facebook-dashboard.pngの説明
   

   Facebookチャネルの構成を完了するには、アプリケーション・シークレットが必要です。

5. アプリケーションのダッシュボードで、Facebookページを選択して、ページ・アクセス・トークンを生成します。
   
   図page-access-token.pngの説明
   

6. このアクセス・トークンをコピーして、任意の場所に貼り付けます。

   このトークン(FacebookアプリケーションがFacebookのMessaging APIにアクセスできるようにする)を使用して、デジタル・アシスタントでチャネル定義を完了します。

構成が完了したら、Facebookチャネルをアクティブ化できます。

• デジタル・アシスタントで、このチャネルを選択して、「チャネル有効」コントロールをオンに切り替えます。
• をクリックし、チャネルに関連付けるデジタル・アシスタントまたはスキルを選択します。

これで、このチャネルを介してボットをテストできるようになりました。

Facebookチャネルおよびメッセージングの構成が完了したら、ご使用の電話でFacebookページ、Facebook Messenger (https://www.messenger.com/)およびFacebook Messengerアプリケーション()を使用してボットをテストできます。検索でボットを見つけたら、いつでもチャットを開始できます。ダイアログ・フローに対する変更をリアルタイムで確認できます。

図test-bot.pngの説明

Facebook Messengerでは、「Message」フィールドの横に固定メニューを作成できます。この機能の詳細は、https://developers.facebook.com/docs/messenger-platform/send-messages/persistent-menu/を参照してください。

Order PizzaおよびOrder Pastaの固定メニュー・アイテムを表示する例を次に示します:

図persistent-menu.jpgの説明

デジタル・アシスタントのFacebook Messengerチャネルでは、次の機能がサポートされています:

• テキスト(送信と受信の両方)
• イメージ(送信と受信の両方)
• ファイル(送信と受信の両方)
• 絵文字(送信と受信の両方)
• ロケーション(ただし非推奨) (送信と受信の両方)
• リンク
• ポストバック
• ロケーション・リクエスト
• カスタム・プロパティ
• カルーセル・コンポーネント
• リスト・コンポーネント

異なる書式設定機能および構文を使用してスキルを複数のチャネルにターゲット指定する場合は、メッセージで基本的なHTMLマークアップを使用できます。そうすると、メッセージがチャネルに送信されると、そのマークアップがFacebook Messengerのマークダウン形式に自動的に変換されます。これは、Facebook Messengerに加えて、スキルを他のチャネルにターゲティングする場合に特に役立ちます。チャネルでのリッチ・テキスト形式を参照してください。

デジタル・アシスタントのFacebook Messengerチャネルには、次のようなメッセージの制約があります:

• テキスト・メッセージ
  • テキスト・メッセージの最大長: 640文字。長さが640を超えると、テキストは複数のメッセージに分割されます。
  • テキスト・アクション・ラベルの最大長: 20文字
  • 許可されるテキスト・アクションのタイプ: ポストバック、コール、URL
  • テキスト・アクションの最大数: 3。テキスト・アクションがこれよりも多い場合、メッセージは複数の水平カードに変換されて、各カードで同じテキストがタイトルとして使用され、各カードに最大3つのアクションが含まれます。
• 水平カード
  • タイトルの最大長: 80文字
  • 説明の最大長: 80文字
  • カード・アクション・ラベルの最大長: 20文字
  • カードの最大数: 10
  • カード・アクションの最大数: 3。カード・アクションの数が3を超える場合、残りのカード・アクションをレンダリングするためにカードが複製されます。
  • カード・アクションの最小数: 0
  • カード・リスト・アクションの最大数: 0
  • 説明、イメージまたはアクションが少なくとも1つ必要かどうか: はい
  • 許可されるカード・アクションのタイプ: ポストバック、コール、URL、共有
  • 許可されるカード・リスト・アクションのタイプ: なし
• 垂直カード
  • サポート対象外
• アタッチメント・メッセージ
  • サポートの有無: はい
  • アタッチメント・アクションが許可されるかどうか: いいえ
• アクション・ボタン
  • グローバル・アクション・ラベルの最大長: 20文字
  • グローバル・アクションの最大数: 11
  • 許可されるグローバル・アクションのタイプ: ポストバック

Facebookメッセンジャ・チャネルの場合、Facebookに固有の機能で共通レスポンス・コンポーネントの機能を拡張できます。

拡張機能にアクセスするには、共通レスポンス・コンポーネントのメタデータのchannelCustomProperties要素を使用し、適切なプロパティを設定します。コードのフォーマットは次のとおりです:

...
            channelCustomProperties:
            - channel: "facebook"
              properties:
                PROPERTY_NAME: "PROPERTY_VALUE"
...

Facebook Messengerチャネルで使用可能なカスタム・プロパティを次に示します:

レスポンス・アイテム・レベル(top_element_style)とカード・レベル(webview_height_ratioおよびfallback_url)で定義されたカスタム・プロパティの例を次に示します:

responseItems:
  - type: "cards"
    cardLayout: "vertical"
    cards:
      - title: "${pizzas.name}"
        description: "${pizzas.description}"
        imageUrl: "${pizzas.image}"
        url: "${pizzas.moreInfo}"
        iteratorVariable: "pizzas"
        channelCustomProperties:
          - channel: "facebook"
            properties:
              webview_height_ratio: "compact"
              fallback_url: "http://www.oracle.com"
    channelCustomProperties:
      - channel: "facebook"
        properties:
          top_element_style: "large"
...

channelCustomPropertiesの全般的な情報は、チャネル固有の拡張機能を参照してください。