企业内部开发 客户端API JS-SDK 会话 打开会话
打开会话
最后更新:2022/10/14
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
打开会话
最后更新:2022/10/14
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将无法正确的识别。

 

上一篇
聊天工具栏接口
下一篇
变更群成员