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

活動列狀態

每一列都有最外層的 status,以及 actionResults[] 中每個動作的 status pendingin_flight 為暫時狀態;其他皆為終態。
sent 只確認 Instagram 接受了該訊息,並不表示接收者已收到。 Instagram 在任何 API 介面上都不會暴露送達訊號;若接收者的 Message requests 設定封鎖了陌生人,Meta 會接受該次發送並靜默丟棄。請參閱自動化 DM 已送出但未送達

每個動作的結果欄位

actionResults[] 中的每個項目都描述一個動作的結果: 對於由留言觸發的自動化(comment_keyword),該資料列還會攜帶最外層的 commentId — DM 所錨定的原始 Instagram 留言 ID。對於由訊息驅動的觸發條件(dm_keywordstory_replydm_reaction),此欄位為 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.hasMoretrue