跳至主要内容

创建单聊-批量

POST https://apichat.twt.com/openapi/zxlt/fqlt_dl_batch -- 需要签名鉴权

批量创建多个单聊会话。

请求

POST https://apichat.twt.com/openapi/zxlt/fqlt_dl_batch

Header 参数

参数名类型必填说明
x-chat-signaturestringHMAC-SHA256 签名
Acceptstring默认值:application/json
Content-Typestringapplication/json

Body 参数

参数名类型必填说明
appidstring应用标识,客服端-设置-开发设置查看
timestampinteger发起请求的时间戳
ranstrstring随机字符串
u_infoarray[object]用户信息列表

u_info 对象字段

参数名类型必填说明
kefu_idinteger客服 ID,客服端-团队-客服列表查看
sbsstring客户标识,用户唯一标识,1-64 字符
sbs_mcstring访客名称
contentstring单聊创建成功后发送的消息内容,1-2000 字符
kefu_show_chatinteger客服是否显示会话。1 是,0 否(默认 0)。该参数只有在生成新会话时才有效,如果是已存在的单聊,则默认按 1 的逻辑处理

请求示例

curl -X POST 'https://apichat.twt.com/openapi/zxlt/fqlt_dl_batch' \
-H 'x-chat-signature: 4ecdcaf813c422d34413671b2ed68e0a6e69ea8496d34ab40bd33cef26571e70' \
-H 'Content-Type: application/json' \
-d '{
"appid": "1b621280becdb0fa3d3e041ff69e1e1f",
"timestamp": 1712899200,
"ranstr": "4ad0faec14a58112",
"u_info": [
{
"kefu_id": 10078,
"sbs": "user_1001",
"sbs_mc": "张三",
"content": "你好,请问有什么可以帮您?"
},
{
"kefu_id": 10079,
"sbs": "user_1002",
"sbs_mc": "李四",
"content": "欢迎咨询"
}
]
}'

返回响应

200 成功

参数名类型必填说明
codeinteger1 正常,-1 失败
msgstring失败时的错误信息
datastring返回数据

成功响应:

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

失败响应:

{
"code": -1,
"msg": "签名校验失败",
"data": ""
}