调用该接口可从聊天工具栏或附件栏打开的页面中向当前会话发送消息,消息格式支持文本(“text”),图片(“image”),视频(“video”),文件(“file”),H5(“news”)和小程序(“miniprogram”)
wx.invoke('sendChatMessage', {
msgtype:"text", //消息类型,必填
enterChat: true, //为true时表示发送完成之后顺便进入会话,仅移动端3.1.10及以上版本支持该字段
text: {
content:"你好", //文本内容
},
image:
{
mediaid: "", //图片的素材id
},
video:
{
mediaid: "", //视频的素材id
},
file:
{
mediaid: "", //文件的素材id
},
news:
{
link: "", //H5消息页面url 必填
title: "", //H5消息标题
desc: "", //H5消息摘要
imgUrl: "", //H5消息封面图片URL
},
miniprogram:
{
appid: "wx8bd80126147df384",//小程序的appid,企业已关联的任一个小程序
title: "this is title", //小程序消息的title
imgUrl:"https://search-operate.cdn.bcebos.com/d054b8892a7ab572cb296d62ec7f97b6.png",//小程序消息的封面图。必须带http或者https协议头,否则报错 $apiName$:fail invalid imgUrl
page:"/index/page.html", //小程序消息打开后的路径,注意要以.html作为后缀,否则在微信端打开会提示找不到页面
},
}, function(res) {
if (res.err_msg == 'sendChatMessage:ok') {
//发送成功
}
})
1. 必须先成功调用agentConfig,否则调用时会报“no permission”错误。
2. media_id可以通过素材管理接口获得,暂不支持公众平台的mediaid。
3. 需要从特定入口进入页面才可调用,否则会报错:without context of external contact,可先通过调用getContext来判断进入小程序的入口,允许调用的入口说明参见“不同入口所需的权限说明”。
4. 从不同的入口进入的页面,应用需要满足相应用的权限,否则会报“no permission”错误,所需的权限参见“不同入口所需的权限说明”。
5. 企业微信3.1.0及以后版本支持小程序类型的消息格式(mac端从4.1.26版本开始支持)。
入口 | [getContext](#21951)的entry值 | 自建应用 | 第三方应用 | 用户 | 支持的最低版本 |
---|---|---|---|---|---|
外部单聊工具栏 | single_chat_tools | 需有客户联系功能权限 | 需有“企业客户权限->客户基础信息”权限 | 配置了客户联系功能 | 2.8.10 |
外部群聊工具栏 | group_chat_tools | 需有客户联系功能权限 | 需有“企业客户权限->客户基础信息”权限 | 配置了客户联系功能 | 2.8.10 |
班级群的聊天工具栏 | group_chat_tools | 所有 | 需有「家校沟通」使用权限 | 所有 | 3.0.36 |
学生群的聊天工具栏 | group_chat_tools | 所有 | 需有「家校沟通」使用权限 | 所有 | 4.0.8 |
聊天附件栏 | chat_attachment | 所有 | 所有 | 所有 | 3.1.6(mac端暂不支持) |