持续集成之企业微信通知:2:推送消息格式说明
生活随笔
收集整理的這篇文章主要介紹了
持续集成之企业微信通知:2:推送消息格式说明
小編覺得挺不錯的,現在分享給大家,幫大家做個參考.
這篇文章介紹一下目前企業微信所支持的推送消息的格式和使用方法,大部分內容來源于添加機器人后自帶的配置說明文檔。
推送消息示例
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 |
| content | 是 | 文本內容,最長不超過2048個字節,必須是utf8編碼 |
| mentioned_list | 否 | userid的列表,提醒群中的指定成員(@某個成員),@all表示提醒所有人,如果開發者獲取不到userid,可以使用mentioned_mobile_list |
| mentioned_mobile_list | 否 | 手機號列表,提醒手機號對應的群成員(@某個成員),@all表示提醒所有人 |
追加說明:
mentioned_list中的"userid列表"中的userid,如果使用微信號注冊的企業微信,請注意此id為在此群中的企業微信中的id而不是微信號,需要單獨@多個人的時候格式為"userid1","userid2"以逗號隔開
mentioned_mobile_list中的手機也是此微信群中的用戶的手機號碼,如果信息不對應時@操作會無法提醒。
markdown類型消息格式說明
- 說明示例
| msgtype | 是 | 消息類型,此時固定為markdown |
| content | 是 | 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 |
| base64 | 是 | 圖片內容的base64編碼 |
| md5 | 是 | 圖片內容(base64編碼前)的md5值 |
注:圖片(base64編碼前)最大不能超過2M,支持JPG,PNG格式
圖文類型消息格式說明
- 說明示例
| msgtype | 是 | 消息類型,此時固定為news |
| articles | 是 | 圖文消息,一個圖文消息支持1到8條圖文 |
| title | 是 | 標題,不超過128個字節,超過會自動截斷 |
| description | 否 | 描述,不超過512個字節,超過會自動截斷 |
| url | 是 | 點擊后跳轉的鏈接。 |
| picurl | 否 | 圖文消息的圖片鏈接,支持JPG、PNG格式,較好的效果為大圖 1068*455,小圖150*150。 |
消息發送頻率限制
每個機器人發送的消息不能超過20條/分鐘。
推送消息白名單配置
為了防止被盜用,可以結合機器人提供的白名單功能進行設定,可設定用于推送消息的IP白名單地址,如果不設定,默認不做限制
參考內容
企業微信群機器人使用配置說明
總結
以上是生活随笔為你收集整理的持续集成之企业微信通知:2:推送消息格式说明的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: Zabbix 事件通知机制之微信通知
- 下一篇: 常用的系统操作响应时间