Facebook にボットを接続する

  • [アーティクル]

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 を有効にしてから、ボットをページに接続します。

アプリを作成する

  1. Meta for Developers アカウントにサインインします。
  2. [新しい Facebook アプリの作成] に移動します。
  3. [アプリの種類の選択] ページで、[ビジネス] を選択し、[次へ] を選択します。
  4. [基本情報の指定] ページで、アプリの名前を入力し、[アプリの作成] を選択します。
    • メッセージが表示されたら、パスワードを入力し、[送信] を選択してアプリを作成します。
    • アプリが作成されると、サイトはアプリのページに移動します。
  5. [設定] を展開し、[基本] を選択します。
    1. [アプリ ID] と [アプリ シークレット] をコピーして保存します。
  6. [設定] で [詳細設定] を選択します。
    1. 結果のウィンドウで、[セキュリティ] 設定まで下にスクロールし、[アプリ設定への API アクセスを許可する] を有効にします。
    2. [変更の保存] を選択します。

Messenger を有効にする

  1. ダッシュボードを選択します。
  2. 結果のウィンドウで、[Messenger] タイルまで下にスクロールし、[設定] を選択します。
  3. このサイトでは、Messenger の設定がアプリに追加され、設定ページが表示されます。

ページを追加してトークンを生成する

  1. [Messenger] で、[設定] を選択します。

  2. [アクセス トークン] まで下にスクロールし、[ページの追加と削除] を選択します。

    1. Messenger に関連付ける ID の入力を求められたら、現在のアカウントを続行するか、別のアカウントにサインインします。
    2. アプリで使用するページの入力を求められたら、ページを選択し、[次へ] を選択します。
    3. ログイン レビューの要求を送信するように求められたら、情報を確認し、[完了] を選択します。
    4. 成功すると、サイトに成功ページが表示されます。 OK を選択して続行します。

  3. 追加したページが [ページ] リストに表示されます。

    後で使用できるようにページ ID をコピーして保存します。

  4. ページの [トークンの生成] を選択します。

    1. サイトにはセキュリティ情報が表示され、トークンをコピーする機会が与えられます。
    2. 警告を読み取って確認します。
    3. トークンをコピーし、[完了] を選択します。

これで、アプリ情報と次の手順のトークンが作成されました。 Facebook 設定の手順は保留中のままにします。 これらは後で更新します。

Azure のボットを構成します。

ボットがメッセージやその他のイベントを Facebook Messenger に送信できるようにするには、Webhook の統合を有効にします。

  1. 新しい Web ブラウザー ウィンドウで、Azure portal に移動します。
  2. ボットの [Azure Bot リソース] ブレードを開きます。
  3. [チャネル] を開き、[Facebook] を選択します。
  4. [Facebook チャネル]構成] で、前の手順でコピーした Facebook 情報を入力します。
    1. Facebook アプリ ID と Facebook アプリ シークレットを入力します。
    2. ページ ID とアクセス トークンを入力します。
    3. 生成されたコールバック URL をコピーし、トークン値を確認します。
    4. [追加] を選択します。

ヒント

  • 前の手順の情報のコピーがない場合は、Meta for Developers サイトの情報を取得できます。
  • 必要に応じて、ページの新しい Web トークンを作成します。 手順については、「ページを追加してトークンを生成する」を参照してください。

Webhook を有効にする

Facebook の設定に戻り、構成プロセスを完了します。

  1. Meta for Developers サイトで、アプリの Messenger 設定ページに戻ります。
  2. 結果のウィンドウで、[Webhooks] セクションまで下にスクロールし、[コールバック URL の追加] を選択します。
  3. [コールバック URL の編集] ページで、次の手順を実行します。
    1. コールバック URL を入力し、Azure portal からコピーしたトークン値を確認します。
    2. [Verify and save] を選択します。
  4. 追加したページが、[Webhook] にある [ページ] リストに表示されます。
  5. そのページで、[サブスクリプションの追加] を選択します。
    1. [ページのサブスクリプションの編集] ページで、次のサブスクリプション フィールドを選択します。
      • messages
      • Messaging_postbacks
      • messaging_options
      • message_deliveries
    2. [保存] を選択します。
  6. サイトには、ボットのページの横に追加されたサブスクリプション フィールドが表示されます。

アプリの公開

アプリが発行されるまでは、開発モード段階です。 プラグインと API の機能は、管理者、開発者、およびテスターのみが使用できます。

ボットの応答を取得できるのは、作成者 (ページとボットを作成した Facebook Dev アカウント) だけです。 通常の Facebook ユーザーは、ページやボットを表示できません。 ボットとチャットできるように、ターゲット ユーザーに開発ロールまたはテスト ロールを付与します。

テスターロールに追加するユーザーは、まず Meta for Developers サイトに登録する必要があります。 Meta for Developers アカウントを持たない Facebook ユーザーは、テスター ロールを使用できません。 アプリロールとテスト ユーザーの詳細については、「Meta for Developers 開発者向けドキュメント」を参照してください。

レビュー用に送信

Facebook には、基本アプリ設定ページの [Privacy Policy URL]\(プライバシー ポリシーの URL\) と [ Terms of Service URL]\(利用規約の URL\) が必要です。 [Code of Conduct]\(行動規範\) ページには、プライバシー ポリシーを作成するためのサード パーティのリソース リンクがあります。 [Terms of Use]\(利用規約\) ページには、適切な利用規約を作成するために役立つサンプルの規約が掲載されています。

ボットが完了した後、Facebook には、Messenger に発行されたアプリの独自のレビュー処理があります。 ボットは Facebook のプラットフォーム ポリシーに準拠していることを確認するためにテストされます。

アプリを公開してページを公開する

レビューが正常に完了したら、[App Dashboard]\(アプリ ダッシュボード\) の [App Review]\(アプリ レビュー\) でアプリを [Public]\(パブリック\) に設定します。 このボットに関連付けられた Facebook ページが発行されていることを確認します。 [Pages settings]\(ページ設定\) に状態が表示されます。

API のバージョンの設定

特定のバージョンの Graph API の廃止に関する Facebook からの通知を受け取った場合:

  1. [Meta for Developers] に移動します。
  2. ボット用に作成したアプリに移動します。
  3. [設定] で [詳細設定] を選択します。
  4. [API バージョンのアップグレード] を選択し、[すべての呼び出しのアップグレード] をバージョン 4.0 に切り替えます。

「Facebook でボットをテストする」セクションで説明されている手順に従って、接続をテストします。

Facebook でボットをテストする

新しい Facebook アプリに関連付けた Facebook ページ経由でメッセージを送信して、自分のボットが Facebook に正しく接続されているかどうかをテストしてみましょう。

  1. Facebook に移動し、ページのプロファイルに切り替えます。
  2. その他のアクション (...) を選択し、[動作設定ボタンの追加] ボタンを 選択します。
    1. [アクションのカスタマイズ] ボタン ダイアログで、[試してみる] を選択し、指示に従います。
    2. [アクション ボタン] ページの [ユーザーに連絡を取る] で、[メッセージの送信] を選択します。
    3. [次へ] を選択し、ダイアログを完了して変更を保存します。
  3. 個人用プロファイルに戻ります。
  4. ページに移動し、[メッセージ] を選択してボットへの接続をテストします。

前の手順で説明したのと同じ値を appsettings.json ファイルに設定することで、Facebook アダプターのサンプル ボットを使用してこの機能をテストすることもできます。

追加情報

Facebook Messenger 通信をサポートするサンプル ボットについては、Bot Framework C# Facebook イベントのサンプル を参照してください。

Facebook Messenger のドキュメントについては、次を参照してください。

Facebook Workplace のドキュメントについては、次を参照してください。