第三方应用开发 客户端API 小程序 会话 wx.qy.updateCorpGroupChat
wx.qy.updateCorpGroupChat
最后更新:2022/09/23
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
wx.qy.updateCorpGroupChat
最后更新:2022/09/23

变更企业互联/上下游群成员接口

 

示例代码

wx.qy.updateCorpGroupChat({
   chatId: "CHATID", //通过企业微信创建群聊接口返回的chatId
    userIdsToAdd: ["lisi","lisi2"],    //新增的企业成员列表,仅自建应用使用,第三方应用会忽略该字段
	openUserIdsToAdd: ["wabc3","wbcde"],// 新增的企业成员列表,仅第三方应用使用,自建应用会忽略该字段
    corpGroupUserIdsToAdd: [ // 新增的企业互联/上下游成员列表
          {
              corpId:"ww3333",				 // 企业CORPID
			  userId:"userid123",				 // 成员ID,仅自建应用使用
			  openUserId:"wx1111"				 // 成员OPEN_USERID,仅第三方应用使用
          },
		  {
              corpId:"ww4444",				// 企业CORPID
			  userId:"userid123",				 // 成员ID,仅自建应用使用
			  openUserId:"wx1111"				 // 成员OPEN_USERID,仅第三方应用使用
          }
    ],
  success: (res) => {
      console.log(JSON.stringify(res))
  },
  fail: (res) => {
      console.log(JSON.stringify(res))
  }
})
此接口仅在企业微信3.1.8及以后版本支持
调用前提:必须先调用过wx.qy.login,且session_key未过期,开发者可调用checkSession 检查当前登录态
当前成员必须在应用的可见范围,且必须在该群内
仅支持往群里添加企业内部成员/企业互联/上下游成员
仅限企业互联/上下游企业可调用
当前成员为下游企业成员时,上下游空间中的"允许外部单位之间互相查看"需要打开才可以往群里添加其他下游企业成员

请求参数
Object object

属性类型是否必填说明
chatIdString指定的群会话id
userIdsToAddArray新增的企业成员列表,仅自建应用使用,第三方应用会忽略该字段
openUserIdsToAddArray新增的企业成员列表,仅第三方应用使用,自建应用会忽略该字段
corpGroupUserIdsToAddArray否(userIds和corpGroupUserIds至少填一个)参与会话的企业互联/上下游成员列表
corpGroupUserIdsToAdd.corpIdString企业互联/上下游企业corpId
corpGroupUserIdsToAdd.userIdString否(userId和openUserId至少填一个)企业互联/上下游企业成员userId, 仅自建应用返回
corpGroupUserIdsToAdd.openUserIdString否(userId和openUserId至少填一个)企业互联/上下游企业成员openUserId,仅第三方应用使用返回
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数

错误列表

res.errMsg说明
updateCorpGroupChat:ok执行成功
updateCorpGroupChat:fail no session or expired没有调用 wx.qy.login,或者 session_key 已过期
updateCorpGroupChat:fail exceed user id list size超过人数上限
updateCorpGroupChat:fail invalid parameter参数不合法
updateCorpGroupChat:fail unsupported chat不支持群类型,目前仅支持企业互联/上下游群
上一篇
wx.qy.createCorpGroupChat
下一篇
wx.qy.getNFCReaderState