將 Bot 連線至 Facebook

  • 發行項

您可以將 Bot 設定為透過 Facebook Messenger 或 Facebook Workplace 與人員通訊。 本文說明如何使用 Meta for Developers 網站建立 Facebook 應用程式、將 Bot 連線至 Azure 中的 Facebook 應用程式，以及在 Facebook 上測試 Bot。

本文說明如何透過 Azure 入口網站 將 Facebook 頻道新增至 Bot。 如需如何使用自訂通道配接器的資訊，請參閱 其他資訊 。

必要條件

  • Azure 訂用帳戶。 如果您還沒有帳戶，請在開始之前建立 免費帳戶 。
  • 發佈至 Azure 的 Bot，您想要連線到 Facebook。
  • 適用于開發人員的 Facebook 帳戶。 如果您沒有帳戶，您可以在 developers.facebook.com 建立帳戶 。
  • 使用者從中存取 Bot 的 Facebook 頁面。 如果您還沒有新的頁面， 請建立新的頁面 。
  • 若要搭配 Bot 使用 Facebook Workplace，您必須建立 Workplace 帳戶和自訂整合，才能將 Bot 連線到。

建立 Facebook 應用程式

使用者將會從 Facebook 頁面存取您的 Bot。 若要連線 Bot，您會在 Facebook 頁面上啟用 Facebook Messenger，然後將 Bot 連線至頁面。

建立應用程式

  1. 登入您的 Meta for Developers 帳戶。
  2. 移至 建立新的 Facebook 應用程式 。
  3. 在 [ 選取應用程式類型 ] 頁面上，選取 [商務 ]，然後選取 [ 下一步 ]。
  4. 在 [ 提供基本資訊 ] 頁面上，輸入應用程式的名稱，然後選取 [ 建立應用程式 ]。
    • 如果出現提示，請輸入您的密碼，然後選取 [ 提交 ] 以建立您的應用程式。
    • 建立您的應用程式之後，網站會移至您應用程式的頁面。
  5. 展開 設定 ，然後選取 [ 基本 ]。
    1. 複製並儲存 應用程式識別碼 和 應用程式秘密 。
  6. 現在，在 [設定] 下 ，選取 [ 進階 ]。
    1. 在產生的窗格中，向下捲動至 [安全性 設定]，然後啟用 [允許 API 存取應用程式設定 ]。
    2. 選取儲存變更。

啟用 Messenger

  1. 選取儀表板。
  2. 在產生的窗格中，向下捲動至 Messenger 圖格，然後選取 [ 設定]。
  3. 網站會將 Messenger 設定新增至您的應用程式，並顯示設定頁面。

新增頁面並產生權杖

  1. 在 [Messenger] 下 ，選取 [設定 ]。

  2. 向下捲動至 [ 存取權杖 ]，然後選取 [ 新增或移除頁面 ]。

    1. 當系統提示您讓身分識別與 Messenger 產生關聯時，請繼續使用您目前的帳戶或登入另一個帳戶。
    2. 當系統提示您輸入要搭配應用程式使用的 Pages 時，請選取頁面，然後選取 [ 下一步 ]。
    3. 如果系統提示您提交登入檢閱要求，請檢閱資訊，然後選取 [ 完成 ]。
    4. 成功時，網站會顯示成功頁面。 選取確定以繼續。

  3. 您新增的頁面現在會出現在 [頁面 ] 清單中。

    複製並儲存頁面識別碼以供稍後使用。

  4. 選取 [產生頁面] 的權杖 。

    1. 網站會顯示安全性資訊，並讓您有機會複製權杖。
    2. 讀取並確認警告。
    3. 複製權杖，然後選取 [ 完成 ]。

您現在有下一個步驟的應用程式資訊和權杖。 讓 Facebook 設定步驟保持擱置。 您稍後會更新它們。

在 Azure 中設定 Bot

若要讓 Bot 將訊息和其他事件傳送至 Facebook Messenger，請啟用 Webhook 整合。

  1. 在新瀏覽器視窗中，移至 Azure 入口網站 。
  2. 開啟 Bot 的 [Azure Bot 資源] 刀鋒視窗。
  3. 開啟 [頻道] ，然後選取 [Facebook ]。
  4. 在 [ 設定 Facebook 通道 ] 中，輸入您在先前步驟中複製的 Facebook 資訊。
    1. 輸入您的 Facebook 應用程式識別碼 和 Facebook 應用程式秘密 。
    2. 輸入您的 頁面識別碼 和 存取權杖 。
    3. 複製產生的 回呼 URL 並 驗證權杖 值。
    4. 選取新增。

提示

  • 如果您沒有先前步驟中的資訊複本，您可以針對 Meta for Developers 網站擷取它。
  • 如果您需要，請為頁面建立新的 Web 權杖。 如需指示，請參閱 新增頁面並產生權杖 。

啟用 Webhook

返回 Facebook 設定以完成設定程式。

  1. 在 [適用于開發人員的 Meta] 網站上，返回您應用程式的 Messenger 設定頁面。
  2. 在產生的窗格中，向下捲動至 [Webhook] 區段，然後選取 [ 新增回呼 URL ]。
  3. 在 [ 編輯回呼 URL] 頁面上：
    1. 輸入回呼 URL，並確認您從Azure 入口網站複製的權杖值。
    2. 選取 [確認並儲存]。
  4. 您新增的頁面現在會出現在 [Webhook] 底下的 [頁面 ] 清單中。
  5. 選取 [新增頁面的訂用帳戶 ]。
    1. 在 [ 編輯頁面訂閱] 頁面上，選取下列訂用帳戶欄位：
      • messages
      • messaging_postbacks
      • messaging_options
      • message_deliveries
    2. 選取 [儲存]。
  6. 網站會顯示 Bot 頁面旁新增的訂用帳戶欄位。

讓您的應用程式公開

在發佈應用程式之前，它會處於 開發模式 。 外掛程式和 API 功能僅適用于系統管理員、開發人員和測試人員。

只有建立者（建立頁面和 Bot 的 Facebook 開發人員帳戶）才能取得 Bot 回應。 一般 Facebook 使用者看不到頁面或 Bot。 提供開發或測試角色給目標使用者，讓他們也可以與 Bot 聊天。

要新增至測試人員角色的使用者必須先在 Meta for Developers 網站上註冊。 沒有適用于開發人員帳戶的 Facebook 使用者無法使用測試人員角色。 如需應用程式角色和測試使用者的詳細資訊，請參閱 Meta for Developers 開發人員檔 。

提交以供檢閱

Facebook 在其基本應用程式設定頁面上需要隱私權原則 URL 和服務條款 URL。 [ 管理辦法] 頁面包含協力廠商資源連結，可協助建立隱私權原則。 [ 使用規定] 頁面包含範例字詞，可協助建立適當的服務條款檔。

Bot 完成之後，Facebook 會自行 檢閱 發佈至 Messenger 的應用程式。 Bot 將會經過測試，以確保其符合 Facebook 平臺原則 的規範。

讓應用程式公開併發布頁面

檢閱成功之後，在 [應用程式檢閱] 底下的 [應用程式儀表板] 中，將應用程式設定為 [公用]。 請確定已發佈與此 Bot 相關聯的 Facebook 頁面。 狀態會出現在 [頁面] 設定中。

設定 API 版本

如果您從 Facebook 收到有關特定圖形 API 版本淘汰的通知：

  1. 移至 適用于開發人員 的 Meta。
  2. 移至您為 Bot 建立的應用程式。
  3. 在 [設定] 底 下 ，選取 [ 進階 ]。
  4. 選取 [升級 API 版本 ]，然後切換 [ 將所有呼叫 升級至 4.0 版]。

遵循在 Facebook 中測試 Bot 一節中所述 的步驟來測試連線。

在 Facebook 中測試 Bot

您現在可以透過與您新 Facebook 應用程式相關聯的 Facebook 頁面傳送訊息，測試 Bot 是否已正確連線到 Facebook。

  1. 移至 Facebook 並切換至頁面的設定檔。
  2. 選取更多動作 （ ... ），然後 選取 [新增動作] 按鈕 。
    1. 在 [ 自訂動作] 按鈕 對話方塊中，選取 [ 試用] 並遵循指示。
    2. 在 [ 動作按鈕 ] 頁面的 [讓使用者連絡您 ] 底下 ，選取 [ 傳送訊息 ]。
    3. 選取 [ 下一步 ]，完成對話方塊並儲存變更。
  3. 切換回您的個人設定檔。
  4. 移至您的頁面，然後選取 [訊息 ] 以測試 Bot 的連線。

您也可以使用 Facebook 配接 器的範例 Bot 來測試這項功能，方法是將 appsettings.json 檔案填 入先前步驟中所述的相同值。

其他資訊

如需支援 Facebook Messenger 通訊的範例 Bot，請參閱 Bot Framework C# Facebook 事件範例 。

如需 Facebook Messenger 檔，請參閱：

如需 Facebook Workplace 檔，請參閱：