发送应用消息
POST
/cgi-bin/message/send
服务端API企业内部开发第三方应用开发智慧硬件开发
- 如果有在管理端对应用设置“在微工作台中始终进入主页”，应用在微信端只能接收到文本消息，并且文本消息的长度限制为20字节，超过20字节会被截断。同时其他消息类型也会转换为文本消息，提示用户到企业微信查看。
- 支持id转译，将userid/部门id转成对应的用户名/部门名，目前仅文本/文本卡片/图文/图文（mpnews）/任务 卡片/小程序通知/模版消息/模板卡片消息这八种消息类型的部分字段支持。仅第三方应用需要用到，企业自建应用可以忽略。具体支持的范围和语法，请查看附录id转译说明。
- 支持重复消息检查，当指定
"enable_duplicate_check": 1开启: 表示在一定时间间隔内，同样内容（请求json）的消息，不会重复收到；时间间隔可通过duplicate_check_interval指定，默认1800秒。- 从2021年2月4日开始，企业关联添加的「小程序」应用，也可以发送文本、图片、视频、文件、图文等各种类型的消息了。
调用建议：大部分企业应用在每小时的0分或30分触发推送消息，容易造成资源挤占，从而投递不够及时，建议尽量避开这两个时间点进行调用。
权限包含应用可见范围和基础接口权限(基础账号、互通账号均可)，unlicenseduser中的用户在应用可见范围内但没有基础接口权限。
如果全部接收人无权限或不存在，则本次调用返回失败，errcode为81013。
返回包中的userid，不区分大小写，统一转为小写
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://qyapi.weixin.qq.com/cgi-bin/message/send' \
--header 'Content-Type: application/json' \
--data-raw ''响应示例响应示例
{
"errcode": 0,
"errmsg": "ok",
"invaliduser": "userid1|userid2",
"invalidparty": "partyid1|partyid2",
"invalidtag": "tagid1|tagid2",
"unlicenseduser": "userid3|userid4",
"msgid": "xxxx",
"response_code": "xyzxyz"
}请求参数
Query 参数
access_token
可选
示例值:
{{accesstoken}}
random
可选
示例值:
69152
Body 参数application/json
返回响应
扫码加入交流群修改于 2022-12-06 07:46:01