# shopping-guide.getGuideBuyerChatRecord

本接口应在服务器端调用,详细说明参见服务端API

获取顾问聊天记录。 支持拉取该顾问近 30 天的聊天记录。begin_time 与 end_time 同时非0情况下,该参数才会生效,否则为默认值。

# 请求地址

POST https://api.weixin.qq.com/cgi-bin/guide/getguidebuyerchatrecord?access_token=ACCESS_TOKEN

# 请求参数

属性 类型 默认值 必填 说明
access_token string 接口调用凭证
guide_account string 顾问微信号(guide_account和guide_openid二选一)
guide_openid string 顾问openid或者unionid(guide_account和guide_openid二选一)
openid string 若不填,则拉取该顾问所有客户的聊天记录。若填写,则拉取顾问与某一个客户的聊天记录。
begin_time number 消息的起始UNIX时间戳,如果不填,默认当前时间的前30天(仅支持30天范围内的查询)
end_time number 消息的截止UNIX时间戳,如果不填,默认当前时间。
page number 分页页数,从0开始
num number 每页数量

# 返回值

# Object

属性 类型 说明
total_num number 聊天记录总数
msg_list Array.<Object> 聊天记录列表
errmsg string 错误信息

msg_list 的结构

属性 类型 说明
guide_account string 顾问微信号
openid string 客户openid
create_time number 聊天记录生成时间
content string 聊天内容
content_type number 聊天记录类型
direction number 消息指向

msg_list.content_type 的合法值

说明 最低版本
1 文字类型
3 图片类型
49 小程序卡片类型

msg_list.direction 的合法值

说明 最低版本
1 顾问发送消息给客户
2 客户发送消息给顾问

# 请求数据示例

{
  "guide_account": "张三",
  "openid": "xxxx",
  "begin_time": 121212,
  "end_time": 232323,
  "page": 0,
  "num": 10
}

# 返回数据示例

{
       "total_num": 1,
       "msg_list": [
           {
               "guide_account": "张三",
               "openid": "xxx",
               "create_time": 121212,
               "content": "test",
               "content_type": 1,
               "direction": 1
           }
       ],
   "errcode": 0,
   "errmsg": "ok"
   }