Skip to content

发送消息

POST /visitor/message/send

发送访客消息并创建消息记录。普通人工会话返回 JSON;机器人流式回复场景按请求协商返回 text/event-stream,不能假定只会收到 JSON。

请求参数

字段位置类型必填用途
agent_idbodystring | number当前会话客服 ID。
contentbodystring消息正文,不能为空。
tmp_midbodystring | number客户端临时消息 ID;实时事件会透传,供本地消息确认。
qidbodynumberFAQ ID;传入后按 FAQ 问题消息处理。
langbodystring本条消息使用的访客语言。

JSON 成功响应

json
{
  "code": 0,
  "msg": "ok",
  "data": {
    "mid": 1024
  }
}
字段类型用途
data.midnumber新创建的服务端消息 ID。

发送成功后,两端会收到 message.created。内容经过商户敏感词处理后才会保存和推送;客户端应以响应或实时事件中的 mid 确认发送结果。