# 获取热问列表-开放接口

# 配置信息

例如:

APPID: xxxxxxxxxxxxxxx
TOKEN: xxxxxxxxxxxxxxx
EncodingAESKey: xxxxxxxxxxxxxxx

# 批量设置用户标签接口:

https://chatbot.weixin.qq.com/openapi/gethotquerylist/{TOKEN}

接口类型:

POST请求

参数说明:

字段	类型	是否必填	描述
pageNo	number	否	分页参数，从1开始，默认为1
pageSize	number	否	分页参数，默认为10
matchType	number	否	命中类型, 枚举[0,1,2]，全部0/命中:1/未命中:2
cluesType	number	否	问题类型，枚举[0,1,2], 全部问题：0/交易相关：1/其他：2
reportType	number	否	报告类型，枚举[0,1], 日报：0/周报：1
date	string	是	日期，格式：“YYYY-mm-dd”, 当reportType 为周报时，应传周一的日期, 比如：“2021-07-19”
openid	string	是	开发者openid

开发者openid 获取办法：

第三方平台： https://developers.weixin.qq.com/doc/aispeech/openapi/api/v1/user_register.html

平台用户： TBD

消息加解密接入指引

比如参数为

<xml>
   <pageNo>1</pageNo>
   <pageSize>10</pageSize>
   <matchType>0</matchType>
   <cluesType>0</cluesType>
   <reportType>0</reportType>
   <date><![CDATA[2021-07-19]]></date>
   <openid><![CDATA[abcdasdf123123asldjfalsjdf]]></openid>
</xml>

将加密后的数据,以字段 encrypt 放入 body 中

var cryptor = new WXBizMsgCrypt(TOKEN, EncodingAESKey, APPID);

var data = `<xml>
   <pageNo>1</pageNo>
   <pageSize>10</pageSize>
   <matchType>0</matchType>
   <cluesType>0</cluesType>
   <reportType>0</reportType>
   <date><![CDATA[2021-07-19]></date>
</xml>

</xml>`

var encrypted = cryptor.encrypt(data);

curl -X post -d '{"encrypt": encrypted}' "https://chatbot.weixin.qq.com/openapi/gethotquerylist/{TOKEN}"

返回格式:

export type HotQuesRsp = {
    code: number;
    msg: string;
    data: {
        hotQuesClusterCount: number; // 问题类别数量
        hotQuesCount: number; // 问题数量
        totalPages: number; // 总页数
        list: [
            {
                askCount: number; // 提问总数,
                askUserCount: number; // 提问用户数
                quesCount: number; // 问法总数
                cluesType: string;
                exampleQues: [
                    {
                        ques: string; // 相似问题
                        score: number; // 分数
                    }
                ];
            }
        ];
    };
};

返回值说明:

字段	类型	描述
code	number	错误码
msg	array	接口调用信息
hotQuesClusterCount	number	问题类别数量
hotQuesCount	number	问题数量
totalPages	number	总页数
askCount	number	提问总数
askUserCount	number	提问用户数
exampleQues	number	相似问题