微信小店
微信门店
微信智能接口
微信设备功能

获取客服聊天记录

出自微信公众平台开发者文档
跳转到: 导航, 搜索

获取客服聊天记录接口

在需要时,开发者可以通过获取客服聊天记录接口,获取多客服的会话记录,包括客服和用户会话的所有消息记录和会话的创建、关闭等操作记录。利用此接口可以开发如“消息记录”、“工作监控”、“客服绩效考核”等功能。

接口调用请求说明

http请求方式: POST

 https://api.weixin.qq.com/customservice/msgrecord/getrecord?access_token=ACCESS_TOKEN

POST数据说明

POST数据示例如下:
 {
    "endtime" : 987654321,
    "pageindex" : 1,
    "pagesize" : 10,
    "starttime" : 123456789
 }
参数 是否必须 说明
access_token 调用接口凭证
starttime 查询开始时间,UNIX时间戳
endtime 查询结束时间,UNIX时间戳,每次查询不能跨日查询
pagesize 每页大小,每页最多拉取50条
pageindex 查询第几页,从1开始

返回说明

正常情况下,微信会返回下述JSON数据包:

 {
    "errcode": 0,
    "errmsg": "",
    "retcode": 0,
    "recordlist" : [
       {
          "openid" : "oDF3iY9WMaswOPWjCIp_f3Bnpljk",
          "opercode" : 2002,
          "text" : " 您好,客服test1为您服务。",
          "time" : 1400563710,
          "worker" : "test1"
       },
       {
          "openid" : "oDF3iY9WMaswOPWjCIp_f3Bnpljk",
          "opercode" : 2003,
          "text" : "你好,有什么事情?",
          "time" : 1400563731,
          "worker" : "test1"
       }
    ]
 }
参数 说明
worker 客服账号
openid 用户的标识,对当前公众号唯一
opercode 操作ID(会话状态),具体说明见下文
time 操作时间,UNIX时间戳
text 聊天记录

操作ID(会话状态)定义:

ID值 说明
1000 创建未接入会话
1001 接入会话
1002 主动发起会话
1003 转接会话
1004 关闭会话
1005 抢接会话
2001 公众号收到消息
2002 客服发送消息
2003 客服收到消息

错误时微信会返回错误码等信息,请根据错误码查询错误信息:全局返回码说明