登录
基础
连接微信
办公
第三方应用开发 服务端API 会话内容存档 关键词规则管理 获取命中关键词规则的会话记录
获取命中关键词规则的会话记录
最后更新：2024/01/25
通过该接口，可以获取一段时间内命中关键词规则或关键行为的会话记录。
权限说明
1. 只可获取3天内的企业客户会话记录数据
2. 一次拉取调用上限1000条会话记录，可以通过分页拉取的方式来依次拉取
| 应用类型 | 权限要求 |
|---|---|
| 自建应用 | 暂不支持 |
| 代开发应用 | 暂不支持 |
| 第三方应用 | 暂不支持 |
| 会话存档接口授权 | 需具备「会话存档接口权限- 获取会话记录」权限 |
请求方式： POST（HTTPS）
请求地址： https://qyapi.weixin.qq.com/cgi-bin/chatdata/keyword/get_hit_msg_list?access_token=ACCESS_TOKEN
请求包体：
{
"cursor":"RMTJID",
"token":"NGEJKGOEGJKOEGNEOAGOEGOKEGHOEEEEE",
"limit":200
}参数说明：
| 参数 | 是否必须 | 说明 |
|---|---|---|
| access_token | 是 | 调用接口凭证 |
| cursor | 否 | 上一次调用时返回的next_cursor，第一次拉取可以不填。若不填，从3天内最早的消息开始返回。不多于64字节 |
| token | 否 | 回调事件返回的 token 字段，10分钟内有效；建议都从回调事件中取出token填上，否则接口会有严格的频率限制。不多于128字节 |
| limit | 否 | 每次调用返回的记录数，默认为200，最大不超过1000 |
返回结果：
{
"errcode": 0,
"errmsg": "ok",
"has_more": 1,
"next_cursor": "JGNLGEHJGIE",
"msg_list": [{
"msgid": "xxxmsgid",
"hit_rule_list": [{
"rule_id": "vvvvvvvvvvvvvvvvvxxxx",
"has_hit_keyword": false,
"semantics_list": [1, 2]
}]
}]
}参数说明：
| 参数 | 说明 |
|---|---|
| errcode | 错误码 |
| errmsg | 错误码说明 |
| has_more | 是否还有更多数据。0-否；1-是。 |
| next_cursor | 下次调用带上该值，则从当前的位置继续往后拉，以实现增量拉取。强烈建议对该字段入库保存，每次请求读取带上，请求结束后更新。避免因意外丢，导致必须从头开始拉取，引起消息延迟。 |
| msg_list | 客户会话列表 |
| msgid | 每条消息对应的msgid |
| hit_rule_list | 命中的关键词规则列表 |
| hit_rule_list.rule_id | 命中的规则id |
| hit_rule_list.has_hit_keyword | 是否命中该规则的关键词列表 |
| hit_rule_list.semantics_list | 该规则中命中的关键行为列表，1：红包；2：手机号码；3：邮箱地址；4：微信名片；5：带二维码图片；6：撤回消息；7：银行卡号；8：身份证号；9-发送文件（不包括微盘文件）；10-发送链接（发送链接消息或者发送的文本消息中包含链接） |
- 获取命中关键词规则的会话记录
本节内容
