图文消息留言管理
为了方便公众号开发者和公众号第三方平台开发者灵活使用图文消息的留言功能,上线了留言功能的相关接口。使用接口过程中有任何问题,可以前往微信开放社区 #公众号 专区发帖交流。
1. 评论能力管理
新建素材时,当公众号具备留言功能的权限时,可以指定 media_id 在群发时打开留言功能,并指定该 media_id 的评论范围(所有人都可以留言,或仅公众号粉丝可以留言)。
1.1 新增永久素材(原接口有所改动)
接口调用请求说明
https 请求方式: POST https://api.weixin.qq.com/cgi-bin/material/add_news?access_token=ACCESS_TOKEN
参数说明
调用示例
{
"articles":[{
"title": TITLE,
"thumb_media_id": THUMB_MEDIA_ID,
"author": AUTHOR, "digest" : DIGEST,
"show_cover_pic": SHOW_COVER_PIC(0/1),
"content" : CONTENT,
"content_source_url": CONTENT_SOURCE_URL,
"need_open_comment" : NEED_OPEN_COMMENT(0/1),
"only_fans_can_comment" : ONLY_FANS_CAN_COMMENT(0/1) }]
//若新增的是多图文素材,则此处应有几段articles结构,最多8段
}
返回(json 格式)
{ "media_id" : MEDIA_ID }
新增返回码(json格式)
{ "errcode" : 88000, "errmsg" : "without comment privilege" //没有留言权限 }
1.2 获取永久素材(原接口有所改动)
接口调用请求说明
https 请求方式: POST https://api.weixin.qq.com/cgi-bin/material/get_material?access_token=ACCESS_TOKEN
返回说明
新增返回字段 need_open_comment 和 only_fans_can_comment
1.3 修改永久图文素材(原接口有所改动)
接口调用请求说明
https 请求方式: POST https://api.weixin.qq.com/cgi-bin/material/update_news?access_token=ACCESS_TOKEN
新增参数 need_open_comment 和 only_fans_can_comment
1.4 获取素材列表(原接口有所改动)
接口调用请求说明
https 请求方式: POST https://api.weixin.qq.com/cgi-bin/material/batchget_material?access_token=ACCESS_TOKEN
新增参数 need_open_comment 和 only_fans_can_comment
2. 评论数据管理
2.1 打开已群发文章评论(新增接口)
接口调用请求说明
https 请求方式: POST https://api.weixin.qq.com/cgi-bin/comment/open?access_token=ACCESS_TOKEN
参数说明
调用示例
{ "msg_data_id" : MSG_DATA_ID, "index" : INDEX }
返回(json格式)
{ "errcode": ERRCODE, "errmsg" : ERRMSG }
返回码定义
{
"errcode" : 45009,
"errmsg" : "reach max api daily quota limit"
//没有剩余的调用次数
}
{
"errcode" : 88000,
"errmsg" : "without comment privilege"
//没有留言权限
}
{
"errcode" : 88001,
"errmsg" : "msg_data is not exists"
//该图文不存在
}
{
"errcode": 88002,
"errmsg" : "the article is limit for safety"
//文章存在敏感信息
}
2.2 关闭已群发文章评论(新增接口)
接口调用请求说明
https 请求方式: POST https://api.weixin.qq.com/cgi-bin/comment/close?access_token=ACCESS_TOKEN
参数说明
调用示例
{ "msg_data_id" : MSG_DATA_ID, "index" : INDEX, }
返回(json格式)
{ "errcode": ERRCODE, "errmsg" : ERRMSG }
2.3 查看指定文章的评论数据(新增接口)
接口调用请求说明
https 请求方式: POST
https://api.weixin.qq.com/cgi-bin/comment/list?access_token=ACCESS_TOKEN
参数说明
调用示例
{ "msg_data_id" : MSG_DATA_ID, "index" : INDEX, "begin": BEGIN, "count": COUNT, "type" : TYPE }
返回(json格式)
{
"errcode": 0,
"errmsg": "ok",
"total": TOTAL //总数,非comment的size around
"comment": [{
"user_comment_id" : USER_COMMENT_ID //用户评论id
"openid": OPENID //openid
"create_time": CREATE_TIME //评论时间
"content": CONTENT //评论内容
"comment_type": IS_ELECTED //是否精选评论,0为即非精选,1为true,即精选
"reply": {
"content": CONTENT //作者回复内容
"create_time" : CREATE_TIME //作者回复时间
}
}]
}
返回码定义
{ "errcode" : 45009 , "errmsg" : "reach max api daily quota limit" //没有剩余的调用次数 }
{ "errcode" : 88000 , "errmsg" : "open comment without comment privilege" //没有留言权限 }
{ "errcode" : 88001 , "errmsg" : "msg_data is not exists" //该图文不存在 }
{ "errcode" : 88010 , "errmsg" : "count range error. cout <= 0 or count > 50" //获取评论数目不合法 }
2.4 将评论标记精选(新增接口)
接口调用请求说明
https 请求方式: POST https://api.weixin.qq.com/cgi-bin/comment/markelect?access_token=ACCESS_TOKEN
参数说明
调用示例
{ "msg_data_id" : MSG_DATA_ID, "index": INDEX, "user_comment_id": COMMENT_ID, }
返回格式(json)
{ "errcode": ERRCODE, "errmsg" : ERRMSG }
返回码定义
{ "errcode" : 45009, "errmsg" : "reach max api daily quota limit" //没有剩余的调用次数 }
{ "errcode" : 88000, "errmsg" : "open comment without comment privilege" //没有留言权限 }
{ "errcode" : 88001, "errmsg" : "msg_data is not exists" //该图文不存在 }
{ "errcode" : 88003, "errmsg" : "elected comment upper limit" //精选评论数已达上限 }
{ "errcode" : 88004, "errmsg" : "comment was deleted by user" //已被用户删除,无法精选 }
{ "errcode" : 88008, "errmsg" : "comment is not exists" //该评论不存在 }
2.5 将评论取消精选
接口调用请求说明
https 请求方式: POST https://api.weixin.qq.com/cgi-bin/comment/unmarkelect?access_token=ACCESS_TOKEN
参数说明
调用示例
{ "msg_data_id" : MSG_DATA_ID, "index": INDEX, "user_comment_id": COMMENT_ID, }
返回格式(json)
{ "errcode": ERRCODE, "errmsg" : ERRMSG }
返回码定义
{ "errcode" : 45009, "errmsg" : "reach max api daily quota limit" //没有剩余的调用次数 }
{ "errcode" : 88000, "errmsg" : "open comment without comment privilege" //没有留言权限 }
{ "errcode" : 88001, "errmsg" : "msg_data is not exists" //该图文不存在 }
{ "errcode" : 88008, "errmsg" : "comment is not exists" //该评论不存在 }
2.6 删除评论(新增接口)
接口调用请求说明
https 请求方式: POST https://api.weixin.qq.com/cgi-bin/comment/delete?access_token=ACCESS_TOKEN
参数说明
调用示例
{ "msg_data_id" : MSG_DATA_ID, "index" : INDEX, "user_comment_id": COMMENT_ID, }
返回格式(json)
{"errcode": ERRCODE, "errmsg" : ERRMSG }
返回码定义
{ "errcode" : 45009, "errmsg" : "reach max api daily quota limit" //没有剩余的调用次数 }
{ "errcode" : 88000, "errmsg" : "open comment without comment privilege" //没有留言权限 }
{ "errcode" : 88001, "errmsg" : "msg_data is not exists" //该图文不存在 }
{ "errcode" : 88008, "errmsg" : "comment is not exists" //该评论不存在 }
2.7 回复评论(新增接口)
接口调用请求说明
https 请求方式: POST https://api.weixin.qq.com/cgi-bin/comment/reply/add?access_token=ACCESS_TOKEN
参数说明
调用示例
{ "msg_data_id" : MSG_DATA_ID, "index" : INDEX, "user_comment_id": COMMENT_ID, "content": CONTENT }
返回格式(json)
{ "errcode": ERRCODE, "errmsg" : ERRMSG }
返回码定义
{ "errcode" : 45009, "errmsg" : "reach max api daily quota limit" //没有剩余的调用次数 }
{ "errcode" : 88000, "errmsg" : "open comment without comment privilege" //没有留言权限 }
{ "errcode" : 88001, "errmsg" : "msg_data is not exists" //该图文不存在 }
{ "errcode" : 88005, "errmsg" : "already reply" //已经回复过了 }
{ "errcode" : 88007, "errmsg" : "reply content beyond max len or content len is zero"//回复超过长度限制或为0 }
{ "errcode" : 88008, "errmsg" : "comment is not exists" //该评论不存在 }
2.8 删除回复(新增接口)
接口调用请求说明
https 请求方式: POST https://api.weixin.qq.com/cgi-bin/comment/reply/delete?access_token=ACCESS_TOKEN
参数说明
调用示例
{ "msg_data_id" : MSG_DATA_ID, "index" : INDEX, "user_comment_id": COMMENT_ID, }
返回格式(json)
{ "errcode": ERRCODE, "errmsg" : ERRMSG }
返回码定义
{ "errcode" : 45009, "errmsg" : "reach max api daily quota limit" //没有剩余的调用次数 }
{ "errcode" : 88000, "errmsg" : "open comment without comment privilege" //没有留言权限 }
{ "errcode" : 88001, "errmsg" : "msg_data is not exists" //该图文不存在 }
{ "errcode" : 88008, "errmsg" : "comment is not exists" //该评论不存在 }
{ "errcode" : 87009, "errmsg" : "reply is not exists" //该回复不存在 }