Appearance
发送消息
POST /visitor/message/send
发送访客消息并创建消息记录。普通人工会话返回 JSON;机器人流式回复场景按请求协商返回 text/event-stream,不能假定只会收到 JSON。
请求参数
| 字段 | 位置 | 类型 | 必填 | 用途 |
|---|---|---|---|---|
agent_id | body | string | number | 是 | 当前会话客服 ID。 |
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 确认发送结果。