Meta Business 擴充功能

商業應用程式驗證


商業應用程式適用於各個 Facebook 平台，小型企業可以在此探索並連結至第三方商業應用程式，以低廉的技術成本完成商業工具設定，從而發展和實現其業務目標。


與企業登入不同，商業應用程式流程是從我們的平台中啟動，因此您還需要執行一個額外步驟，要求用戶透過彈出式瀏覽器登入您的平台，從而執行驗證並選擇需要建立連結的企業（由您定義的 external_business_id 識別）。成功驗證後，系統會將用戶重新導向此流程完成建立服務程序。

如果您希望在我們的商業應用程式平台上展示您的應用程式，您需要建立一個驗證網址和 Webhook 端點，並透過開發人員面板設定和驗證。

所有應用程式都必須申請整合工具審查。您的 FBE 整合工具獲批准後，應用程式即可公開供一般用戶使用。

備註：企業登入可以是商業應用程式驗證的替代方式。參閱有關如何使用企業登入的文件。

驗證網址安裝

商業應用程式會在 Facebook 專頁平台、Instagram和 Facebook Business Suite 內啟動類似企業登入的流程。如要啟用此流程並在其中列出您的應用程式，您必須提供一個自訂驗證用戶介面，以供用戶在您的網站中選擇其企業，然後重新導向 Facebook、Instagram 或 Facebook Business Suite 流程。

運作方式

  1. 提供一個自訂網址端點（驗證網址）來載入平台的驗證流程。
    • 您的驗證網址應將用戶（公司負責人）帶往您平台的登入流程。
    • 提供選項讓用戶在您的平台註冊新帳戶（例如「註冊」）。完成註冊後，系統應該會將用戶導向 Facebook，以完成帳戶連結。
    • 如果您的平台支援每個帳戶擁有多間企業，則在用戶成功登入後，系統會在用戶介面顯示驗證網址，以便對方選擇將您平台上的哪間企業關聯至其 Facebook 資產。
    範例—驗證網址 
    https://yourwebsite.com/fbe-auth
  2. 在建立服務流程期間，Facebook 會載入您提供的驗證網址，並在網址結尾附上 redirect_uri 查詢參數（此為一個重新導向 URI，其中可能包含其他查詢參數）： 
    https://yourwebsite.com/fbe-auth?redirect_uri=<an_encoded_redirect_uri_with_query_params>
    範例—可能附在 redirect_uri 查詢參數的已編碼重新導向 URI： 
    https://www.facebook.com/local/dev/transaction_tool_selector/redirect?app_id=<int_value>&app_name=<string_value>&page_id=<int_value>
    在此步驟最後，Facebook 會載入您提供的驗證網址，以及網址附上的 redirect_uri 已編碼查詢參數，如下所示： 
    https://yourwebsite.com/fbe-auth?redirect_uri=https%3A%2F%2Fwww.facebook.com%2Flocal%2Fdev%2Ftransaction_tool_selector%2Fredirect%3Fapp_id%3D123%26app_name%3DSample%26page_id%3D456

    重要注意事項：為了確保您不會與其他方分享任何用戶數據，請僅在 redirect_uri 與以下規則運算式相符時重新導向此網址：

    https?:\/\/(www\.|m\.|l\.|web\.|business\.)?(\d{4,5}\.od\.)?(business\.)?(facebook|instagram|whatsapp)\.com(\/.*)?
  3. 用戶完成登入或註冊流程並在您的平台選擇企業（如適用）後，將對方重新導向 redirect_uri 中的網址，此時該網址附加了已編碼的 extras 物件以作為查詢參數（與「企業登入」所用的相同），並在其中定義了 business_config 和 setup（取決於您想執行的建立服務配置）： 
    https://www.facebook.com/local/dev/transaction_tool_selector/redirect?app_id=<int_value>&app_name=<string_value>&page_id=<int_value>&extras=<an_encoded_json_string>

備註：當您需要在驗證網址中為在平台提供建立新帳戶選項時，請確保所顯示的用戶介面滿足以下條件：1）適用手機操作／回應靈敏；及／或 2）高度和闊度足以正確顯示合作夥伴的註冊流程（建議介面尺寸不少於 600 x 600 像素）。

iframe 驗證

為了使商業應用程式的用戶體驗更順暢，以及更妥善支援在您平台建立新帳戶的流程，您應啟用自家驗證網址，以在 Facebook 平台載入一個 iframe。參閱 iframes 文件中的安裝指引和 post-message 規格。

Webhook 安裝

Webhooks 可以讓您收取 Facebook 社交關係圖內特定物件相關變更的即時 HTTP 通知。對於 FBE 而言，這代表用戶使用您的應用程式（例如透過商業應用程式）安裝或解除安裝 FBE 後，您將透過 Webhooks 收到該動作的詳情。

您應在安全且能處理 Facebook 要求的伺服器上建立端點。想在商業應用程式上展示自己應用程式的所有平台合作夥伴，都必須執行此動作。請參閱 Webhook 安裝指南進一步了解如何建立此端點。

Webhook 設定和驗證

Webhook 端點準備就緒後，其設定和驗證要求您完成下列動作：

  1. 使用 Facebook Business 擴充功能中的 Webhooks 資訊卡 -> 應用程式管理中心的「設定」區塊以驗證該端點，並訂閱 fbe_install Webhook。請參閱 Webhook 安裝指南以了解詳情。
  2. 正確配置 Webhooks 產品後，資訊卡右上方的圓圈應該會變綠色並顯示剔號圖示。

透過開發人員面板設定和驗證

Facebook Business 擴充功能開發人員面板是開發人員應用程式管理中心內的產品。您的應用程式獲批 FBE 功能後，您應該使用開發人員面板設定並驗證您的驗證網址、Webhook 端點，同時詳細描述您的應用程式能為企業提供哪些服務。

驗證網址設定和驗證

驗證網址準備就緒後，其設定和驗證要求您完成下列動作：

  1. 前往應用程式管理中心內的 FBE 開發人員面板。備註：如果您仍未完成配置，請按照這些指示加入相關配置。
  2. 點擊「設定」分頁，然後找出商業應用程式平台資訊卡。
  3. 勾選「在商業應用程式平台上顯示我的應用程式」選框。
  4. 在「驗證網址」輸入欄位輸入驗證網址。
  5. 點擊「測試驗證」按鈕。
    • 畫面會開啟彈出視窗並載入您的網址，以模仿 Facebook 在商業應用程式平台上使用該網址的方式。
    • 繼續執行登入和企業選擇程序（如適用）。
    • 重新導向後，彈出視窗會關閉。如果安裝程序有誤（如 extras 的值無效），這些錯誤將在此資訊卡底部展示，以便您查看需要解決的問題。測試驗證功能只會驗證 redirect_uri 的輸入內容，並不會安裝 FBE。
  6. 所有安裝步驟和 extras 配置如期完成後，系統會將此步驟標記為有效（資訊卡右上角的綠色剔號）。這樣您就能直接從 Facebook 為此建立服務流程（安裝 FBE）執行端對端測試（請參閱下方部分）。

端對端測試

在開發人員面板成功設定您的驗證網址和 Webhook 端點後，您便可以在發佈應用程式前，執行建立服務流程端對端測試。該測試由您的應用程式支援。此操作可直接在 Facebook Business Suite 或 Facebook 專頁平台完成，方法如下：

透過 Facebook Business Suite 操作

  1. 前往 Facebook Business Suite。
  2. 在左側滑軌，點擊「更多工具」，然後點擊「商業應用程式」。
  3. 所有可用應用程式都在此處列出。根據您在「開發人員面板設定」分頁中選擇的行業，您的應用程式將在相應類別下列出。
  4. 您的應用程式將帶有「僅供測試 - 並非公開」標籤。這代表應用程式只限擁有應用程式角色的用戶作測試用途，尚未向一般用戶推出。
  5. 點擊「連結」開始測試由您驗證網址提供的體驗：
    • 建立服務流程會執行真正的 FBE 安裝，並觸發 Webhook 通知。

透過 Facebook 專頁平台操作

  1. 前往您擁有管理員存取權限的 Facebook 專頁。
  2. 在 Facebook 專頁左側滑軌上，點擊「商業應用程式」。
  3. 所有可用應用程式都在此處列出。根據您在「開發人員面板設定」分頁中選擇的行業，您的應用程式將在相應類別下列出。
  4. 您的應用程式將帶有「僅供測試 - 並非公開」標籤。這代表應用程式只限擁有應用程式角色的用戶作測試用途，尚未向一般用戶推出。
  5. 點擊「連結」開始測試由您驗證網址提供的體驗：
    • 建立服務流程會執行真正的 FBE 安裝，並觸發 Webhook 通知。

進一步了解以下主題