企业内部开发
小程序
基础
连接微信
办公
WECOM-JSSDK
JS-SDK
基础
连接微信
办公
企业内部开发
客户端API
WECOM-JSSDK
微信客服
向当前会话发送消息
向当前会话发送消息
最后更新:2023/10/20

ww.sendChatMessage(params)

兼容性:企业微信 2.8.10 开始支持

功能描述

从聊天工具栏或附件栏打开的页面中向当前会话发送消息。

ww.sendChatMessage({
  msgtype: 'text',
  text: {
    content: '你好'
  }
})

参数说明

params: Object

可能为以下类型

属性类型默认值必填说明最低版本
enterChatboolean

发送完成后进入会话

企业微信 3.1.10

msgtype"text"

消息类型

textObject
属性类型默认值必填说明最低版本
contentstring

文本内容

successFunction

成功回调

failFunction

失败回调

cancelFunction

取消回调

completeFunction

完成回调

属性类型默认值必填说明最低版本
enterChatboolean

发送完成后进入会话

企业微信 3.1.10

msgtype"miniprogram"

消息类型

企业微信 iOS、Android、PC 3.1.0

miniprogramObject
属性类型默认值必填说明最低版本
appidstring

小程序的appid

titlestring

小程序消息的title

imgUrlstring

小程序消息的封面图,必须带 http 或 https 协议头

pagestring

小程序消息打开后的路径,注意要以 .html 作为后缀

successFunction

成功回调

failFunction

失败回调

cancelFunction

取消回调

completeFunction

完成回调

属性类型默认值必填说明最低版本
enterChatboolean

发送完成后进入会话

企业微信 3.1.10

msgtype"video"

消息类型

videoObject
属性类型默认值必填说明最低版本
mediaidstring

视频的素材 ID

可以通过素材管理接口获得,暂不支持公众平台的 mediaid

successFunction

成功回调

failFunction

失败回调

cancelFunction

取消回调

completeFunction

完成回调

属性类型默认值必填说明最低版本
enterChatboolean

发送完成后进入会话

企业微信 3.1.10

msgtype"file"

消息类型

fileObject
属性类型默认值必填说明最低版本
mediaidstring

文件素材 ID

可以通过素材管理接口获得,暂不支持公众平台的 mediaid

successFunction

成功回调

failFunction

失败回调

cancelFunction

取消回调

completeFunction

完成回调

属性类型默认值必填说明最低版本
enterChatboolean

发送完成后进入会话

企业微信 3.1.10

msgtype"news"

消息类型

newsObject
属性类型默认值必填说明最低版本
linkstring

页面 URL

titlestring

卡片标题

descstring

卡片摘要

imgUrlstring

封面图片URL

successFunction

成功回调

failFunction

失败回调

cancelFunction

取消回调

completeFunction

完成回调

属性类型默认值必填说明最低版本
enterChatboolean

发送完成后进入会话

企业微信 3.1.10

msgtype"msgmenu"

消息类型

企业微信 iOS、Android 3.1.12,企业微信 PC 3.1.20

msgmenuObject
属性类型默认值必填说明最低版本
head_contentstring

起始文本

listObject[]

菜单项配置列表

可能为以下类型

属性类型默认值必填说明最低版本
type"click"

菜单类型

clickObject
属性类型默认值必填说明最低版本
idstring

菜单 ID

contentstring

菜单显示内容

属性类型默认值必填说明最低版本
type"view"

菜单类型

viewObject
属性类型默认值必填说明最低版本
urlstring

点击后跳转的链接

contentstring

菜单显示内容

属性类型默认值必填说明最低版本
type"miniprogram"

菜单类型

miniprogramObject
属性类型默认值必填说明最低版本
appidstring

小程序的 appid

pagestring

小程序消息打开后的路径

contentstring

小程序消息的 title

successFunction

成功回调

failFunction

失败回调

cancelFunction

取消回调

completeFunction

完成回调

属性类型默认值必填说明最低版本
enterChatboolean

发送完成后进入会话

企业微信 3.1.10

msgtype"image"

消息类型

imageObject
属性类型默认值必填说明最低版本
mediaidstring

图片的素材 ID

successFunction

成功回调

failFunction

失败回调

cancelFunction

取消回调

completeFunction

完成回调

返回说明

Promise<Object>

属性类型默认值必填说明最低版本
errMsgstring

通用错误信息

errCodenumber

通用错误码

使用限制

  • 仅从特定入口进入页面才可调用

  • 不同的入口对应用及用户有相应的限制

    getContext 接口返回的 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端暂不支持)

上一篇设置朋友圈封面与签名
下一篇调起微信客服消息界面
    本节内容
服务端API
基础
连接微信
办公
会议
会议统计管理
客户端API
小程序
基础
连接微信
办公
WECOM-JSSDK
JS-SDK
基础
连接微信
办公
更新日志
联系我们