创建回调规则

接口用途

创建事件回调转发规则，把 provider event 映射到自动化任务等目标。

请求方式

POST

接口地址

https://moi.matrixorigin.cn/newmoi/workspaces/<workspace_id>/callback-rules

身份认证

使用工作区 API Key，在请求头中携带 X-API-Key: <WORKSPACE_API_KEY>，并设置 Content-Type: application/json。

路径参数

无。

查询参数

无。

请求体

创建 callback 转发规则，把 provider event 映射到自动化任务等目标。

字段	类型	必填	说明
provider	string	是	如 feishu
credential_ref	string	是	与公网回调 URL 中的引用一致
name	string	是	规则名称
target_type	string	是	目标类型，如 agent_automation_task
target_config	object	否	目标配置，如 automation_task_id
description	string	否	描述
enabled	boolean	否	是否启用
priority	integer	否	优先级
match	object	否	event_types / event_actions / field_equals
stop_after_match	boolean	否	匹配后是否停止

请求示例

curl -X POST 'https://moi.matrixorigin.cn/newmoi/workspaces/<workspace_id>/callback-rules' \
  -H 'X-API-Key: <WORKSPACE_API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{"provider":"feishu","credential_ref":"<credential_ref>","name":"feishu-to-automation","enabled":true,"priority":100,"match":{"event_types":["im.message.receive_v1"]},"target_type":"agent_automation_task","target_config":{"automation_task_id":"<task_id>"},"stop_after_match":true}'

响应说明

除 A2A JSON-RPC 外，多数工作区接口成功响应形如 {"code":0,"data":...}；下列字段描述 data（或 HTTP 202 时的 data）。

返回规则对象：

字段	类型	必填	说明
id	string		规则 ID
workspace_id	string		工作区 ID
provider	string		事件提供方，如 feishu
credential_ref	string		与回调入口对应的凭据引用
name	string		规则名称
description	string		描述
enabled	boolean		是否启用
priority	integer		优先级
match	object		可含 event_types / event_actions / field_equals
target_type	string		转发目标类型（如自动化任务）
target_config	object		目标配置
stop_after_match	boolean		匹配后是否停止后续规则
version	integer		版本（更新时必填）
created_at	string		创建时间
updated_at	string		更新时间

使用限制

• 这是控制面规则，不是 provider 公网入口。

相关接口

• 查询回调规则列表

• Feishu 公网回调入口