登入開始免費試用
easyCoexistence 官方 API

將 Facebook Page 訂閱 Webhook:subscribed_apps 端點

Facebook Page 須以 POST /{page-id}/subscribed_apps 訂閱應用程式的 Webhook,並傳入 subscribed_fields(例如 feed,messages),同時使用擁有 CREATE_CONTENT、MANAGE 或 MODERATE 任務者的 Page 存取權杖,且已獲授 pages_manage_metadata 與 pages_show_list 權限。只有應用程式也訂閱某欄位,Meta 才會傳送該欄位的事件;GET 可列出訂閱,DELETE 則可移除。

easyCoexistence 會透過 subscribed_apps 為您連接的每個 Page 訂閱 feed、messages 及 mention,移除時再取消訂閱,並透過單一 MCP 連接器或 Partner API,以該 Page 專用的密鑰簽署後,將事件轉發至您的 HTTPS 端點。

Both levels

只有同時在 Page 與應用程式層級訂閱的欄位,才會產生 Webhook;Page 的訂閱欄位可以多於應用程式。

CREATE_CONTENT, MANAGE or MODERATE

Page 任務:持有權杖者須具備其中一項任務,方可讀取或建立訂閱。

messaging_success

應用程式以 DELETE 移除 Webhook 訂閱時,會與 success 一併返回 messaging_success。

App access token

讀取、建立或刪除應用程式層級訂閱時,/{app-id}/subscriptions 所需的條件。

1 hour

Messenger 傳送失敗持續一小時後,Meta 會取消應用程式與 Page 的訂閱,直至應用程式重新訂閱為止。

subscribed_apps 端點有什麼作用?

它會在 Page 上安裝應用程式,並設定應用程式接收 Page 的哪些 Webhook 欄位。只有當 Page 已安裝應用程式,且未在設定中停用應用程式平台,Meta 才會發出通知;而且只限於同時在 Page 層級(透過此端點)與應用程式層級(在 App Dashboard 或透過 /{app-id}/subscriptions 設定)訂閱的欄位。Page 訂閱的欄位可以多於應用程式。

如何為 Page 訂閱?

向該端點發出 POST 請求,以逗號分隔列出 subscribed_fields 欄位,並附上 Page 的存取權杖。成功時會返回 success true。若列出 messages,權杖還需具備 pages_messaging 權限:

Subscribing a Page to three fields
POST https://graph.facebook.com/{page-id}/subscribed_apps
  ?subscribed_fields=feed,messages,mention
  &access_token=<PAGE_ACCESS_TOKEN>

{ "success": true }

需要哪些權杖、任務與權限?

須使用 Page 存取權杖,它與單一 Page 綁定,且持有人須能代表該 Page 行事。Meta 的參考文件與指南訂明以下要求:

  • 任何欄位:持有人須具備 CREATE_CONTENT、MANAGE 或 MODERATE 任務,並具備 pages_manage_metadata 與 pages_show_list 權限。
  • messages 及其他 Messenger 欄位:另須具備 pages_messaging,且權杖持有人須能執行 MESSAGING 任務。
  • leadgen:須具備 ADVERTISE 任務,以及 leads_retrieval、pages_read_engagement 與 ads_management 權限。
  • 以 GET 讀取訂閱所需的任務與權限,與建立訂閱相同。

欄位需要哪種存取級別?

需要 Advanced Access,供應用程式角色以外的 Page 與人士使用。若只有 Standard Access,Messenger 通知只會來自應用程式角色持有人,例如管理員、開發者及測試人員;Advanced Access 須透過 App Review 逐項權限授權,並須完成 Business Verification,才能讓應用程式的客戶收到通知。Meta 的 Messenger 指南亦將發布應用程式列為前提條件之一。

什麼是應用程式層級訂閱?

這是另一半:應用程式本身監聽的欄位,連同其回呼 URL。它可在 App Dashboard 設定,亦可使用應用程式存取權杖,以 POST /{app-id}/subscriptions 設定,傳入 object=page、callback_url、fields、include_values 與 verify_token,並會觸發 Meta 的驗證請求。對同一端點使用 GET,可查看每個 object 的 callback_url、fields 及訂閱是否已啟用;新的 POST 會修改欄位而不覆寫其他欄位;DELETE 則會移除全部,或移除指定的欄位。

如何查看 Page 訂閱了什麼?

使用同一端點的 GET 請求,並附上 Page 的權杖。data 陣列會列出 Page 已安裝的每個應用程式,包括其名稱、ID 及 subscribed_fields;若 Page 未安裝任何應用程式,則返回空陣列:

Reading a Page's subscriptions
GET https://graph.facebook.com/{page-id}/subscribed_apps
  ?access_token=<PAGE_ACCESS_TOKEN>

{
  "data": [
    {
      "category": "Business",
      "link": "https://example.com/app",
      "name": "<APP_NAME>",
      "id": "<APP_ID>",
      "subscribed_fields": ["feed", "messages", "mention"]
    }
  ]
}

如何移除訂閱?

使用 DELETE /{page-id}/subscribed_apps,即可解除應用程式與 Page 的關聯。應用程式可使用應用程式存取權杖移除自身的訂閱,回應中會包含 success 與 messaging_success。Meta 亦會自行移除訂閱:Messenger 傳送失敗持續一小時後,應用程式會被取消與 Page 的訂閱,須待其端點恢復正常後重新訂閱。

easyCoexistence 在連接時會做什麼?

您所選的每個 Page,會在儲存該 Page 的權杖後隨即訂閱:以 POST /{page-id}/subscribed_apps 傳入 subscribed_fields 為 feed,messages,mention。若 Meta 拒絕,該 Page 仍保持連接,list_social_accounts 會在 last_error 中顯示原因。移除 Page 時,會先送出 DELETE /{page-id}/subscribed_apps,然後才捨棄權杖;沒有任何工具能存取 subscribed_apps 與權杖路徑,因此訂閱只由 easyCoexistence 管理。

常見錯誤

  • 以用戶存取權杖呼叫該端點。它需要的是被訂閱 Page 的 Page 存取權杖。
  • 只訂閱 Page,未訂閱應用程式。欄位只有在應用程式本身的訂閱也包含該欄位時,才會送達回呼。
  • 訂閱 messages 時漏掉 pages_messaging。Meta 要求此權限,且權杖持有人須能執行 MESSAGING 任務。
  • 故障後忘記重新訂閱。Messenger 傳送失敗一小時後,應用程式會被取消訂閱,在重新發出 POST 之前,事件會停止送達。
使用 EasyCoexistence 完成這項設定

每個連接每月由 US$ 9 降至 US$ 0.75,連接越多單價越低,首 3 天免費試用。

常見問題

每個 Page 都要分別訂閱嗎?

是。subscribed_apps 以 Page 為單位,須使用該 Page 自己的權杖操作;而 object=page 的應用程式層級訂閱,則適用於已安裝該應用程式的 Page。

為什麼 subscribed_apps 會返回錯誤 200?

Meta 將此端點的 200 列為權限錯誤。請確認權杖具備 pages_manage_metadata 與 pages_show_list 權限,並且持有人具備 CREATE_CONTENT、MANAGE 或 MODERATE 任務。

可以在 Graph API Explorer 為 Page 訂閱嗎?

可以。Meta 的指南要求先選擇應用程式,取得具備 pages_manage_metadata 的用戶權杖,再換取該 Page 的權杖,然後向 {page-id}/subscribed_apps 發出 POST 請求。

可以為連接到 easyCoexistence 的 Page 加入 Webhook 欄位嗎?

不能透過其工具操作。沒有任何工具能存取 subscribed_apps 路徑,而該 Page 仍會保持訂閱 feed、messages 與 mention,即 easyCoexistence 轉發的欄位。

繼續閱讀

兩分鐘內連接您的第一個頻道。

無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。

  • 免費試用 3 天
  • 隨時取消
  • 只用官方 API
  • 24/7 監察

驗證日期