Facebook Messenger または Facebook Workplace を介してユーザーと通信するようにボットを構成できます。 この記事では、Meta for Developers サイトを使用して Facebook アプリを作成し、ボットを Azure の Facebook アプリに接続し、Facebook でボットをテストする方法について説明します。
この記事では、Azure portal を使用して Facebook チャネルをボットに追加する方法について説明します。 カスタム チャネル アダプターの使用方法については、「 追加情報」を参照してください。
[前提条件]
- Azure サブスクリプション。 まだお持ちでない場合は、開始する前に 無料アカウント を作成してください。
- Azure に公開されたボットをFacebookに接続します。
- Facebook for Developers アカウント。 アカウントをお持ちでない場合は、 developers.facebook.com で作成できます。
- ユーザーがボットにアクセスする Facebook ページ。 まだお持ちでない場合は、 新しいページを作成します。
- ボットで Facebook Workplace を使用するには、ボットを接続するための Workplace アカウントとカスタム統合を作成する必要があります。
Facebook アプリを作成する
ユーザーは Facebook ページからボットにアクセスします。 ボットを接続するには、Facebook ページで Facebook Messenger を有効にしてから、ボットをページに接続します。
アプリを作成する
- Meta for Developers アカウントにサインインします。
- [ 新しい Facebook アプリの作成] に移動します。
- [ アプリの種類の選択 ] ページで、[ ビジネス ] を選択し、[ 次へ] を選択します。
- [ 基本情報の指定 ] ページで、アプリの名前を入力し、[ アプリの作成] を選択します。
- メッセージが表示されたら、パスワードを入力し、[ 送信] を選択してアプリを作成します。
- アプリが作成されると、サイトはアプリのページに移動します。
- [ 設定] を展開し、[ 基本] を選択します。
- アプリ ID とアプリ シークレットをコピーして保存します。
- [ 設定] で [ 詳細設定] を選択します。
- 結果のウィンドウで、[ セキュリティ 設定] まで下にスクロールし、[ アプリ設定への API アクセスを許可する] を有効にします。
- [ 変更の保存] を選択します。
Messenger を有効にする
- ダッシュボードを選択します。
- 結果のウィンドウで、[ Messenger ] タイルまで下にスクロールし、[ 設定] を選択します。
- このサイトでは、Messenger の設定がアプリに追加され、設定ページが表示されます。
ページを追加してトークンを生成する
[ Messenger] で [ 設定] を選択します。
[ アクセス トークン ] まで下にスクロールし、[ ページの追加と削除] を選択します。
- Messenger に関連付ける ID の入力を求められたら、現在のアカウントを続行するか、別のアカウントにサインインします。
- アプリで使用するページの入力を求められたら、ページを選択し、[ 次へ] を選択します。
- ログイン レビューの要求を送信するように求められたら、情報を確認し、[ 完了] を選択します。
- 成功すると、サイトに成功ページが表示されます。 [OK] を選択して続行します。
追加したページが [ ページ ] リストに表示されます。
後で使用できるようにページ ID をコピーして保存します。
ページの [トークンの生成 ] を選択します。
- サイトにはセキュリティ情報が表示され、トークンをコピーする機会が与えられます。
- 警告を読み取って確認します。
- トークンをコピーし、[ 完了] を選択します。
これで、アプリ情報と次の手順のトークンが作成されました。 Facebook 設定の手順は保留中のままにします。 後で更新します。
Azure でボットを構成する
ボットがメッセージやその他のイベントを Facebook Messenger に送信できるようにするには、Webhook の統合を有効にします。
- 新しいブラウザー ウィンドウで、 Azure portal に移動します。
- ボットの Azure Bot リソース ブレードを開きます。
- [チャネル] を開き、[Facebook] を選択します。
- [ Facebook チャネルの構成] で、前の手順でコピーした Facebook 情報を入力します。
- Facebook アプリ ID と Facebook アプリ シークレットを入力します。
- ページ ID とアクセス トークンを入力します。
- 生成された コールバック URL を コピーし、トークン値を 確認 します。
- [] を選択し、[] を追加します。
ヒント
- 前の手順での情報のコピーを持っていない場合は、Meta for Developers サイトから情報を取得できます。
- 必要に応じて、ページの新しい Web トークンを作成します。 手順については、「 ページの追加とトークンの生成」を参照してください。
Webhook を有効にする
Facebook の設定に戻り、構成プロセスを完了します。
- Meta for Developers サイトで、アプリの Messenger 設定ページに戻ります。
- 結果のウィンドウで、 Webhooks セクションまで下にスクロールし、[ コールバック URL の追加] を選択します。
- [ コールバック URL の編集] ページで、次の手順を実行します。
- コールバック URL を入力し、Azure portal からコピーしたトークン値を確認します。
- [Verify and save] を選択します。
- 追加したページは、WebhooksのPagesリストに表示されます。
- ページ の [サブスクリプションの追加] を選択します。
- [ Edit page subscriptions]\(ページサブスクリプションの編集\) ページで、次のサブスクリプション フィールドを選択します。
- メッセージ
- Messaging_postbacks
- messaging_options
- message_deliveries
- 保存 を選択します。
- [ Edit page subscriptions]\(ページサブスクリプションの編集\) ページで、次のサブスクリプション フィールドを選択します。
- サイトには、ボットのページの横に追加されたサブスクリプション フィールドが表示されます。
アプリをパブリックにする
アプリが発行されるまでは、 開発モードになります。 プラグインと API の機能は、管理者、開発者、テスト担当者にのみ機能します。
ボットの応答を取得できるのは、作成者 (ページとボットを作成した Facebook Dev アカウント) だけです。 通常の Facebook ユーザーは、ページやボットを表示できません。 ボットとチャットできるように、ターゲット ユーザーに開発ロールまたはテスト ロールを付与します。
テスターロールに追加するユーザーは、まず Meta for Developers サイトに登録する必要があります。 Meta for Developers アカウントを持たない Facebook ユーザーは、テスター ロールを使用できません。 アプリロールとテスト ユーザーの詳細については、 Meta for Developers 開発者向けドキュメントを参照してください。
レビュー用に送信する
Facebook では、基本的なアプリ設定ページにプライバシー ポリシーの URL とサービス利用規約の URL が必要です。 [ 倫理規定] ページには、プライバシー ポリシーの作成に役立つサード パーティのリソース リンクが含まれています。 [使用条件] ページには、適切なサービス条件ドキュメントの作成に役立つサンプル用語が含まれています。
ボットが完了すると、Facebook には Messenger に発行されたアプリに対する独自の レビュー プロセス があります。 ボットは、Facebook の プラットフォーム ポリシーに準拠していることを確認するためにテストされます。
アプリを公開し、ページを公開する
レビューが成功したら、アプリ ダッシュボードの [アプリ レビュー] でアプリを [パブリック] に設定します。 このボットに関連付けられている Facebook ページが公開されていることを確認します。 [ページ] 設定に状態が表示されます。
API のバージョンを設定する
Graph API の特定のバージョンの廃止に関する通知を Facebook から受け取った場合:
- Meta for Developers に移動します。
- ボット用に作成したアプリに移動します。
- [ 設定] で、[詳細設定] を選択 します。
- [ API バージョンのアップグレード] を選択し、[ すべての呼び出しのアップグレード ] をバージョン 4.0 に切り替えます。
「Facebook でボットをテストする」セクションで説明されている手順に従って、接続をテストします。
Facebook でボットをテストする
新しい Facebook アプリに関連付けた Facebook ページを介してメッセージを送信することで、ボットが Facebook に正しく接続されているかどうかをテストできるようになりました。
- Facebook に移動し、ページのプロファイルに切り替えます。
- その他のアクション (...) を選択し、[ アクションの追加] ボタンを選択します。
- [ アクションのカスタマイズ] ボタン ダイアログで、[ 試してみる ] を選択し、指示に従います。
- [ アクション ボタン ] ページの [ ユーザーに連絡を取る] で、[ メッセージの送信] を選択します。
- [ 次へ] を選択し、ダイアログを完了して変更を保存します。
- 個人用プロファイルに戻ります。
- ページに移動し、[ メッセージ ] を選択してボットへの接続をテストします。
前の手順で説明したのと同じ値を appsettings.json ファイルに入力することで、Facebook アダプター用のサンプル ボットを使用してこの機能をテストすることもできます。
追加情報
Facebook Messenger 通信をサポートするサンプル ボットについては、Bot Framework C# Facebook イベントのサンプル を参照してください。
Facebook Messenger のドキュメントについては、次を参照してください。
Facebook Workplace のドキュメントについては、次を参照してください。