# 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"
}