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

Facebook 專頁 Webhook 欄位:完整清單

Meta 的專頁 Webhook 參考文件列出 64 個訂閱欄位:feed 涵蓋帖文、留言及反應;mention 涵蓋提及專頁的內容;Messenger 欄位包括 messages、message_echoes、messaging_postbacks 及 message_reads;資料欄位包括 name、picture、hours 及 website。每個欄位都需要 pages_manage_metadata,應用程式須在應用程式層面及由專頁透過 subscribed_apps 同時訂閱,才會收到某欄位。

easyCoexistence 為您連接的每個專頁訂閱 feed、messages 及 mention,並將這些事件在到達時轉發至您的 HTTPS 端點,以 X-EC-Signature 簽署;留言規則及自動化功能則根據新留言及訊息運作。

64

Meta 專頁 Webhook 參考文件列明的訂閱欄位,由 feed 及 mention 至 Messenger 及資料欄位。

pages_manage_metadata

專頁管理員須具備 MODERATE 權限並授權,專頁 Webhook 才會送達應用程式。

message_echoes

獨立的 Messenger 欄位,用於專頁所發出的訊息,僅適用於 Messenger 對話。

ADVERTISE

訂閱 leadgen 所需的專頁任務,包括 leads_retrieval、ads_management、pages_read_engagement 及 pages_manage_metadata。

Both levels

只有在專頁及應用程式兩個層面同時訂閱的欄位,才會產生 Webhook。

專頁 Webhook 欄位如何分類?

Meta 將這些欄位集中列於專頁物件的同一份參考文件,並分為三類:專頁及其周邊的活動、Messenger 對話,以及專頁本身資料的修改。feed、mention 及資料變更會在 entry.changes 中送達,每項均註明欄位名稱;若應用程式關閉了 Include Values,則以 changed_fields 送達。Messenger 事件則在 entry.messaging 中送達,若應用程式並不擁有該對話,則在 entry.standby 中送達。

哪些欄位報告專頁的活動?

共有十二個欄位涵蓋內容及活動,而非對話。例如,新留言會以 feed 的變更送達,其 item 設為 comment,verb 設為 add,與反應、分享及專頁自身發布的帖文一併列出。各欄位送達的內容如下,見 Meta 參考文件:

feedNearly all changes to the Page's feed: posts, comments, reactions, shares; likes only below 10,000 likes
mentionNew mentions of the Page in posts and comments; some IDs it returns cannot be queried
ratingsNew ratings, and comments or reactions on a rating
videosChanges to the encoding status of a video on the Page
live_videosChanges to a live video's status, with its ID
leadgenNew leads from the Page's lead ads, with leadgen_id, form_id and ad_id
group_feedComments on the Page's posts in the business's Facebook Group
product_reviewA product item's review status: pending, approved, rejected or outdated
inbox_labelsLabel changes on people in the Page inbox: the user, the action and the label
page_upcoming_changeUpcoming changes to the Page, with their type and effective time
page_change_proposalProposals to change the Page, created, accepted or rejected
invoice_access_invoice_draft_changeChanges to an invoice draft, such as its shipping address

哪些欄位傳送 Messenger 事件?

Messenger 的欄位最多,Meta 的 Messenger Webhook 指南列明各欄位傳送的內容。以下十三個欄位涵蓋專頁的對話;至於 standby(會將訊息傳送至不擁有該對話的應用程式),則記載於該指南,而非專頁參考文件:

messagesA message from a person, through any entry point, with text or attachments
message_echoesA message the Page sent, with the app_id of the app that sent it
message_deliveriesA message from the Page was delivered
message_readsThe person read a message from the Page
message_reactionsThe person reacted to a message from the Page
message_editsThe person edited a message they had sent
messaging_postbacksA tap on a postback button, Get Started or a persistent menu item
messaging_referralsThe person came back to the conversation through an m.me link or an ad
messaging_optinsA Messenger plugin click, an accepted message request or a checkbox opt-in
messaging_handoversThread control passed, taken or requested between apps
messaging_policy_enforcementA policy warning, block or unblock on the Page's messaging
messaging_account_linkingThe person linked or unlinked their account with the business
response_feedbackFeedback buttons, such as thumbs up or down, on a message the Page sent

還有哪些 Messenger 欄位?

另外十個欄位服務於特定產品,涵蓋通話、電商及誠信回報:

  • send_cart:載有購物車或訂單資料的訊息;message_context:Meta 模型對某則訊息所作的偵測,附事件名稱及分數。
  • calls、call_settings_update 及 call_permission_reply:Messenger 語音通話、專頁通話設定的變更,以及用戶對通話權限請求的回覆。
  • messaging_customer_information:用戶在客戶資料頁面填寫的內容;messaging_in_thread_lead_form_submit:在對話內提交的潛在客戶表格。
  • message_template_status_update:實用類訊息範本的審核狀態已變更。
  • business_integrity 及 messaging_integrity:誠信更新,其中 business_integrity 包括違規、限制及行動事件。

哪些欄位報告專頁資料的變更?

共有二十九個欄位報告專頁本身資料的修改,每項資料對應一個欄位,各自以註明該欄位名稱的變更送達:

  • 身份:name、picture、category(最多三個類別)及 description,即故事描述(Story Description)。
  • 業務資料:company_overview、mission、founded、products、general_info、general_manager、members、awards 及 affiliation。
  • 聯絡及位置:email、phone、website、location、hours、current_location、hometown、parking 及 public_transit。
  • 場所:price_range、payment_options、attire 及 culinary_team。
  • 個人資料:birthday、personal_info 及 personal_interests。

每個欄位需要哪項權限?

所有欄位均需 pages_manage_metadata,須由具備 MODERATE 權限的專頁管理員授權,部分欄位還需其他權限。專頁透過 subscribed_apps 完成訂閱,Meta 的指南則按欄位類別訂明存取權杖及權限;若要接收應用程式角色以外人士的事件,有關權限還須具備 Advanced Access:

PermissionsTask of the person behind the token
Any fieldpages_manage_metadata and pages_show_listCREATE_CONTENT, MANAGE or MODERATE
messages and other Messenger fieldspages_messaging as wellMESSAGING
leadgenleads_retrieval, pages_read_engagement and ads_management as wellADVERTISE

easyCoexistence 訂閱哪些欄位?

共有三個:feed、messages 及 mention。專頁連接時,easyCoexistence 會以該三個欄位及專頁的存取權杖發送 POST /{page-id}/subscribed_apps,然後將該專頁的每筆 entry 轉發至您設定的端點,並以 X-EC-Signature 簽署。留言規則及自動化功能會根據 feed 的新留言及 messages 運作,mention 則原樣轉發。其他欄位均不訂閱,因此 message_echoes、messaging_postbacks、讀取回條、對話交接、standby 及資料變更均不會被轉發。

常見錯誤

  • 向專頁訂閱應用程式未訂閱的欄位。Meta 只會送達在專頁及應用程式兩個層面同時訂閱的欄位。
  • 將 Messenger 事件當作變更解析。這些事件在 entry.messaging 中送達,每個 entry 只含一個 messaging 物件,而非位於 entry.changes。
  • 以為會收到專頁本身的回覆訊息。專頁發出的訊息會在 message_echoes 送達,這是另一個獨立欄位。
  • 在大型專頁依賴 feed 取得讚好通知。Meta 只為讚好數少於 10,000 的專頁發送讚好通知。
使用 EasyCoexistence 完成這項設定

每個連接每月 US$ 9 起,連接越多越便宜,最低降至 US$ 0.75,並提供前 3 天免費試用。

常見問題

feed 欄位是否包括廣告的留言?

包括。Meta 不會就廣告帖文本身發送任何內容,但廣告帖文的留言會在 feed 中送達。

Include Values 設定有何作用?

開啟時,變更會在 changes 中附有新的數值。關閉時,Meta 只會送出已變更欄位的名稱,列於 changed_fields 內。

如何查看專頁訂閱了哪些欄位?

使用專頁的存取權杖發送 GET /{page-id}/subscribed_apps,會列出專頁已安裝的應用程式,以及每個應用程式的 subscribed_fields。

easyCoexistence 會轉發專頁資料的變更嗎?

不會。連接 easyCoexistence 的專頁只訂閱 feed、messages 及 mention,因此名稱、圖片及其他資料欄位均不會被轉發。

繼續閱讀

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

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

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

驗證日期