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>
    範例 — 已編碼的重新導向 URI，可能會附加在 redirect_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。請參閱 iframe 文件中的實作指南和訊息後規格。

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 通知。

瞭解詳情