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

Facebook 專頁動態消息 webhook:留言、帖子及反應事件

Facebook 專頁 webhook 的 feed 欄位會即時回報專頁動態消息中幾乎所有的變動。每項變動都包含一個 item,例如帖子、留言或反應,以及一個 verb,例如 add、edit 或 remove,另外還有相關的 ID、作者的 from,以及 message 中的文字。Meta 以 JSON 格式發送,並附上 X-Hub-Signature-256 簽名。

easyCoexistence 會為您連接的每個專頁訂閱 feed 欄位,並在變動發生時,以該專頁的密鑰簽署,轉發至您的 HTTPS 端點;留言轉私訊規則及自動化則處理新留言。

10K likes

專頁讚好數少於 10,000 的專頁,才會收到讚好的動態消息通知。

Ad posts

feed 欄位不會發送廣告帖子本身的事件,但會發送其上的留言。

pages_manage_metadata

專頁管理員須擁有 MODERATE 權限並作出授權,專頁 webhook 才能送達應用程式。

1,000

Meta 大多會把更新合併成一次 webhook 傳送,但不保證一定合併。

36 hours

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 本身的範例,即一名用戶在專頁上發帖:

A feed change, as Meta sends it
{
  "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 才是對象建立的時間。
使用 EasyCoexistence 完成這項設定

每個連接每月 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 監察

驗證日期