跳至主要内容

创建机器人会话

创建一个由机器人接待的在线会话。调用前必须已开启站点的机器人接待功能；未开启时接口返回错误，不会创建会话。

请求​

POST https://apichat.twt.com/openapi/chat/create_robot

Header 参数​

参数名类型必填说明
x-chat-signaturestring是基于实际发送的原始 JSON body 计算的 HMAC-SHA256 签名
Acceptstring否默认：application/json
Content-Typestring是application/json

Body 参数​

参数类型必填说明
appidstring是控制台中的应用标识
timestampinteger是请求时间戳
ranstrstring是随机字符串
sbsstring/number是客户唯一标识，1 到 64 个字符。客户不存在时自动创建
ipstring是客户 IP 地址
sbs_mcstring是客户姓名，1 到 30 个字符
contentstring是初始访客消息，1 到 2000 个字符
titlestring否会话标题，1 到 120 个字符

请求示例​

{
  "appid": "42d7c13c16e7ed0479f2418eb8894310",
  "timestamp": 1767692611,
  "ranstr": "f86bbfa782c7e9fa",
  "sbs": "visitor-10001",
  "ip": "192.168.1.1",
  "sbs_mc": "访客",
  "content": "我想了解一下你们的产品",
  "title": "产品咨询"
}

返回响应​

200 成功​

{
  "code": 1,
  "msg": "ok",
  "data": {
    "chat_id": 900220
  }
}

机器人接待未开启​

{
  "code": -1,
  "msg": "机器人接待未开启",
  "data": ""
}

注意事项​

  • 本接口不接收 kefu_id、fzr_uid 或 sender_type；初始消息始终以访客身份发送，会话由机器人接待。
  • 只有站点已开启机器人接待时请求才会成功。未开启时不会创建客户或会话。
  • 创建成功后的会话状态与访客发起并分配给机器人一致：状态为待回复，负责人为空，不进入排队。
  • content 必填，会作为触发机器人接待的第一条访客消息。
  • 签名必须基于实际发送的原始 JSON body 计算，字段顺序、空格和换行都需要保持一致。