Facebook の Workplace

Dialogflow と Facebook Workplace の統合を使用すると、エンドユーザーとやり取りする Facebook bot から Workplace を作成できます。

制限事項

この統合では、デフォルトのエージェント言語のみがサポートされます。

仕組み

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

  • Dialogflow の統合と Workplace インスタンスを構成して、相互に通信できるようにします。
  • Dialogflow の統合では、Facebook Messenger API を使用してエンドユーザーにメッセージを送信します。
  • Dialogflow の統合は、Facebook Workplace の Webhook として機能することで、エンドユーザーからメッセージを受信します。

開始

統合を開始するには:

  1. Workplace インスタンスがない場合は登録し、グループのシステム管理者であることを確認してください。

  2. Dialogflow コンソールから統合を有効にします。

    1. Dialogflow ES コンソールに移動します。
    2. 左側のサイドバー メニューで [Integrations] をクリックします。
    3. [Workplace from Facebook] をクリックします。
    4. [START] をクリックすると、インストールを完了するために Workplace にリダイレクトされます。
      • Workplace アカウントにログインします。統合をインストールするには、アカウントが Workplace のシステム管理者である必要があります。
      • Dialogflow 統合のインストールを求めるポップアップ ウィンドウで [Add to Workplace] をクリックします。 また、bot の名前をカスタマイズすることもできます。

  3. アプリをテストします。

    1. Workplace に移動して、アカウントにログインします。
    2. サイドバーの [ホーム] セクションにある [bot] で [Dialogflow] （またはカスタマイズした bot の名前）を見つけ、bot とのチャットを開始します。

キャンセル

[START] ボタンをクリックしたが、Workplace でのインストールを完了したくない場合:

  1. Dialogflow ES コンソールに移動します。

  2. 左側のサイドバー メニューで [Integrations] をクリックします。

  3. [Facebook Workplace] をクリックします。

    1. [CANCEL] ボタンが表示されている場合は、[CANCEL] をクリックしてインストールをキャンセルします。
    2. [STOP] ボタンが表示されている場合は、下記の手順に沿って統合をアンインストールします。

停止

正常にインストールされた統合を停止するには:

  1. Dialogflow ES コンソールに移動します。

  2. 左側のサイドバー メニューで [Integrations] をクリックします。

  3. [Facebook Workplace] をクリックします。

  4. [STOP] をクリックすると、インストールを完了するために Workplace にリダイレクトされます。

    1. Workplace アカウントにログインします。統合をアンインストールするには、アカウントが Workplace のシステム管理者である必要があります。
    2. Workplace にインストールされている統合から Dialogflow 統合を見つけて選択し、[Uninstall] をクリックしてアンインストールを完了します。

  5. Dialogflow の統合がアンインストールされます。

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

この統合により、一部のリッチ レスポンス メッセージが Facebook Messenger プラットフォームのメッセージ タイプに変換されます。

画像のレスポンス

画像レスポンスは、Facebook Messenger の添付ファイル メッセージとして Facebook Messenger に送信されます。message.attachment.type 値は image に設定されます。次の形式がサポートされています。

  • jpg
  • png
  • 静的 GIF
  • アニメーション GIF

カード形式のレスポンス

カード形式のレスポンスは、Facebook Messenger の汎用テンプレートとして Facebook Messenger に送信されます。

クイック返信のレスポンス

クイック返信のレスポンスは、Facebook Messenger のクイック返信として Facebook Messenger に送信されます。

カスタム ペイロードのレスポンス

他の種類の Facebook Messenger メッセージを送信するには、カスタム ペイロードを使用できます。

カスタム ペイロードの一般的な形式は次のとおりです。

{
  "facebook": {
    message
  }
}

message の代わりに、Facebook Messenger の message オブジェクトを指定します。message オブジェクトの詳細については、Facebook Messenger API リファレンスをご覧ください。

次に例を示します。

  • 音声リンクを送信します。
    {
  "facebook": {
    "attachment": {
      "type": "audio",
      "payload": {
        "url": "https://example.com/audio/test.mp3"
      }
    }
  }
}
  • 再生可能な動画を送信します。
    {
  "facebook": {
    "attachment": {
      "type": "video",
      "payload": {
        "url": "https://example.com/video.mp4"
      }
    }
  }
}
  • ファイルを送信します。 
    {
  "facebook": {
    "attachment": {
      "type": "file",
      "payload": {
        "url": "https://example.com/file.pdf"
      }
    }
  }
}

制限事項

  1. Dialogflow エージェントは 1 つの Workplace にのみインストールが可能ですが、複数の Dialogflow エージェントを 1 つの Workplace インスタンスにインストールできます。

  2. 失敗したインストールを削除するには、Dialogflow でのインストールをキャンセルし、Workplace でのインストールを削除する必要があります。

移行

Messenger 統合を使用していて、Workplace 統合に移行する場合は、次の操作を行う必要があります。

  1. Messenger 統合を停止します。

  2. Facebook アプリの設定の手順を逆にすると、Facebook アプリの callback_url が削除されます。

  3. 上記の手順で Workplace 統合を開始します。