企业微信API接入文档
官方网站最佳实践企微AI数字员工
官方网站最佳实践企微AI数字员工
  1. 群操作
  • 产品简介
  • 收费标准
  • 版本更新
  • 使用必读
    • 二次验证注意事项及操作流程
    • 自动登录重连流程
    • 注意事项
  • 接口功能调用
    • 初始化(第一步)
      • 初始化企业微信(第一步必须)
      • 设置消息回调地址
      • 获取运行中的实例
      • 根据uuid查看实例详情
      • 关闭链接
    • 代理设置/取消
      • 设置或者取消代理接口
    • 登录
      • 获取登录二维码
      • 验证码设置
      • 自动登录
      • 退出登录
      • 获取二次验证二维码接口
    • 发送消息(以及消息获取)
      • 撤回消息
      • 发送文本消息
      • 发送文本表情消息
      • 发送CDN图片消息
      • 发送CDN文件消息
      • 发送CDN语音消息
      • 发送CDN视频消息
      • 发送大视频文件
      • 发送大文件消息
      • 发送连接卡片
      • 发送小程序
      • 发送视频号消息
      • 发送视频号直播消息
      • 发送gif表情
      • 发送名片消息
      • 发送位置消息
      • 发送群@消息
      • 格式化发送@消息
      • 同步消息记录
      • 群发消息(每天每人一次)
      • 语音转文字
      • 已读消息(去除聊天小红点)
      • 发送引用消息
    • 群操作
      • 群设置
        • 设置群备注
        • 禁止修改群名
        • 群邀请确认
        • 移除群管理
        • 设置群管理
        • 获取群防骚扰规则列表
        • 设置或者移除群防骚扰规则
        • 获取群聊黑名单列表
        • 添加或者移除群聊黑名单
        • 禁止群内添加和禁止修改群名
      • 获取客户群列表
        POST
      • 获取群成员列表
        POST
      • 获取会话列表中的群聊
        POST
      • 同意进群
        POST
      • 二维码进群
        POST
      • 创建内部群聊
        POST
      • 创建外部群聊
        POST
      • 发送群公告
        POST
      • 修改群名
        POST
      • 发送链接的方式邀请成员进群
        POST
      • 直接邀请进群
        POST
      • 移除群成员
        POST
      • 设置群内昵称
        POST
      • 转让群主
        POST
      • 解散群
        POST
      • 获取群二维码
        POST
      • 获取欢迎语列表
        POST
      • 添加欢迎语
        POST
      • 设置欢迎语
        POST
      • 取消欢迎语
        POST
      • 添加群成员好友
        POST
      • 退出群聊
        POST
      • 获取群成员列表简洁版
        POST
      • 获取群详细和头像
        POST
      • 获取群头像
        POST
    • 开放平台
      • 企业用户id转开放平台id
      • 开放平台id转企业用户id
      • 群id转chatid
      • chatid转群id
    • 标签
      • 获取标签列表
      • 添加标签
      • 修改标签
      • 删除标签
      • 一个标签多个用户
      • 一个用户多个标签
    • CDN上传和大文件上传下载
      • 大文件
        • 获取大文件authkey
        • 大文件网络上传
        • 大文件上传
        • 大文件下载
        • 大文件下载参数获取
      • 图片
        • CDN上传网络图片
        • CDN上传本地图片
      • 视频
        • CDN上传网络视频
        • CDN上传本地视频
      • 文件和语音silk格式
        • CDN上传网络文件
        • CDN上传本地文件
      • CDN下载和个微文件下载
        • CDN下载文件
        • 外部联系人图片视频文件下载
    • 联系人操作
      • 添加方式
        • 根据手机号搜索联系人
        • 搜索添加外部联系人
        • 搜索添加企微用户
        • 根据名片添加好友
        • 直接添加好友(被删除过才能用)
      • 共享操作
        • 共享联系人
        • 添加共享联系人
      • 互联企业
        • 获取CircleIds
        • 获取互联企业成员部门列表
      • 企业互联
        • 获取企业互联组id
        • 获取企业互联成员部门企业列表
      • 获取内部联系人列表
      • 获取外部联系人列表
      • 根据用户id批量获取详细信息
      • 同意好友
      • 删除联系人
      • 获取好友申请列表
      • 获取置顶免打扰折叠标记列表
      • 获取会话列表
      • 修改联系人备注手机简介企业
      • 内部联系人备注修改
      • 获取内部联系人备注列表
      • 置顶设置或者取消
      • 免打扰设置或者取消
      • 免打扰并且折叠设置或者取消
      • 星星标记设置或者取消
      • 拉黑或者移除拉黑联系人
    • 账号基础操作
      • 获取当前账号详情
      • 获取当前账号二维码
      • 获取当前账号对外名片二维码
      • 设置头像
      • 设置用户信息
      • 设置是否自动同意
      • 根据企业id获取企业详情
      • 获取当前账号封禁原因
      • 上传图片到企微
    • 朋友圈
      • 获取朋友圈列表
      • 获取朋友圈详情
      • 发送朋友圈
      • 删除朋友圈
      • 发送朋友圈评论
      • 删除朋友圈评论
      • 朋友圈点赞或者取消点赞
    • 控制台群发
      • 确认群发消息
      • 获取未发送群发列表
      • 客户群发送任务,获取要发送的客户群列表
      • 获取群发任务详细信息
      • 朋友圈控制台任务执行
      • 管理员获取企业成员客户列表
    • 聊天标签
      • 增删改聊天标签
      • 获取聊天标签列表
      • 获取标签下的联系人
      • 新增联系人移除联系人到聊天标签
    • 客服管理
      • 获取客服列表
      • 获取客服详情
      • 获取客服当前状态
      • 设置客服接待状态
      • 获取咨询排队列表
      • 接入咨询排队列表中的客户
      • 获取转接的客服列表
      • 结束会话
      • 会话转接给其他同事
    • 商户收款
      • 获取商户列表
      • 获取收款二维码
      • 发送收款小程序
  • 接口消息下发
    • 登录
      • 扫码返回数据
      • 取消扫码返回
      • 确认扫码返回数据
      • 登录成功返回数据
      • 企业切换回调
      • 需要输入验证码消息回调
    • 消息
      • 文本消息接收
      • GIF表情消息接收
      • 小程序消息
      • 连接消息
      • 视频号消息
      • 名片消息
      • 位置消息
      • 外部联系人图片消息(个微发的)
      • 外部联系人文件消息
      • 外部联系人视频消息
      • 内部联系人图片消息(企业微信用户)
      • 内部联系人文件消息
      • 内部联系人视频消息
      • 红包消息
      • 语音消息
      • 语音或者视频通话消息
      • 语音或者视频通话,未接听消息
      • 语音或者视频通话,在其他端接听消息
      • 语音或者视频通话消息,对方取消通话
      • 语音视频通话时常消息通知
      • 撤回消息
      • 合并消息
      • 系统消息(发送失败封禁功能等提醒)
      • 接龙消息接收
      • 视频号直播消息
      • 内部联系人大文件消息
      • 新增客服聊天排队通知
    • 群
      • 群新增通知
      • 移除群成员通知
      • 邀请进群通知
      • 自己主动退出群聊通知(比如手机端退出或者其他端退出群聊)
      • 群名变更通知
      • 群主转让通知 等其他设置通知
      • 群管理员变动通知
      • 群解散通知
      • 群变动通知
    • 联系人
      • 联系人添加申请通知
      • 联系人变动通知
      • 内部联系人标签描述变动通知
      • 当前联系人已读消息通知回调
      • 联系人发消息提示删除通知
      • 联系人发消息提示拉黑通知
      • 置顶免打扰标记操作通知
    • 控制台下发任务消息
      • 控制台下发群发客户群任务消息
      • 控制台群发客户消息任务下发
      • 朋友圈控制台下发
    • 标签变动回调
      • 个人标签新增回调
      • 个人标签删除回调通知
      • 企业标签删除回调
      • 企业标签新增回调
    • 聊天标签
      • 聊天标签变动通知
      • 聊天标签中的联系人变动通知
    • 断开回调
      • 二次验证消息通知
      • 手机端结束登录
      • 当前账号在其他设备登录
      • 初始化接口二维码扫码超时断开
      • 异常断开
  1. 群操作

获取客户群列表

POST
http://47.94.7.218:8125/wxwork/GetChatroomMembers
责任人:Mrzhu0107
请求方式
POST
ContentType:”application/json”
参数
参数名 必选 类型 说明
uuid 是 String 每个实例的唯一标识,根据uuid操作具体企业微信

请求参数

Body 参数application/json必填

示例
{
    "uuid":"3240fde0-45e2-48c0-90e8-cb098d0ebe43",
    "limit":5, //每次查询数量
    "star_index":0  //第一次默认传0 根据返回值查询下一次的类似页码
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'http://47.94.7.218:8125/wxwork/GetChatroomMembers' \
--header 'Content-Type: application/json' \
--data '{
    "uuid":"3240fde0-45e2-48c0-90e8-cb098d0ebe43",
    "limit":5, //每次查询数量
    "star_index":0  //第一次默认传0 根据返回值查询下一次的类似页码
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "data": {
        "total": 7,
        "next_start": 5,
        "roomList": [
            {
                "room_id": 10696052955013024,
                "create_user_id": 0,
                "infoticket": "9FE241BC08F50F9A2FCBA692759B6FD8A5EA88B107787838AC06D1FE8D5835E04813EA38915241BCC181108D88408912D2A1C9D559384C0BEB261275B6EB7591",
                "update_time": 1650135314,
                "total": 4,
                "create_time": 1648889598,
                "nickname": "dddddddddddd",
                "roomurl": "https://wework.qpic.cn/wwpic/699045_06DbkaBSSVeLfTg_1652088785/0"
            },
            {
                "room_id": 10696052955013038,
                "create_user_id": 0,
                "infoticket": "8501CD1288CE0BE28ACEB6B1711D4EE864CB477C179F78B67E799DF07FE6166A6FDBAAF1D6962F2B4C3066DEF1E0B891A6B6496F41F4A34E5E59BE26571174F1",
                "update_time": 1648918889,
                "total": 2,
                "create_time": 1648889513,
                "nickname": "",
                "roomurl": "https://wework.qpic.cn/wwpic/984831_vJ5pBSAJS1uIL6C_1648889499/0"
            },
            {
                "room_id": 10696052955012990,
                "create_user_id": 0,
                "infoticket": "CDDC4E02A82DD6A2D24D40701CD0F155D5ADD102C7F9D5EE189C7EB51D3F4630058E85DCB9FC6143F8D496B31A17526B7702EE4FA9B6A674B136D788DD023E96",
                "update_time": 1647968439,
                "total": 3,
                "create_time": 1647945500,
                "nickname": "",
                "roomurl": "https://wework.qpic.cn/wwpic/559949_Rm-uPI04Tn6s_pW_1647526323/0"
            },
            {
                "room_id": 10696052955016139,
                "create_user_id": 0,
                "infoticket": "4C29DACB7C81D790B6F25FDC3DE05049C3342D915DAD9C397A41539F7C9970C748BE6D51B82D45D9CE733B866A066F09C52A2C0B87528A23CD7C9C1BC70C24EE",
                "update_time": 1612542878,
                "total": 2,
                "create_time": 1600888512,
                "nickname": "",
                "roomurl": "https://wework.qpic.cn/wwpic/507283_C4iEBcybRuyTAdE_1645840879/0"
            },
            {
                "room_id": 10696052955013729,
                "create_user_id": 0,
                "infoticket": "CDD6706E9079E87BC2235C88B822FFC97E3FAC7E8114D6874D1F1DD1EDC69C20DE8D90D1AFA32460D66623899CCEFD2D3D591ACDAB5AB55321D27E8B3DB2281A",
                "update_time": 1650655257,
                "total": 3,
                "create_time": 1594170855,
                "nickname": "",
                "roomurl": "https://wework.qpic.cn/wwpic/683942_iMOh0nrgSByS0WN_1650641660/0"
            }
        ]
    },
    "errcode": 0,
    "errmsg": "ok"
}

联系我们

如需功能验证或预开发请扫码进行报备即可

联系客服
修改于 2026-03-24 04:34:23
上一页
禁止群内添加和禁止修改群名
下一页
获取群成员列表
Built with