获取会话内容存档内部群信息 - 接口文档

开发者中心

首页

教程

接口

社区

工具

企业内部开发

快速入门服务端API 客户端API 附录更新日志联系我们

企业内部开发服务端API 会话内容存档获取会话内容存档内部群信息

获取会话内容存档内部群信息

最后更新：2021/01/07

企业可通过此接口，获取会话内容存档本企业的内部群信息，包括群名称、群主id、公告、群创建时间以及所有群成员的id与加入时间。

请求方式：POST（HTTPS）
请求地址：https://qyapi.weixin.qq.com/cgi-bin/msgaudit/groupchat/get?access_token=ACCESS_TOKEN

请求示例：

{
	"roomid":"wrNplhCgAAIVZohLe57zKnvIV7xBKrig"
}

参数说明：

参数	必须	说明
access_token	是	调用接口凭证
roomid	是	待查询的群id

此接口可以查询roomid对应的群信息，roomid可以从会话内容存档中获取到的roomid填充。只支持内部群。

权限说明：
企业需要使用会话内容存档应用secret所获取的accesstoken来调用（accesstoken如何获取？）；

返回结果

{
    "roomname": "蓦然回首",
    "creator": "ZhangWenChao",
    "room_create_time": 1592361604,
    "notice": "",
    "members": [
        {
            "memberid": "ZhangWenChao",
            "jointime": 1592361605
        },
        {
            "memberid": "xujinsheng",
            "jointime": 1592377076
        }
    ],
    "errcode": 0,
    "errmsg": "ok"
}

返回字段说明：

字段名	说明
errcode	返回码
errmsg	对返回码的文本描述内容
roomname	roomid对应的群名称
creator	roomid对应的群创建者，userid
room_create_time	roomid对应的群创建时间
notice	roomid对应的群公告
members	roomid对应的群成员列表
memberid	roomid群成员的id，userid
jointime	roomid群成员的入群时间

错误说明：

返回码	说明
301052	会话存档已过期

客户同意进行聊天内容存档事件回调

产生会话回调事件

本节内容

获取会话内容存档内部群信息