跳转到主要内容

​
请求参数

​
主体结构

​
client
string
必填
业务标识，请与 MarsMind 智能确定
​
signature
string
必填
签名，见下方算法
​
timestamp
integer
必填
时间戳（Unix 秒级）
​
message_info
object
必填
消息详情，见下方字段定义

​
message_info 字段

​
msg_id
string
唯一消息 ID，assist_dialog 场景下必填
​
group_id
string
群聊 ID，from_user_id 与 group_id 同为空报错 400
​
group_name
string
群聊名称
​
from_user_id
string
必填
发送者 ID
​
from_user_nickname
string
发送者昵称
​
to_user_id
string
接收者 ID
​
to_user_nickname
string
接收者昵称
​
at_list
string[]
@ 的用户 ID 列表（仅 auto_dialog 支持）
​
content
string
消息文本内容，content 与 files_info 至少有一个必填
​
message_type
integer
必填
1 = 普通消息，2 = 引用消息
​
event_type
string
必填
auto_dialog | assist_dialog | website_dialog | cmd_dialog
​
from_user_type
integer
1=机器人绑定账号 2=客户 3=客服 4=机器人消息。auto_dialog 必填
​
create_timestamp
integer
必填
消息创建时间（Unix 时间戳）
​
files_info
File[]
附件列表，见下表。content 与 files_info 至少有一个必填
​
quote
object
引用消息对象，需含 msg_id、message_type。message_type=2 必填

​
files_info 结构

​
content
string
必填
文件地址或 base64 数据
​
file_type
string
必填
“image”/“document”/“voice”

​
对话场景说明

​
auto_dialog（自动对话）

  • event_type = auto_dialog
  • 提供 send_url，由 MarsMind 智能自动控制消息逻辑
  • 支持文本、图片、文件（每次请求类型唯一）
from_user_type 填写建议：
  • 绑定对象：除智能助手本身消息外，均填 1
  • 未绑定对象：外部客户填 2，同公司人员填 3

​
assist_dialog（辅助对话）

  • event_type = assist_dialog
  • 实时返回消息处理结果
  • 参数若与 auto_dialog 消息一致，将复用上下文

​
website_dialog（网页对话）

  • event_type = website_dialog
  • 消息立即返回结果并入上下文，不支持 send_url

​
cmd_dialog（命令控制）

  • event_type = cmd_dialog
  • content 为具体命令，目前支持：
    • stop_auto_reply：停止自动回复（仅 auto_dialog 场景下有效）

​
调用示例

​
auto_dialog

curl -X POST http://127.0.0.1:7002/custom-im/chat-messages \
-H "Content-Type: application/json" \
-d '{
  "client": "test",
  "signature": "d97b383a532466b6c6c451e76a2ab57b",
  "timestamp": 1748584621,
  "message_info": {
    "content": "",
    "message_type": 1,
    "group_id": "98765@chatroom",
    "event_type": "auto_dialog",
    "from_user_id": "aa123",
    "from_user_type": 2,
    "msg_id": "9005",
    "create_timestamp": 1748584621,
    "files_info": [
      { "content": "https://example.com/img.png", "file_type": "image" }
    ]
  }
}'