推送消息 - EMOO开放平台

根据 message_type 走不同分支：

normal：必须带 normal_message_info（from_title 必填）。content 静默截断前 500 字落工作项（建议 ≤500）。

agent：必须带 agent_message_info（ws_agent_key 必填）。content 原文写入 chat 表（assistant 消息），工作项存「去 Markdown 后的前 500 字」。

每次推送在目标用户待办列表落地一条工作项并实时提醒；带 thread_key 时同 (workspace, user, thread_key) 只保留一条，重推刷新内容并浮回（重推即复活：已核销/勾掉的条目重推后回到待处理并重置未读）。批量场景用 POST /message/batch。

目标用户优先取 body 中 emoo_user_id，未传时取请求头 Emoo-User-Id，两者都没有返 4084。

服务间调用：OAuth Client 无用户身份即可调用（无需 Emoo-User-Id）；API Key 需绑定用户具备 WS_MESSAGE ADD 权限。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Body 参数application/json必填

示例

普通消息（带 thread_key 幂等）Agent 消息

{
    "message_type": "normal",
    "content": "您有一条新的审批待办",
    "thread_key": "oa:approval-8821",
    "due_at": "2026-09-10T18:00:00+08:00",
    "normal_message_info": {
        "from_title": "OA 系统",
        "detail_link": "https://example.com/detail"
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200

application/json

推送成功（code=200）或业务错误（HTTP 仍 200）。可能错误码：

4006 workspace_not_found

4012 data_not_found（emoo_user_id 在 workspace 中找不到用户）

4015 invalid_params（多场景：invalid_message_type / normal_message_from_title_required / agent_message_ws_agent_key_required）

4045 chat_not_found（agent 类型指定的 chat_id 不属于当前用户或 workspace）

4081 ws_agent_not_found（ws_agent_key 存在但不属于当前 workspace）

4084 invalid_open_api_user_id（既无 emoo_user_id 又无 Emoo-User-Id）

4092 invalid_open_api_ws_agent_key（ws_agent_key 不存在）

Bodyapplication/json

示例

normal 推送成功（不落 chat）agent 推送成功（含 chat_id）invalid_message_type

{
    "code": 200,
    "message": "success",
    "data": {
        "item_id": 1001,
        "chat_id": null,
        "chat_message_id": null
    }
}

🟠400

🟠401

🟠429