第三方应用开发 客户端API JS-SDK 会话 分享消息到当前会话
分享消息到当前会话

调用该接口可从聊天工具栏或附件栏打开的页面中向当前会话发送消息,消息格式支持文本(“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端暂不支持)。
不同入口所需的权限说明
入口[getContext](#21951)的entry值自建应用第三方应用用户支持的最低版本
外部单聊工具栏single_chat_tools需有客户联系功能权限需有“企业客户权限->客户基础信息”权限配置了客户联系功能2.8.10
外部群聊工具栏group_chat_tools需有客户联系功能权限需有“企业客户权限->客户基础信息”权限配置了客户联系功能2.8.10
班级群的聊天工具栏group_chat_tools所有需有「家校沟通」使用权限所有3.0.36
聊天附件栏chat_attachment所有所有所有3.1.6(mac端暂不支持)
上一篇
聊天附件栏接口
下一篇
打开个人聊天窗口schema