Webhook 事件目录 - 出海兽Agent · 开放平台

所有事件都使用统一 Webhook 请求合同。本页只说明 event_type、subject_id 与 data 的业务含义。

智能任务事件

事件类型	触发时机	`subject_id`	`data` 说明
`task.completed`	智能任务进入成功终态。	`task_id`	包含 `task_id`、`status=1`、`error_message`，并合并该任务的结果字段。
`task.failed`	智能任务进入失败终态。	`task_id`	包含 `task_id`、`status=-1`、`error_message`，以及任务已产生的附加结果字段。

智能任务稳定字段：

字段	类型	中文说明
`data.task_id`	string	平台任务 ID，可传给对应任务查询接口。
`data.status`	integer	任务终态：`1` 为成功，`-1` 为失败。
`data.error_message`	string	任务失败原因；成功事件通常为空字符串。

不同任务会在 data 中增加结果字段，例如图片任务的资源 URL。请以对应 API 查询接口的返回 Schema 为准，不要假设所有任务具有相同结果字段。

海外社媒账号事件

事件类型	中文说明
`account.authorized`	社媒账号首次授权成功。
`account.reconnected`	已存在账号重新连接成功。
`account.offline`	第三方账号离线或授权失效，需要重新连接。
`account.updated`	账号资料或连接状态发生更新。
`account.deleted`	平台中的社媒账号被删除。

账号事件的 subject_id 是 social_account_id，data 使用社媒账号详情结构，包括账号 ID、平台、连接状态和当前可用资料。字段定义以 API 参考中的“获取社媒账号详情”为准。

海外社媒帖子事件

事件类型	中文说明
`post.published`	帖子已在第三方平台发布。
`post.failed`	帖子发布或状态处理失败。
`post.deleted`	帖子已删除。

帖子事件的 subject_id 是平台本地帖子 ID。data 字段如下：

字段	类型	中文说明
`id`	string	平台本地帖子 ID，后续接口把它作为 `post_id`。
`platform`	string	帖子所属海外社媒平台。
`status`	string	帖子当前机器可读状态。
`status_text`	string	帖子当前状态的可读说明。
`title`	string	帖子标题；平台不适用时为空字符串。
`text`	string	帖子正文；平台不适用时为空字符串。
`description`	string	帖子补充描述；没有时为空字符串。
`post_type`	string	帖子内容类型的机器可读值。
`post_type_text`	string	帖子内容类型的可读说明。
`thumbnail`	string	帖子缩略图 URL；没有时为空字符串。
`permalink`	string	第三方平台永久链接；尚未发布时为空字符串。
`extra`	object	平台或动作附加数据；字段随平台和动作变化。
`last_synced_at`	string/null	最近同步时间；尚未同步时为 null。
`published_at`	string/null	实际发布时间；尚未发布时为 null。
`created_at`	string/null	平台记录创建时间。
`updated_at`	string/null	平台记录最近更新时间。

海外社媒评论事件

事件类型	`subject_id`	`data` 稳定字段
`comment.published`	评论创建动作的 `action_sn`	`action_sn`、`comment_id`、`external_id`、`published_at`、`status=published`。
`comment.deleted`	平台本地 `comment_id`	`comment_id`、`post_id`、`status=deleted`。
`comment.sync.completed`	评论同步动作的 `action_sn`	`action_sn`、`status`、`post_id`、`error_message`。
`comment.sync.failed`	评论同步动作的 `action_sn`	`action_sn`、`status`、`post_id`、`error_message`。

字段	类型	中文说明
`action_sn`	string	评论创建或同步动作流水号，用于关联一次异步动作。
`comment_id`	string	平台本地评论 ID；仅评论发布或删除事件返回。
`external_id`	string	第三方平台评论 ID；尚未生成时可能为空字符串。
`post_id`	string	评论所属的平台本地帖子 ID。
`published_at`	string	评论实际发布时间；尚未发布时可能为空字符串。
`status`	string/integer	评论状态字符串，或评论同步动作的数字状态。
`error_message`	string	评论同步失败原因；成功时通常为空字符串。

处理建议

把 event_type 作为分发键，不要根据 message 文本判断事件。
未识别的新事件应安全忽略并返回成功确认，避免平台持续重试。
收到终态事件后仍可调用对应详情接口核对最新资源状态。
data 中未声明的扩展字段可能随能力或第三方平台变化，客户端应允许未知字段。