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 簽署;留言規則及自動化功能則根據新留言及訊息運作。
Meta 專頁 Webhook 參考文件列明的訂閱欄位,由 feed 及 mention 至 Messenger 及資料欄位。
專頁管理員須具備 MODERATE 權限並授權,專頁 Webhook 才會送達應用程式。
獨立的 Messenger 欄位,用於專頁所發出的訊息,僅適用於 Messenger 對話。
訂閱 leadgen 所需的專頁任務,包括 leads_retrieval、ads_management、pages_read_engagement 及 pages_manage_metadata。
只有在專頁及應用程式兩個層面同時訂閱的欄位,才會產生 Webhook。
專頁 Webhook 欄位如何分類?
Meta 將這些欄位集中列於專頁物件的同一份參考文件,並分為三類:專頁及其周邊的活動、Messenger 對話,以及專頁本身資料的修改。feed、mention 及資料變更會在 entry.changes 中送達,每項均註明欄位名稱;若應用程式關閉了 Include Values,則以 changed_fields 送達。Messenger 事件則在 entry.messaging 中送達,若應用程式並不擁有該對話,則在 entry.standby 中送達。
哪些欄位報告專頁的活動?
共有十二個欄位涵蓋內容及活動,而非對話。例如,新留言會以 feed 的變更送達,其 item 設為 comment,verb 設為 add,與反應、分享及專頁自身發布的帖文一併列出。各欄位送達的內容如下,見 Meta 參考文件:
哪些欄位傳送 Messenger 事件?
Messenger 的欄位最多,Meta 的 Messenger Webhook 指南列明各欄位傳送的內容。以下十三個欄位涵蓋專頁的對話;至於 standby(會將訊息傳送至不擁有該對話的應用程式),則記載於該指南,而非專頁參考文件:
還有哪些 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:
| Permissions | Task of the person behind the token | |
|---|---|---|
| Any field | pages_manage_metadata and pages_show_list | CREATE_CONTENT, MANAGE or MODERATE |
| messages and other Messenger fields | pages_messaging as well | MESSAGING |
| leadgen | leads_retrieval, pages_read_engagement and ads_management as well | ADVERTISE |
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 的專頁發送讚好通知。
每個連接每月 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 監察
驗證日期