这篇文章介绍一下目前企业微信所支持的推送消息的格式和使用方法,大部分内容来源于添加机器人后自带的配置说明文档。
使用说明:
key是此机器人证明身份的标志,需要仔细保存Content-Type使用json格式json格式的消息类型(msgtype)支持text(文本)、image(图片)、markdown、news(图文)注:本文使用的示例中的key的信息均为企业微信说明中提供
文本类型消息格式说明 说明示例 { "msgtype": "text", "text": { "content": "广州今日天气:29度,大部分多云,降雨概率:60%", "mentioned_list":["wangqing","@all"], "mentioned_mobile_list":["13800001111","@all"] }} 参数是否必填说明msgtype是消息类型,此时固定为textcontent是文本内容,最长不超过2048个字节,必须是utf8编码mentioned_list否userid的列表,提醒群中的指定成员(@某个成员),@all表示提醒所有人,如果开发者获取不到userid,可以使用mentioned_mobile_listmentioned_mobile_list否手机号列表,提醒手机号对应的群成员(@某个成员),@all表示提醒所有人追加说明:
mentioned_list中的"userid列表"中的userid,如果使用微信号注册的企业微信,请注意此id为在此群中的企业微信中的id而不是微信号,需要单独@多个人的时候格式为"userid1","userid2"以逗号隔开
mentioned_mobile_list中的手机也是此微信群中的用户的手机号码,如果信息不对应时@操作会无法提醒。
目前只支持部分markdown语法,所支持的内容如下
标题 (支持1至6级标题,注意#与文字中间要有空格) # 标题一## 标题二### 标题三#### 标题四##### 标题五###### 标题六 加粗 **bold** 链接 [这是一个链接](http://work.weixin.qq.com/api/doc) 行内代码段(暂不支持跨行) `code` 引用 > 引用文字 字体颜色(只支持3种内置颜色) <font color="info">绿色</font><font color="comment">灰色</font><font color="warning">橙红色</font> 图片类型消息格式说明 说明示例 { "msgtype": "image", "image": { "base64": "DATA", "md5": "MD5" }} 参数是否必填说明msgtype是消息类型,此时固定为imagebase64是图片内容的base64编码md5是图片内容(base64编码前)的md5值注:图片(base64编码前)最大不能超过2M,支持JPG,PNG格式
图文类型消息格式说明 说明示例 { "msgtype": "news", "news": { "articles" : [ { "title" : "中秋节礼品领取", "description" : "今年中秋节公司有豪礼相送", "url" : "URL", "picurl" : "http://res.mail.qq.com/node/ww/wwopenmng/images/independent/doc/test_pic_msg1.png" } ] }} 参数是否必填说明msgtype是消息类型,此时固定为newsarticles是图文消息,一个图文消息支持1到8条图文title是标题,不超过128个字节,超过会自动截断description否描述,不超过512个字节,超过会自动截断url是点击后跳转的链接。picurl否图文消息的图片链接,支持JPG、PNG格式,较好的效果为大图 1068*455,小图150*150。消息发送频率限制每个机器人发送的消息不能超过20条/分钟。
推送消息白名单配置为了防止被盗用,可以结合机器人提供的白名单功能进行设定,可设定用于推送消息的IP白名单地址,如果不设定,默认不做限制
企业微信群机器人使用配置说明