wx.openEnterpriseChat({
// 注意:userIds和externalUserIds至少选填一个。内部群最多2000人;外部群最多500人;如果有微信联系人,最多40人
userIds: 'zhangsan;lisi;wangwu', //参与会话的企业成员列表,格式为userid1;userid2;...,用分号隔开。
externalUserIds: 'wmEAlECwAAHrbWYDOK5u3Bf13xlYDAAA;wmEAlECwAAHibWYDOK5u3Af13xlYDAAA', // 参与会话的外部联系人列表,格式为userId1;userId2;…,用分号隔开。
groupName: '讨论组', // 会话名称。单聊时该参数传入空字符串""即可。
chatId: "CHATID", // 若要打开已有会话,需指定此参数。如果是新建会话,chatId必须为空串
success: function(res) {
var chatId = res.chatId; //返回当前群聊ID,仅当使用agentConfig注入该接口权限时才返回chatId
// 回调
},
fail: function(res) {
if(res.errMsg.indexOf('function not exist') > -1){
alert('版本过低请升级')
}
}
});
此接口在企业微信2.0及以后版本支持,externalUserIds参数仅在企业微信2.4.20及以后版本支持,externalUserIds由外部联系人选人接口selectExternalContact获得;
如果创建的会话有微信联系人,群成员人数不能超过40人。
在企业微信3.0.36及以上的版本,若有成功调用agentConfig,则创建会话成功之后会返回chatId。
在企业微信3.0.36及以上的版本,若有成功调用agentConfig,则支持传入chatId打开已有的会话,此时会忽略userIds、externalUserIds与groupName参数。注意:目前仅支持打开客户群,若不是客户群,将报错 unsupported chat.
由于企业微信账号ID已全面升级,第三方应用与代开发应用必须先成功调用agentConfig,否则传入的userIds与externalUserIds将无法正确的识别。