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

Instagram live_comments Webhook:直播期間的留言

Instagram 的 live_comments webhook 欄位會在專業帳戶直播期間,通知應用程式有關直播留言的內容。每則留言都以 changes 的形式送達,field 設為 live_comments,數值結構與 comments 欄位相同:留言的 id 和 text,留言者在 from 中的 Instagram 範圍 ID 與用戶名稱,以及媒體的 id。直播結束後,通知隨即停止。

easyCoexistence 會為每個已連接的 Instagram 帳戶訂閱 comments、messages 與 mentions,並在留言到達時,將其貼文與 Reel 的留言以該帳戶的密鑰簽署後,轉發至您的 HTTPS 端點。

Advanced Access

與 comments 相同,live_comments 通知需要相應權限;私人帳戶擁有的媒體不會發出任何通知。

100/sec

應用程式每個帳戶每秒可向 Instagram 直播留言發送的私人回覆數量。

Broadcast end

直播媒體的留言通知何時停止。

During the Live

何時可以向直播留言發送私人回覆;直播結束後便不能再發送。

9 Nov 2021

Meta 何時推出 live_comments,用於直播影片播出期間的留言。

live_comments 何時觸發?

當有人在專業帳戶的直播影片播出期間留言,且應用程式與該帳戶已訂閱此欄位時,便會觸發。它與 comments 各自獨立:貼文、Reel、限時動態或廣告上的留言會發送到 comments,直播期間的留言則發送到 live_comments。直播媒體的留言通知會在直播結束時停止,由私人帳戶擁有的媒體則不會觸發任何通知。

live_comments 通知是什麼樣子?

與留言通知的外層結構相同:object 設為 instagram,每個帳戶一個 entry,並有一個 changes 陣列,其 field 為 live_comments。Meta 的 Instagram Login 範例中,comments 與 live_comments 使用同一種數值結構,因此要靠欄位名稱區分兩者:

A live_comments notification, as Meta sends it
{
  "object": "instagram",
  "entry": [
    {
      "id": "<IG_ID>",
      "time": 1793448000,
      "changes": [
        {
          "field": "live_comments",
          "value": {
            "id": "<COMMENT_ID>",
            "text": "<COMMENT_TEXT>",
            "from": {
              "id": "<INSTAGRAM_SCOPED_ID>",
              "username": "<USERNAME>"
            },
            "media": {
              "id": "<LIVE_MEDIA_ID>",
              "media_product_type": "<MEDIA_PRODUCT_TYPE>"
            }
          }
        }
      ]
    }
  ]
}

各欄位代表什麼?

以下是 Meta webhook 參考文件中 live_comments 所列的欄位,由外至內排列:

  • entry[].id:專業帳戶。entry[].time:Meta 發送通知的時間,而非留言撰寫的時間。
  • changes[].field:live_comments。讀取 value 前先檢查此欄位,因為結構與 comments 相同。
  • value.id:留言的 ID,即私人回覆的收件對象。
  • value.text:留言的內容。
  • value.from.id 與 value.from.username:留言者的 Instagram 範圍 ID 與用戶名稱;帳戶自行留言時,會出現 from.self_ig_scoped_id。
  • value.media.id 與 value.media.media_product_type:直播影片及其所在的位置。
  • value.parent_id:在參考文件中,適用於回覆另一則留言的留言。

live_comments 與 comments 有何不同?

負載結構相同,但規則不同。Meta 的留言參考文件把直播影片的留言視為獨立情況,其速率限制與私人回覆規則亦各有不同。以下並列比較,左欄為 comments 欄位:

commentslive_comments
Fires forComments on posts, Reels, Stories and adsComments on a Live while it broadcasts
NotificationsAs each comment is madeStop when the broadcast ends
Public replyPOST /<COMMENT_ID>/repliesNot supported on live video
Hide or deleteSupportedNot supported on live video
Private replyWithin 7 days of the commentOnly during the broadcast
Private reply rate750 per hour per account100 per second per account

如何回覆直播留言?

在直播期間以私人回覆方式進行。向 POST /<IG_ID>/messages 發送請求,並將 recipient.comment_id 設為留言的 ID,即可向留言者發送一則私訊;若對方追蹤該帳戶,訊息會進入其收件匣,否則會進入訊息請求。Meta 的參考文件排除了直播影片上的公開途徑:不支援回覆、新增、隱藏或刪除直播影片的留言。直播結束後,便無法再向其留言發送私人回覆。

A private reply to a Live comment
POST https://graph.instagram.com/<IG_ID>/messages
Authorization: Bearer <INSTAGRAM_USER_ACCESS_TOKEN>
Content-Type: application/json

{
  "recipient": { "comment_id": "<COMMENT_ID>" },
  "message": { "text": "<REPLY_TEXT>" }
}

沒有 webhook,能否讀取直播留言?

只能在直播進行期間讀取。Meta 的留言參考文件指出,直播影片的留言只能在媒體播出期間讀取,其媒體參考文件對直播影片本身亦有相同說明。列出帳戶目前直播的 live_media 邊緣,僅記載於 graph.facebook.com 的 Facebook Login 文件中。Meta 不保留可供查詢的通知記錄,因此應在每則事件到達時,儲存所需的資料。

live_comments 需要什麼?

使用 Instagram Login 時,需要 instagram_business_basic 與 instagram_business_manage_comments,即與 comments 相同的一組權限,另加 Meta 對留言與 live_comments 通知所要求的 Advanced Access。在 App Dashboard 中新增的 Instagram 產品,預設會訂閱 live_comments;每個帳戶則需透過 POST /<IG_ID>/subscribed_apps 完成訂閱。擁有該直播的帳戶必須為公開帳戶。

easyCoexistence 會轉發直播留言嗎?

不會。easyCoexistence 的應用程式及每個已連接的 Instagram 帳戶訂閱的是 comments、messages 與 mentions,而非 live_comments,因此直播期間的留言不會轉發。貼文與 Reel 的留言則會轉發,reply_to_comment、hide_comment、留言轉私訊規則及自動化功能亦可對其採取行動。

常見錯誤

  • 在 comments 欄位等待直播留言。直播留言會到達 live_comments,field 為 live_comments,且須在應用程式中選取該欄位。
  • 公開回覆直播留言。Meta 不支援對直播影片留言的回覆、隱藏或刪除;正確途徑是在直播期間發送私人回覆。
  • 把私人回覆留到直播結束後才排隊發送。直播結束後便無法再發送,因此應於直播播出期間回覆。
  • 把 live_comments 當作歷史記錄。通知於直播結束時停止,Meta 亦不保留可供查詢的記錄,因此應在每則通知到達時儲存所需資料。
使用 EasyCoexistence 完成這項設定

reply_to_comment 可公開回覆或發送私人回覆,留言轉私訊規則則全日無休地運作。每個連接每月由 US$ 9 起,連接越多越便宜,最低降至 US$ 0.75,首 3 天免費試用。

常見問題

Instagram 留言 webhook 會包括直播留言嗎?

不會。直播期間的留言會送達獨立的 live_comments 欄位,其數值結構相同。

Meta 何時新增 live_comments webhook?

2021 年 11 月 9 日,用於直播影片播出期間的留言。

我的 live_comments webhook 為何停止?

最可能是直播已經結束,這會令直播媒體的留言通知停止。若從未開始發送,請檢查 Advanced Access、帳戶的訂閱狀態,以及該帳戶是否為公開帳戶。

應用程式可以多快向 Instagram 直播留言發送私人回覆?

每個帳戶每秒最多 100 則,這是 Meta 對直播留言的私人回覆速率;發送至貼文與 Reel 的留言則為每小時 750 則。每則都必須在直播結束前發出。

繼續閱讀

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

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

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

驗證日期