Skip to main content
GET
Beta。 完整功能說明請見自動化概觀。
回傳單一自動化的每一次派送嘗試,最新的在最前面。每一列都會記錄接收者、比對到的觸發條件、每個動作的結果,以及任何錯誤。 僅回傳最近 30 天內的資料列。較舊的資料列仍存在於 Firestore 中(用於分析的保留為無限期),但此端點為了效能而排除這些資料。

活動列狀態

每一列都有最外層的 status,以及 actionResults[] 中每個動作的 status。 pending 與 in_flight 為暫時狀態;其他皆為終態。 當自動化有多個動作時,最外層的 status 會依以下順序從每個動作的結果導出:若任一動作發生驗證錯誤則為 auth_error,接著若任一動作被接受則為 sent,接著若每個動作皆被去重則為 deduplicated,接著若每個動作皆被刻意抑制(skipped 或 deduplicated)則為 skipped,否則為 failed。請閱讀 actionResults[] 取得每個動作的詳細資訊。
sent 代表 Meta 接受了訊息,並非代表接收者收到了訊息。 這同樣適用於 Instagram DM 和透過 Messenger 從 Facebook 粉絲專頁發送的 DM:自動化只記錄接受結果,不會追蹤送達狀態。Instagram 在任何 API 層面都不提供訊息送達的訊號,若接收者的 Message requests 設定阻擋陌生人,Meta 會照常接受發送但靜默地將訊息捨棄。請參閱 Automation DM Sent but Not Delivered。

每個動作的結果欄位

actionResults[] 中每個項目描述一個動作的結果:

sent 包含的內容

過長的文字值會被截短為 4,000 個字元,發生時會設定 truncated。儲存在看起來像憑證的鍵名(例如 token、secret、password 或 apiKey)下的值,會記錄為 "[redacted]"。send_dm 動作的 messageUrl 也一律記錄為 "[redacted]",因為 URL 的路徑或查詢字串中可能帶有機密資訊。 對於由留言觸發的自動化(comment_keyword),該資料列還會攜帶一個最外層的 commentId — 該 DM 所錨定的原始 Instagram 留言 ID。對於由訊息驅動的觸發條件(dm_keyword、story_reply、dm_reaction)則為 null。 資料列也會攜帶 postId(comment_keyword 留言所在的貼文)與 storyId(story_reply 與 story_comment 對應的限時動態)。兩者在其他觸發條件時皆為 null,且在這些欄位加入之前寫入的資料列上不存在。

標頭參數

路徑參數

string
必填
由 POST /automations 回傳的自動化 ID。

查詢參數

number
預設值:25
每頁大小。預設 25,最大 100。[1, 100] 以外的值會被夾限(clamp);非整數或 ≤0 會回傳 HTTP 400。
string
來自上一次回應 meta.pagination.next 的不透明游標。第一次請求時省略。僅支援向前分頁 — 傳入 ?previous= 會回傳 HTTP 400。

回應格式

回應會將結果清單包在 activity[] 中,並將游標資訊包在 meta.pagination 中:
meta.pagination.next 是 base64 編碼的不透明字串 — 請將其視為黑盒,並在下一次請求的 ?next= 中原樣傳回。當至少還有一頁時,meta.pagination.hasMore 為 true。