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 私信和从 Facebook 主页通过 Messenger 发送的私信:自动化只记录接受结果,不跟踪投递情况。Instagram 在任何 API 层面都不公开投递信号;如果收件人的 Message requests 设置屏蔽了陌生人,Meta 会接受该发送并静默丢弃。请参见自动化私信已发送但未送达。

每个动作的结果字段

actionResults[] 中的每个条目描述一个动作的结果:

sent 包含的内容

较长的文本值会被截断为 4,000 个字符,发生截断时会设置 truncated。存储在看似凭证的键名下的值(例如 token、secret、password 或 apiKey)会被记录为 "[redacted]"。send_dm 动作的 messageUrl 也始终记录为 "[redacted]",因为 URL 的路径或查询字符串中可能携带密钥。 对于评论触发的自动化(comment_keyword),条目还会携带一个顶层的 commentId——即该私信所锚定到的原始 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];非整数或 ≤0 返回 HTTP 400。
string
上一次响应中 meta.pagination.next 的不透明游标。首次请求时省略即可。仅支持向前——传递 ?previous= 会返回 HTTP 400。

响应结构

响应将结果列表包裹在 activity[] 中,游标信息包裹在 meta.pagination 中:
meta.pagination.next 是一段 Base64 编码的不透明数据——将其视为黑盒,并在下一次请求的 ?next= 中原样传回。当至少还有一页时,meta.pagination.hasMore 为 true。