Meta Workplace インテグレーションを使用すると、エンドユーザーとやり取りできる Meta Workplace bot を作成できます。
仕組み
統合の仕組みは次のとおりです。
- Meta Workplace を使用するカスタマー インテグレーションを作成します。
- Dialogflow CX インテグレーションと Workplace インスタンスを構成して、相互に通信できるようにします。
- Dialogflow CX インテグレーションでは、Meta の Send API を使用してエンドユーザーにメッセージを送信します。
- Dialogflow CX インテグレーションは、Workplace Webhook from Meta として機能することで、エンドユーザーからメッセージを受信します。
設定
統合を設定するには:
Meta Workplace カスタム インテグレーションを作成する手順については、Meta Workplace カスタム インテグレーションを作成するをご覧ください。
- Meta Workplace カスタム インテグレーションを作成する。
- このステップでアプリ シークレットが提供されます。この値をコピーします。このトークンは、Dialogflow CX コンソールからインテグレーションを構成するために使用されます。
- インテグレーションのアクセス トークンを作成またはリセットします。この値をコピーします。このトークンは、Dialogflow CX コンソールからインテグレーションを構成するために使用されます。
- カスタム インテグレーションの権限を設定します。[権限] で
Message any memberが有効になっていることを確認します。
Dialogflow CX コンソールから統合を構成します。
- Dialogflow CX コンソールに移動
- 左側のパネルで [Manage] タブをクリックします。
- 左側のサイドバー メニューで [Integrations] をクリックします。
- [Meta Workplace] タイルの [Connect] ボタンをクリックします。
構成ダイアログが開きます。
App secret: [App Dashboard Basic Settings] でアプリ シークレットを入力します。
Access token: 上記の Meta アプリ設定時にコピーしたアクセス トークンを入力します。
Verify token: 任意のプライベート トークンを入力できます。この値をコピーします。これは Meta Workplace の Webhook を構成するために使用されます。
Webhook URL: この値をコピーします。これは Meta Workplace の Webhook を構成するために使用されます。
Start: クリックすると、エージェントのこの統合サービスが開始されます。
Meta Workplace カスタム インテグレーションのセットアップを完了してテストします。Meta Workplace の Webhook のドキュメントの手順に沿って、次の操作を行います。
- アプリの Meta の Webhook を構成します。上記でコピーした [Webhook URL] と [Verify token] の値を使用します。
- 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 のチャネル固有のレスポンスが自動的に使用されます。