Facebook 專頁動態消息 webhook:留言、帖子及反應事件
Facebook 專頁 webhook 的 feed 欄位會即時回報專頁動態消息中幾乎所有的變動。每項變動都包含一個 item,例如帖子、留言或反應,以及一個 verb,例如 add、edit 或 remove,另外還有相關的 ID、作者的 from,以及 message 中的文字。Meta 以 JSON 格式發送,並附上 X-Hub-Signature-256 簽名。
easyCoexistence 會為您連接的每個專頁訂閱 feed 欄位,並在變動發生時,以該專頁的密鑰簽署,轉發至您的 HTTPS 端點;留言轉私訊規則及自動化則處理新留言。
專頁讚好數少於 10,000 的專頁,才會收到讚好的動態消息通知。
feed 欄位不會發送廣告帖子本身的事件,但會發送其上的留言。
專頁管理員須擁有 MODERATE 權限並作出授權,專頁 webhook 才能送達應用程式。
Meta 大多會把更新合併成一次 webhook 傳送,但不保證一定合併。
Meta 向應用程式端點重試失敗傳送的時長,頻率會逐步遞減。
feed 欄位會回報什麼?
按 Meta 的分類,feed 欄位會回報專頁動態消息幾乎所有的變動,例如帖子、留言、反應及分享;每項變動所攜帶的內容,取決於其類別。Meta 不會發送廣告帖子本身的事件,但會發送其上的留言。至於專頁讚好,只有讚好數少於 10,000 的專頁才會發送通知。
item 與 verb 分別是什麼意思?
每項變動的 value 中有兩個欄位,說明發生了什麼:
- item:變動的類別,取自 Meta 的清單,包括 post、status、photo、video、link、share、comment、reaction 及 album。
- verb:事件的動作,包括 add、edit、edited、delete、remove、hide、unhide、block、unblock、follow、mute 及 update。
- 新留言的 item 為 comment,verb 為 add,這正是留言轉私訊規則所尋找的條件。
- 反應的 item 為 reaction,並以
reaction_type指明反應種類。
動態消息變動的格式是怎樣的?
這是一個 POST 請求,其 JSON 中 object 設為 page,每個專頁各有一個 entry,內含專頁的 ID、時間,以及一組 changes。以下是 Meta 本身的範例,即一名用戶在專頁上發帖:
{
"object": "page",
"entry": [
{
"id": "<PAGE_ID>",
"time": 1520544816,
"changes": [
{
"field": "feed",
"value": {
"from": { "id": "<USER_ID>", "name": "<NAME>" },
"item": "post",
"post_id": "<PAGE_POST_ID>",
"verb": "add",
"created_time": 1520544814,
"is_hidden": false,
"message": "<POST_TEXT>"
}
}
]
}
]
}一項變動可以包含哪些欄位?
Meta 參考文件列出以下欄位,屬於動態消息變動 value 的一部分,視乎變動類別而定:
post_id、comment_id及parent_id:帖子、留言,以及該留言所屬的上層內容。- from:作出變動者的 ID 及名稱。
- message:文字內容;附加內容則有 link、photo、photos 或 video。
created_time;編輯時則有edited_time。reaction_type用於反應,is_hidden表示帖子是否已隱藏。- post:包括
status_type、is_published、updated_time及permalink_url等詳情。
專頁如何訂閱?
應用程式以 POST /{page-id}/subscribed_apps 發送 subscribed_fields=feed 及專頁的 token,發送者須具備 CREATE_CONTENT、MANAGE 或 MODERATE 任務的權限,並已獲授予 pages_manage_metadata 及 pages_show_list。只有在專頁已安裝該應用程式,且未在設定中關閉應用程式平台時,Meta 才會發送通知。easyCoexistence 在您連接專頁時,會為每個專頁訂閱 feed、messages 及 mention。
動態消息事件如何送達您的端點?
Meta 將事件傳送至 easyCoexistence 的應用程式,該應用程式會檢查 X-Hub-Signature-256、即時回覆 Meta,並將每個已連接專頁的 entry 轉發至您為該專頁設定的 HTTPS 端點。轉發時附有 X-EC-Signature 標頭,即以該專頁的密鑰,對時間戳及原始內文計算的 HMAC-SHA256。每則轉發只發送一次,不保存副本,也不作重試。您可以用 set_social_webhook_destination,或 Partner API 的 PUT /channels/:id/webhook 設定端點。
哪些動態消息變動會觸發留言規則及自動化?
只有新留言,即專頁某則帖子上 item 為 comment、verb 為 add 的變動。留言轉私訊規則會檢查其 message 是否含有指定關鍵字,並略過專頁自己發出的留言;自動化則處理沒有規則回覆的留言。編輯、隱藏、反應及帖子則會直接送至您的端點(如您已設定)。
常見錯誤
- 把任何動態消息變動都當作新留言。請檢查 item 與 verb:反應、編輯、隱藏及移除都會在同一欄位出現。
- 回覆專頁自己的留言。專頁的回覆同樣會以動態消息變動形式回傳,因此請略過 from.id 為專頁 ID 的變動。
- 假設每次傳送只有一項變動。Meta 最多可合併 1,000 項更新,因此請逐一處理每個 entry 及其中的每項 change。
- 把 entry.time 當作變動發生的時間。Meta 將其設為發出通知的時間;value 內的 created_time 才是對象建立的時間。
每個連接每月 US$ 9 起,連接越多越便宜,最低降至 US$ 0.75,首 3 天免費。
常見問題
動態消息 webhook 會包括留言嗎?
會。新留言會以動態消息變動的形式送達,item 為 comment、verb 為 add,並附有 comment_id、post_id、from 及 message。
我會收到專頁讚好的 webhook 嗎?
只有讚好數少於 10,000 的專頁才會收到,依據 Meta 的專頁 webhook 參考文件。
廣告帖子會出現在動態消息 webhook 中嗎?
廣告帖子本身不會,但其上的留言會被發送。
要取得專頁的動態消息事件,我是否需要自己的 Meta 應用程式?
不需要。Meta 會將事件傳送至 easyCoexistence 的應用程式,再轉發至您為該專頁設定的端點。
繼續閱讀
兩分鐘內連接您的第一個頻道。
無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。
- 免費試用 3 天
- 隨時取消
- 只用官方 API
- 24/7 監察
驗證日期