持续集成之钉钉消息推送：2:推送消息格式说明

这篇文章介绍一下目前企业微信所支持的推送消息的格式和使用方法，大部分内容与消息示例均来源于目前钉钉的开发文档。

推送消息示例

curl 'https://oapi.dingtalk.com/robot/send?access_token=xxxxxxxx' \
   -H 'Content-Type: application/json' \
   -d '{
   "msgtype": "text", 
        "text": {
   
             "content": "我就是我, 是不一样的烟火"
        }
      }'

使用说明：

• access_token是此机器人证明身份的标志，需要仔细保存
• Content-Type使用json格式
• json格式的消息类型（msgtype）支持text（文本）、link(链接)、markdown、ActionCard、FreeCard。

注：本文使用的示例中的key的信息均为企业微信说明中提供

文本类型消息格式说明

• 说明示例

{
   
    "msgtype": "text", 
    "text": {
   
        "content": "我就是我, 是不一样的烟火@156xxxx8827"
    }, 
    "at": {
   
        "atMobiles": [
            "156xxxx8827", 
            "189xxxx8325"
        ], 
        "isAtAll": false
    }
}

参数	参数类型	必须	说明
msgtype	String	是	消息类型，此时固定为：text
content	String	是	消息内容
atMobiles	Array	否	被@人的手机号(在content里添加@人的手机号)
isAtAll	bool	否	@所有人时：true，否则为：false

补充说明：与企业微信功能相比较，最简单方式下实现几乎一模一样，不过钉钉没有提供按照userid方式来进行@的功能，而且将@所有人明示地做为一项设定也是略有不同，不过有一点就是需要@时既需要在atMobiles中写上被@者的手机号，在contents里也需要写上，大概功能设计者的思路是at中的atMobiles列表的作用是和isAtAll相关联，而单个的@功能则需要在contents中写明。

link类型消息格式说明

• 说明示例

{
   
    "msgtype"