Skip to content

发送消息

POST /visitor/message/send

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

发送前先完成分配客服;发送结果和 message.created 事件应按会话与消息事件中的 mid 规则合并。

请求参数

字段位置类型必填用途
agent_idbodystring当前会话客服 ID。仅允许字母、数字、下划线或连字符,长度 1–64,不能为 0
contentbodystring消息正文,不能为空。
tmp_midbodystring | number客户端临时消息 ID;实时事件会透传,供本地消息确认。
qidbodynumberFAQ ID;传入后按 FAQ 问题消息处理。
langbodystring本条消息使用的访客语言。

JSON 成功响应

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

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