企业微信通知api,微信发布会议通知格式

这篇文章介绍一下目前企业微信所支持的推送消息的格式和使用方法,大部分内容来源于添加机器人后自带的配置说明文档。

推送消息示例 curl ‘https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=633a31f6-7f9c-4bc4-97a0-0ec1eefa5898’ \ -H ‘Content-Type: application/json’ \ -d ‘ { “msgtype”: “text”, “text”: { “content”: “hello world” } }’

使用说明:

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类型消息格式说明 说明示例 { “msgtype”: “markdown”, “markdown”: { “content”: “实时新增用户反馈<font color=\”warning\”>132例</font>,请相关同事注意。\n >类型:<font color=\”comment\”>用户反馈</font> \n >普通用户反馈:<font color=\”comment\”>117例</font> \n >VIP用户反馈:<font color=\”comment\”>15例</font>” }} 参数是否必填说明msgtype是消息类型,此时固定为markdowncontent是markdown内容,最长不超过4096个字节,必须是utf8编码markdown语法支持

目前只支持部分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白名单地址,如果不设定,默认不做限制

参考内容

企业微信群机器人使用配置说明

Published by

风君子

独自遨游何稽首 揭天掀地慰生平

发表回复

您的电子邮箱地址不会被公开。 必填项已用 * 标注