坐席满意度报表

查询满意度报表数据，需要企业开通满意度报表权限。支持按客服组或客服筛选。时间范围不超过 31 天（可配置），默认查询近 30 天。model 参数：1-全部、2-按客服组、3-按客服。pageSize 上限 1000（可配置）。

请求参数

名称	类型	必填	描述
appKey	string	是	应用 AppKey
time	int64	是	请求时间戳（秒）
checksum	string	是	请求签名校验和

请求体

名称	类型	必填	描述	示例值
model	int64	否	查询模式：1-全部、2-按客服组、3-按客服	1
startTime	int64	否	开始时间（毫秒时间戳），不传默认 30 天前	1685548800000
endTime	int64	否	结束时间（毫秒时间戳），不传默认昨天 23:59:59	1688140799000
staffGroupList	int64[]	否	客服组 ID 列表（model=2 时有效）
staffIdList	int64[]	否	客服 ID 列表（model=3 时有效）
page	int32	否	页码，从 1 开始	1
pageSize	int32	否	每页条数，上限 1000（可配置）	100

返回参数

名称	类型	描述	示例值
code	int32	状态码，200 表示成功	200
message	object	满意度报表分页数据结构
└total	int32	符合条件的记录总数	150
└result	object[]	满意度记录列表
└id	int64	客服 ID	10001
└name	string	客服姓名	张三
└account	string	客服账户	agent01@example.com
└date	int64	统计日期（毫秒时间戳）	1685548800000
└staffInviteCount	int64	人工邀评量	50
└inviteCount	int64	邀评量	80
└evaCount	int64	参评量	40
└verySatisfiedCount	int64	非常满意会话数	15
└satisfiedCount	int64	满意会话数	20
└normalSatisfiedCount	int64	一般会话数	3
└veryNotSatisfiedCount	int64	非常不满意会话数	1
└notSatisfiedCount	int64	不满意会话数	1
└staffInviteRatio	double	人工邀评率	0.625
└inviteRatio	double	邀评率	1
└validStaffInviteRatio	double	有效人工邀评率	0.625
└validInviteRatio	double	有效邀评率	1
└evaRatio	double	参评率	0.5
└validEvaRatio	double	有效参评率	0.5
└satisfactionRatio	double	相对满意度	0.875
└validSatisfactionRatio	double	有效相对满意度	0.875

错误码

状态码	描述
14001	AppKey 不存在
14002	checksum 校验失败
14003	请求时间戳与服务器时间误差超过 10 分钟
14004	请求体 JSON 格式错误或参数缺失
14500	服务内部异常
14501	时间范围超过限制（>31 天）；结束时间不合法
14515	当前企业无满意度报表权限

postEndpoint

/openapi/statistic/satisfaction/report

curl -X POST "https://qiyukf.com/openapi/statistic/satisfaction/report?appKey=string&time=1739347200&checksum=a1b2c3d4e5f607182930abcdefabcdef" \  -H "Content-Type: application/json" \  -d '{}'

{
  "code": 200,
  "message": {
    "total": 150,
    "result": [
      {
        "id": 10001,
        "name": "张三",
        "account": "agent01@example.com",
        "date": 1685548800000,
        "staffInviteCount": 50,
        "inviteCount": 80,
        "evaCount": 40,
        "verySatisfiedCount": 15,
        "satisfiedCount": 20,
        "normalSatisfiedCount": 3,
        "veryNotSatisfiedCount": 1,
        "notSatisfiedCount": 1,
        "staffInviteRatio": 0.625,
        "inviteRatio": 1,
        "validStaffInviteRatio": 0.625,
        "validInviteRatio": 1,
        "evaRatio": 0.5,
        "validEvaRatio": 0.5,
        "satisfactionRatio": 0.875,
        "validSatisfactionRatio": 0.875
      }
    ]
  }
}

{
  "code": 14001,
  "message": "AppKey 不存在"
}

{
  "code": 14002,
  "message": "checksum 校验失败"
}

{
  "code": 14003,
  "message": "请求时间戳与服务器时间误差超过 10 分钟"
}

{
  "code": 14004,
  "message": "请求体 JSON 格式错误或参数缺失"
}

{
  "code": 14500,
  "message": "服务内部异常"
}

{
  "code": 14501,
  "message": "时间范围超过限制（>31 天）；结束时间不合法"
}

{
  "code": 14515,
  "message": "当前企业无满意度报表权限"
}