该接口允许打开一个已有的群聊,同时传入一条link消息(消息是可选的),并且支持打开各种会话,包括企业内部群、外部群、互联群。
接口定义
wx.invoke("openExistedChatWithMsg", {
chatId: "chatId123",
msg: {
msgtype: "link",
link: {
title: "title1",
desc: "desc1",
url: "link1",
imgUrl: "imgurl1"
}
}
},function(res){
if (res.err_msg == "openExistedChatWithMsg:ok")
{
}
}
);
此接口仅在企业微信3.1.8及以后版本支持,微信端不支持(微信开发者工具也不支持)。
必须先成功调用agentConfig,否则调用时会报“no permission”错误。
传入参数
参数名 | 类型 | 是否必须 | 说明 | 企业微信版本要求 |
---|---|---|---|---|
chatId | String | 是 | 打开的群聊ID | ≥3.1.8 |
msg | Message | 否 | 发送的链接消息。若不传msg,则表示仅进入群聊,不发消息。 | 移动端: ≥3.1.8 桌面端: ≥4.0.2 |
Message
参数名 | 类型 | 是否必须 | 说明 |
---|---|---|---|
msgtype | String | 是 | 目前只支持链接消息,固定填link |
link | LinkMessage | msgtype=="link"必填 | 链接消息内容 |
LinkMessage
参数名 | 类型 | 是否必须 | 说明 |
---|---|---|---|
title | String | 否 | 标题 |
desc | String | 否 | 描述 |
url | String | 是 | 链接 |
imgUrl | String | 否 | 封面图 |
返回结果json示例说明
{
"err_msg":"openExistedChatWithMsg:ok"
}
返回参数
参数名 | 类型 | 是否必须 | 说明 |
---|---|---|---|
err_msg | String | 是 | 调用成功时返回 openExistedChatWithMsg:ok 若msgtype不合法,返回 openExistedChatWithMsg:fail_unsupported_msgtype 若msgtype==link且msg.link.url未传,返回 openExistedChatWithMsg:fail_msg_link_missing_url |