帮助中心首页
开发者文档
人工在线客服开放接口

在线统计接口

客户会话概览

请求方法

POST

https://open.sobot.com/open/platform/api.json

请求参数(Request Body)

参数名类型必填说明
action字符串传值为"wb_session_customer"
access_token字符串调用接口凭据
data对象详见下文

请求data

参数名类型必填说明
startDate字符串开始日期(yyyy-MM-dd)
endDate整型结束日期(yyyy-MM-dd)

返回数据

参数名类型说明
code字符串执行结果码,1000代表成功,1001表示失败
data对象详见下文

返回item

参数名类型说明
totalConsultSession整型总咨询会话
totalValidSession整型总有效会话
totalValidSessionRate字符型总有效会话率
avgSessionDuration字符串平均总会话接待时长
avgTotalSessionDuration字符型平均总会话时长
totalInvalidSession整型总无效会话

请求示例

curl https://open.sobot.com/open/platform/api.json \
-X POST \
-H 'content-type: application/json' \
-d '
{
  "action": "wb_session_customer",
  "access_token": "xx",//获取access_token
  "data": {
      "startDate": "xx",
      "endDate":xx
  }
}'

返回示例

{
  "data": {
    "item": {
      "totalConsultSession": xx,
      "totalValidSession": xx,
      "totalValidSessionRate": "xx",
      "avgSessionDuration": "xx",
      "avgTotalSessionDuration": "xx",
      "totalInvalidSession": xx
    }
  },
  "code": "1000"
}


机器人会话概览

请求方法

POST

https://open.sobot.com/open/platform/api.json

请求参数(Request Body)

参数名类型必填说明
action字符串传值为"wb_session_robot"
access_token字符串调用接口凭据
data对象详见下文

请求data

参数名类型必填说明
startDate字符串开始日期(yyyy-MM-dd)
endDate整型结束日期(yyyy-MM-dd)

返回数据

参数名类型说明
code字符串执行结果码,1000代表成功,1001表示失败
data对象详见下文

返回item

参数名类型说明
consultSession整型咨询会话
validSession整型有效会话
invalidSession整型无效会话
validReceptionRate字符串有效接待率
selfReceptionSession整型独立接待会话
selfReceptionRate字符串独立接待率
toHumanSession整型转人工会话
toHumanSessionRate字符串转人工会话率
avgSessionDuration字符串平均会话时长

请求示例

curl https://open.sobot.com/open/platform/api.json \
-X POST \
-H 'content-type: application/json' \
-d '
{
  "action": "wb_session_robot",
  "access_token": "xx",//获取access_token
  "data": {
      "startDate": "xx",
      "endDate":xx
  }
}'

返回示例

{
  "data": {
    "item": {
      "consultSession": xx,
      "validSession": xx,
      "invalidSession": xx,
      "validReceptionRate": xx,
      "selfReceptionSession": xx,
      "selfReceptionRate":xx,
      "toHumanSession": xx,
      "toHumanSessionRate": xx,
      "avgSessionDuration": xx
    }
  },
  "code": "1000"
}


人工会话概览

请求方法

POST

https://open.sobot.com/open/platform/api.json

请求参数(Request Body)

参数名类型必填说明
action字符串传值为"wb_session_human"
access_token字符串调用接口凭据
data对象详见下文

请求data

参数名类型必填说明
startDate字符串开始日期(yyyy-MM-dd)
endDate整型结束日期(yyyy-MM-dd)

返回数据

参数名类型说明
code字符串执行结果码,1000代表成功,1001表示失败
data对象详见下文

返回item

参数名类型说明
consultSession整型咨询会话
selfReceptionSession整型独立接待会话
selfReceptionSessionZb字符串独立接待会话占比
validSession整型有效会话
invalidSession整型无效会话
validSessionRate字符串有效会话率
validReceptionSession整型有效接待会话
invalidReceptionSession整型无效接待会话
invalidReceptionRate字符串无效接待率
notReceptionSession整型未接待会话
notReceptionSessionRate字符串未接待会话率
transferSession整型转接会话
blankListSession整型拉黑会话
avgSessionDuration字符串平均人工接待时长
solvedSession整型已解决会话
notSolvedSession整型未解决会话
notMarkIsSolved整型未标注是否解决会话
maxMeantimeRecp整型最大同时接待会话
initiativeSession整型主动发起会话量
validReceptionRate字符串有效接待率

请求示例

curl https://open.sobot.com/open/platform/api.json \
-X POST \
-H 'content-type: application/json' \
-d '
{
  "action": "wb_session_human",
  "access_token": "xx",//获取access_token
  "data": {
      "startDate": "xx",
      "endDate":xx
  }
}'

返回示例

{
  "data": {
    "item": {
      "consultSession": xx,
      "selfReceptionSession": xx,
      "selfReceptionSessionZb": xx,
      "validSession": xx,
      "invalidSession": xx,
      "validSessionRate": xx,
      "validReceptionSession": xx,
      "invalidReceptionSession": xx,
      "invalidReceptionRate": xx,
      "notReceptionSession": xx,
      "notReceptionSessionRate": xx,
      "transferSession": xx,
      "blankListSession": xx,
      "avgSessionDuration": xx,
      "solvedSession": xx,
      "notSolvedSession": xx,
      "notMarkIsSolved": xx,
      "maxMeantimeRecp": xx,
      "initiativeSession": xx,
      "validReceptionRate": xx
    }
  },
  "code": "1000"
}


会话消息统计

请求方法

POST

https://open.sobot.com/open/platform/api.json

请求参数(Request Body)

参数名类型必填说明
action字符串传值为"wb_session_message"
access_token字符串调用接口凭据
data对象详见下文

请求data

参数名类型必填说明
startDate字符串开始日期(yyyy-MM-dd)
endDate整型结束日期(yyyy-MM-dd)

返回数据

参数名类型说明
code字符串执行结果码,1000代表成功,1001表示失败
data对象详见下文

返回item

参数名类型说明
totalMessage整型总会话消息数
robotMessage整型机器人消息数
totalCustomerMessage整型客户消息数
serviceMessage整型客服消息数
avgMessageDouble平均每会话消息数
avgCustomerMessageDouble平均每会话客户消息数
avgServiceMessgeDouble平均每会话客服消息数
customerToRobotMessage整型客户消息数
robotAvgMessageDouble平均每会话消息数
robotAvgCustomerMessageDouble平均每会话客户消息数
totalHumanMessage整型总人工会话消息数
customerToServiceMessage整型客户消息数
serviceMessage整型客服消息数
answerThan字符串答问比
humanAvgMessageDouble平均每会话消息数
humanAvgCustomerMessageDouble平均每会话客户消息数
humanAvgServiceMessageDouble平均每会话客服消息数
serviceWord整型客服字数
avgServiceWordDouble平均每会话客服字数
serviceOfflineNum整型客服离线消息数

请求示例

curl https://open.sobot.com/open/platform/api.json \
-X POST \
-H 'content-type: application/json' \
-d '
{
  "action": "wb_session_message",
  "access_token": "xx",//获取access_token
  "data": {
      "startDate": "xx",
      "endDate":xx
  }
}'

返回示例

{
  "data": {
    "item": {
      "totalMessage": xx,
      "robotMessage": xx,
      "totalCustomerMessage": xx,
      "serviceMessage": xx,
      "avgMessage": xx,
      "avgCustomerMessage": xx,
      "avgServiceMessge": xx,
      "customerToRobotMessage": xx,
      "robotAvgCustomerMessage": xx,
      "robotAvgMessage": xx,
      "totalHumanMessage": xx,
      "customerToServiceMessage": xx,
      "answerThan": xx,
      "serviceWord": xx,
      "avgServiceWord": xx,
      "humanAvgMessage": xx,
      "humanAvgCustomerMessage": xx,
      "humanAvgServiceMessage": xx,
      "serviceOfflineNum": xx
    }
  },
  "code": "1000"
}


人工满意度评价统计

请求方法

POST

https://open.sobot.com/open/platform/api.json

请求参数(Request Body)

参数名类型必填说明
action字符串传值为"wb_human_satisfaction"
access_token字符串调用接口凭据
data对象详见下文

请求data

参数名类型必填说明
startDate字符串开始日期(yyyy-MM-dd)
endDate整型结束日期(yyyy-MM-dd)

返回数据

参数名类型说明
code字符串执行结果码,1000代表成功,1001表示失败
data对象详见下文

返回item

参数名类型说明
effectSessionCount整型有效会话总数
totalTimes整型已评价总数
canpinglv字符串参评率
initiative整型客户主动参评
customActiveEvRatio字符串客户主动参评占比
serviceInvEvRatio字符串客服邀请参评占比
invites整型客服邀请参评
solvedCount整型评价解决总数
solved整型已解决数
notSolved整型未解决数
solvedLv字符串已解决率
avgNum字符串平均分
good整型好评数
goodLv字符串好评率
middle整型中评数
middleLv字符串中评率
bad整型差评数
badLv字符串差评率
score4整型4分数
score3整型3分数
score2整型2分数
score1整型1分数

请求示例

curl https://open.sobot.com/open/platform/api.json \
-X POST \
-H 'content-type: application/json' \
-d '
{
  "action": "wb_human_satisfaction",
  "access_token": "xx",//获取access_token
  "data": {
      "startDate": "xx",
      "endDate":xx
  }
}'

返回示例

{
  "data": {
    "item": {
      "effectSessionCount": xx,
      "totalTimes": xx,
      "canpinglv": xx,
      "initiative": xx,
      "invites": xx,
      "solvedCount": xx,
      "solved": xx,
      "notSolved": xx,
      "solvedLv": xx,
      "avgNum": xx,
      "good": xx,
      "goodLv": xx,
      "middle": xx,
      "middleLv": xx,
      "bad": xx,
      "badLv": xx,
      "customActiveEvRatio": xx,
      "serviceInvEvRatio": xx,
      "score4": xx,
      "score3": xx,
      "score2": xx,
      "score1": xx
    }
  },
  "code": "1000"
}


机器人满意度评价统计

请求方法

POST

https://open.sobot.com/open/platform/api.json

请求参数(Request Body)

参数名类型必填说明
action字符串传值为"wb_robot_satisfaction"
access_token字符串调用接口凭据
data对象详见下文

请求data

参数名类型必填说明
startDate字符串开始日期(yyyy-MM-dd)
endDate整型结束日期(yyyy-MM-dd)

返回数据

参数名类型说明
code字符串执行结果码,1000代表成功,1001表示失败
data对象详见下文

返回item

参数名类型说明
effectSessionCount整型有效会话总数
totalTimes整型已评价总数
canpinglv字符串参评率
solved整型已解决数
notSolved整型未解决数
solvedLv字符串已解决率

请求示例

curl https://open.sobot.com/open/platform/api.json \
-X POST \
-H 'content-type: application/json' \
-d '
{
  "action": "wb_robot_satisfaction",
  "access_token": "xx",//获取access_token
  "data": {
      "startDate": "xx",
      "endDate":xx
  }
}'

返回示例

{
  "data": {
    "item": {
      "effectSessionCount": xx,
      "totalTimes": xx,
      "canpinglv": xx,
      "solved": xx,
      "notSolved": xx,
      "solvedLv": xx,
    }
  },
  "code": "1000"
}