Meta の Workplace

Meta Workplace インテグレーションを使用すると、エンドユーザーとやり取りできる Meta Workplace bot を作成できます。

仕組み

統合の仕組みは次のとおりです。

  • Meta Workplace を使用するカスタマー インテグレーションを作成します。
  • 会話エージェント（Dialogflow CX）インテグレーションと Workplace インスタンスを構成して、相互に通信できるようにします。
  • 会話エージェント（Dialogflow CX）インテグレーションでは、Meta の Send API を使用してエンドユーザーにメッセージを送信します。
  • 会話エージェント（Dialogflow CX）インテグレーションは、Workplace Webhook from Meta として機能することで、エンドユーザーからメッセージを受信します。

設定

統合を設定するには:

  1. Meta Workplace カスタム インテグレーションを作成する手順については、Meta Workplace カスタム インテグレーションを作成するをご覧ください。

    • Meta Workplace カスタム インテグレーションを作成する。
    • このステップでアプリ シークレットが提供されます。この値をコピーします。このトークンは、会話エージェント（Dialogflow CX）コンソールからインテグレーションを構成するために使用されます。
    • インテグレーションのアクセス トークンを作成またはリセットします。この値をコピーします。このトークンは、会話エージェント（Dialogflow CX）コンソールからインテグレーションを構成するために使用されます。
    • カスタム インテグレーションの権限を設定します。[権限] で Message any member が有効になっていることを確認します。

  2. 会話エージェント（Dialogflow CX）コンソールからインテグレーションを構成します。

    1. Dialogflow CX コンソールに移動する。
    2. 左側のパネルで [Manage] タブをクリックします。
    3. 左側のサイドバー メニューで [Integrations] をクリックします。
    4. [Meta Workplace] タイルの [Connect] ボタンをクリックします。

    5. 構成ダイアログが開きます。

      • App secret: [App Dashboard Basic Settings] でアプリ シークレットを入力します。

      • Access token: 上記の Meta アプリ設定時にコピーしたアクセス トークンを入力します。

      • Verify token: 任意のプライベート トークンを入力できます。この値をコピーします。これは Meta Workplace の Webhook を構成するために使用されます。

      • Webhook URL: この値をコピーします。これは Meta Workplace の Webhook を構成するために使用されます。

      • Start: クリックすると、エージェントのこの統合サービスが開始されます。

  3. Meta Workplace カスタム インテグレーションのセットアップを完了してテストします。Meta Workplace の Webhook のドキュメントの手順に沿って、次の操作を行います。

    • アプリの Meta の Webhook を構成します。上記でコピーした [Webhook URL] と [Verify token] の値を使用します。
    • Webhook トピックにインテグレーションを登録します。ページ登録で、messages と messaging_postbacks を必ず有効にしてください。
    • アプリをテストします。

リッチ レスポンス メッセージ

リッチ レスポンス メッセージは、フルフィルメントのカスタム ペイロードによってサポートされます。メッセージの形式については、Send API Parameters Message Object をご覧ください。

たとえば、次のカスタム ペイロードは単純なテキスト メッセージを提供します。

{
  "text": "Hello, world"
}

次のカスタム ペイロードは、画像メッセージを提供します。

{
  "attachment": {
    "type": "image",
    "payload": {
      "url": "https://example.com/test.jpg"
    }
  }
}

チャネル固有のレスポンス

構成すると、エージェントが Meta Messenger のメッセージに応答する際に、チャネル DF_CX_FB_MESSENGER のチャネル固有のレスポンスが自動的に使用されます。