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. ナビゲーション メニューの [管理] タブに移動します。
    3. [統合] を選択します。
    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: [Start] をクリックすると、エージェントの統合サービスが開始されます。
  3. Meta Workplace 統合の設定を完了してテストします。Meta Workplace の Webhook のドキュメントの手順に沿って、次のタスクを完了します。
    • 先ほどコピーした [Webhook URL] と [Verify token] の値を使用して、アプリの Meta の Webhook を構成します。
    • Webhook トピックにインテグレーションを登録し、ページ登録で messages と messaging_postbacks が有効になっていることを確認します。
    • アプリをテストします。

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

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

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

{
  "text": "Hello, world"
}

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

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

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

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