接收消息并回复

POST /open/v1/message 用于处理用户刚刚发来的文本或图片。

一次请求只能提交一种消息类型：文本请求不能同时提供图片，图片请求也不能同时提供文本。

文本消息

提交 messageType: "text" 和 text。文本长度为 1—8000 个 Unicode 字符。

图片消息

提交 messageType: "image" 和公开可访问的 HTTPS 图片地址：

{
  "messageId": "img_001",
  "externalUserId": "user_001",
  "conversationKey": "default",
  "messageType": "image",
  "image": { "url": "https://cdn.example.com/image.png" }
}

图片 URL 最长 2048 个字符。必须是服务端可直接下载的公网 HTTPS 地址，不允许使用 localhost、局域网或其他私网地址，并应避免地址在处理完成前过期。

上下文延续

同一个人持续使用同一 externalUserId，同一聊天窗口持续使用同一 conversationKey。服务重启不会改变这组映射；不要把临时 WebSocket 连接 ID 当成用户或会话标识。

字段全集与响应结构见消息接口。