登录
基础
连接微信
办公基础连接微信办公目录
兼容性：企业微信 3.1.8 开始支持
向用户申请给指定范围发送消息。
调用接口后，用户可在选人界面对群聊范围进行修改，当创建群聊成功时会返回新建的群聊 ID。
ww.createChatWithMsg({
selectedOpenUserIds: ['zhangsan','lisi'],
selectedTickets: ['tick1','token2'],
chatName: 'discussName',
msg: {
msgtype: 'link',
link: {
title: 'title1',
desc: 'desc1',
url: 'link1',
imgUrl: 'imgurl1'
}
}
})仅第三方应用（非通讯录应用）与代开发应用可调用
本接口必须使用应用身份进行注册
| 属性 | 类型 | 必填 | 说明 | ||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| selectedOpenUserIds | string | 否 | 群聊指定的用户 OpenUserID 列表 | ||||||||||||||||||||||||||||||||||||||||||||||
| selectedTickets | string[] | 否 | 群聊指定的 selectedTicket 列表 可通过 selectPrivilegedContact 接口获取 | ||||||||||||||||||||||||||||||||||||||||||||||
| chatName | string | 是 | 新建群聊指定的群名 | ||||||||||||||||||||||||||||||||||||||||||||||
| msg | Object | 否 | 发送的链接消息 | ||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||
| success | Function | 否 | 成功回调 | ||||||||||||||||||||||||||||||||||||||||||||||
| fail | Function | 否 | 失败回调 | ||||||||||||||||||||||||||||||||||||||||||||||
| cancel | Function | 否 | 取消回调 | ||||||||||||||||||||||||||||||||||||||||||||||
| complete | Function | 否 | 完成回调 | ||||||||||||||||||||||||||||||||||||||||||||||
Promise<Object>
| 属性 | 类型 | 必填 | 说明 | |
|---|---|---|---|---|
| errMsg | string | 是 | 通用错误信息 | |
| errCode | number | 是 | 通用错误码 | |
| chatId | string | 否 | 新建群聊时返回对应的群聊 ID 当发送的范围只有 1 人时，不会新建群聊，此时不返回 chatId |
| errMsg | 说明 |
|---|---|
| createChatWithMsg:ok | 执行成功 |
| createChatWithMsg:fail_unsupported_msgtype | msgtype不合法 |
| createChatWithMsg:fail_msg_link_missing_url | msg.link.url未传入 |
接口定义
wx.invoke("createChatWithMsg", {
selectedOpenUserIds: ["zhangsan","lisi"],
selectedTickets: ["tick1","token2"],
chatName: "discussName",
msg: {
msgtype: "link",
link: {
title: "title1",
desc: "desc1",
url: "link1",
imgUrl: "imgurl1"
}
}
},function(res){
if (res.err_msg == "createChatWithMsg:ok")
{
var chatId = res.chatId; // 新建的会话ID，当会话为单聊时不返回此字段
}
}
);
基础连接微信办公基础连接微信办公基础连接微信办公