第三方应用开发 服务端API 会话内容存档 基础接口 获取内部群信息
获取内部群信息
最后更新:2024/02/02
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
获取内部群信息
最后更新:2024/02/02

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

权限说明

内部群中至少存在一个员工在授权范围内
应用类型权限要求
自建应用暂不支持
代开发应用暂不支持
第三方应用暂不支持
会话存档接口授权需具备「会话存档接口权限 - 获取内部群信息」权限

 

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

请求示例:

{
	"chatid":"wrNplhCgAAIVZohLe57zKnvIV7xBKrig"
}

参数说明:

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

 

此接口可以查询chatid对应的群信息,chatid可以从会话内容存档中获取到的chatid填充。只支持内部群和企业互联群。

返回结果

{
    "errcode": 0,
    "errmsg": "ok",
    "creator": "woAAAAAAA",
    "room_create_time": 1592361604,
    "members": [
        {
            "memberid": "woAAAAAAAA",
            "jointime": 1592361605,
			"type": 1,
        },
        {
            "memberid": "woBBBBBBBB",
            "jointime": 1592377076,
			"type": 2,
        }
    ]
}

返回字段说明:

字段名说明
errcode返回码
errmsg对返回码的文本描述内容
creatorchatid对应的群创建者,open_userid
room_create_timechatid对应的群创建时间
memberschatid对应的群成员列表
memberidchatid群成员的id,open_userid、external_userid、机器人id
jointimechatid群成员的入群时间
typechatid群成员的类型
1:员工
2:外部联系人
3:机器人

错误说明:

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

 

上一篇
获取会话记录
下一篇
获取会话同意情况