关闭机器人会话

POST

/openapi/robot/session/close

简要描述：

主动关闭一个机器人会话。当访客主动离开或者主动接入到人工客服时，接入方可通过此接口，将访客关闭机器人会话原因传递到七鱼机器人平台，平台会按转人工具体类型生成相应的统计数据报表。

若未主动调用此接口，则七鱼系统会在访客未说话10分钟后自动关闭这一通机器人会话。

会话关闭后将会生成对应的会话历史记录，会话纬度统计数据，消息纬度统计数据，知识纬度统计数据，转人工纬度统计数据等，接入方可在七鱼机器人平台查看相应数据，便于管理和分析数据。

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'http://qiyukf.com/openapi/robot/session/close?appKey=&time=&checksum=' \
--header 'Content-Type: application/json' \
--data-raw '{
    "uid": "string",
    "productId": "string",
    "closeReason": 0
}'

响应示例

{
    "code": 200,
    "message": "哈哈",
    "data": {
        "sessionId": 62927,
        "userId": 43412123,
        "robotId": 34351
    }
}

请求参数

Query 参数

appKey

string

必需

企业的appKey，1064deea1c3624c9ee26d1de5ce8481f

默认值:

time

string

必需

当前 UTC 时间戳，从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的秒数,1463217187

默认值:

checksum

string

必需

SHA1(appSecret + md5 + time), 三个参数拼接的字符串，进行SHA1哈希计算，转化成16进制字符(String，小写).示例2f13932c4b7c6888b12360a85261a11b8b543f64

默认值:

Body 参数application/json

uid

string

必需

访客在调用方系统里的标志，用于唯一确定用户身份

productId

string

可选

当前咨询应用唯一标识，可以是 Android 应用的包名，iOS 应用的 bundleid，微信公众号appid等。调用方系统如果有多个应用需要接入七鱼时，对不同应用需保证该字段值的唯一性

closeReason

integer

必需

关闭机器人会话原因，1-访客离开 30-访客主动转人工

示例

返回响应

🟢200成功

application/json

Body

code

integer

必需

message

string

必需

data

object

必需

sessionId

integer

必需

当前访客在七鱼系统里的userId

userId

integer

当前机器人会话id

可选

robotId

integer

可选

当前机器人会话所在的机器人id #

修改于 2022-01-25 06:29:56

机器人会话满意度评价

文件上传