打开会话

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.

© 1998 - 2021 Tencent Inc. All Rights Reserved