文档中心 > API类目 > 旺旺聊天记录

taobao.airisland.kefueval.get (客服评价详情接口_V2)

获取买家对客服的服务评价 注意: 1. 请求超时[isp.top-remote-connection-timeout]或者数据过大错误[isp.runtime-max-limit]:因为某些帐号请求的数据会非常大,【需要通过减少请求时间范围避免该问题】 2. 时间范围:[now()-90d<=btime ~ etime <= now()-1d ] AND etime-btime <=7d 3. 变更eval_recer:可空,返回脱敏的买家nick,如:摩天轮 -> 摩** 4. 新增labelName:可空

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
query_ids String 必须 cntaobao商家测试帐号22,cntaobao商家测试帐号22:服务助手 客服的nick,多个用逗号分隔,不要超过10个,带cntaobao的长nick
btime String 必须 20230307000000 开始时间,格式yyyyMMddHHmmss,时间范围:[now-90d,now-1d]
etime String 必须 20230308000000 结束时间,格式yyyyMMddHHmmss,时间范围:[now-90d,now-1d]

响应参数

名称 类型 示例值 描述
result_count Number 5 评价结果数
staff_eval_details EvalDetail [] 数组 评价明细
  • └ eval_code
  • Number
  • 1
  • 评分:0-非常满意;1-满意;2-一般;3-不满意;4-非常不满意
  • └ eval_sender
  • String
  • cntaobaommp_004
  • 发送评价邀请的商家客服昵称
  • └ eval_time
  • Date
  • 1473241535117
  • 最后一次评价的时间
  • └ open_uid
  • String
  • OPEN_ID
  • 接收评价的消费者用户ID
  • └ send_time
  • Date
  • 1473241543196
  • 评价的发送时间
  • └ source
  • Number
  • 1
  • 评价来源:0-客服邀评;1-消费者自主评价;2-系统邀评
  • └ label_name
  • String
  • 答非所问
  • 评价标签,可空
  • └ eval_recer
  • String
  • 摩天轮->摩**
  • 脱敏后的买家nick,可空
  • └ valid
  • String
  • false
  • 当前评价无效
  • └ invalid_reason
  • String
  • 不满意挽回成功删除
  • 评价无效的原因

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AirislandKefuevalGetRequest req = new AirislandKefuevalGetRequest();
req.setQueryIds("cntaobao商家测试帐号22,cntaobao商家测试帐号22:服务助手");
req.setBtime("20230307000000");
req.setEtime("20230308000000");
AirislandKefuevalGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<airisland_kefueval_get_response>
    <result_count>5</result_count>
    <staff_eval_details>
        <eval_detail>
            <eval_code>1</eval_code>
            <eval_sender>cntaobaommp_004</eval_sender>
            <eval_time>1473241535117</eval_time>
            <open_uid>OPEN_ID</open_uid>
            <send_time>1473241543196</send_time>
            <source>1</source>
            <label_name>答非所问</label_name>
            <eval_recer>摩天轮-&gt;摩**</eval_recer>
            <valid>false</valid>
            <invalid_reason>不满意挽回成功删除</invalid_reason>
        </eval_detail>
    </staff_eval_details>
</airisland_kefueval_get_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案
isv.invalid-parameter:btime not in [now-90, now-1] 开始时间不是最近90天之内 调整开始时间在90天之内
isv.invalid-parameter:etime not in [now-90, now-1] 结束时间不是90-T-1之内 不允许获取当前的数据
isv.invalid-parameter:sellerId 缺少商家主账号ID 使用正确的token访问

API工具

如何获得此API

FAQ

返回
顶部