Appearance
发送消息
POST /visitor/message/send
发送访客消息并创建消息记录。普通人工会话返回 JSON;机器人流式回复场景按请求协商返回 text/event-stream,不能假定只会收到 JSON。
发送前先完成分配客服;发送结果和 message.created 事件应按会话与消息事件中的 mid 规则合并。
请求参数
| 字段 | 位置 | 类型 | 必填 | 用途 |
|---|---|---|---|---|
agent_id | body | string | 是 | 当前会话客服 ID。仅允许字母、数字、下划线或连字符,长度 1–64,不能为 0。 |
content | body | string | 是 | 消息正文,不能为空。 |
tmp_mid | body | string | number | 否 | 客户端临时消息 ID;实时事件会透传,供本地消息确认。 |
qid | body | number | 否 | FAQ ID;传入后按 FAQ 问题消息处理。 |
lang | body | string | 否 | 本条消息使用的访客语言。 |
JSON 成功响应
json
{
"code": 0,
"msg": "ok",
"data": {
"mid": 1024
}
}| 字段 | 类型 | 用途 |
|---|---|---|
data.mid | number | 新创建的服务端消息 ID。 |
发送成功后,两端会收到 message.created。内容经过商户敏感词处理后才会保存和推送;客户端应以响应或实时事件中的 mid 确认发送结果。