Contents
1. 场景描述
2. 实现方案
- 2.1 企业微信群机器人
- 2.2 DevOps 服务挂钩Web Hooks
1. 场景描述
由于企业内部员工在广泛使用腾讯”企业微信“发送实时消息，作为生产问题管理员，希望生产问题的状态出现变化时（例如新建或已解决时），对应用户可以在企业微信中得到实时通知。
2. 实现方案
2.1 企业微信群机器人
在企业微信的开放技术中，微信群机器人用于集成第三方系统，自动发送消息到企业微信群的方法。所谓机器人，实际上是企业微信的一个开放接口，可以接受外部系统发送过来的消息，并将接受到的消息展现在企业微信群中。我们可以通过下面的方式创建企业微信群机器人：
当参考上面的方式新建了一个企业微信群机器人后，我们可以看到这个机器人对应的api和专有的key（注意要对key保密，否则别人就能利用这个可以冒充你发送消息），并且可以做一些发送消息的测试：
例如，我们将上面的接口和参数配置到postman中，就可以将信息发送到企业微信群中，如下图： 
- 文字消息
{
"msgtype": "text",
"text": {
"content": "简称ADO Server，原名TFS，是微软公司Azure DevOps产品在企业内网部署运行的研发管理平台产品；为信息技术团队提供软件研发过程管理、文档和源代码管理、持续集成和自动部署、质量控制和测试等全过程的功能模块。"
}
}- 卡片消息
{
"msgtype": "news",
"news": {
"articles" : [
{
"title" : "Azure DevOps Server",
"description" : "简称ADO Server，原名TFS，是微软公司Azure DevOps产品在企业内网部署运行的研发管理平台产品；为信息技术团队提供软件研发过程管理、文档和源代码管理、持续集成和自动部署、质量控制和测试等全过程的功能模块。",
"url" : "",
"picurl" : "https://tse2-mm.cn.bing.net/th/id/OIP-C.OXJG75OTVJ2eN2rEouzFfwHaCD?pid=ImgDet&rs=1"
}
]
}
}发送成功后，我们可以看到下图中类似的消息截图：
2.2 DevOps 服务挂钩Web Hooks
Azure DevOps Server 有非常完善而且强大的服务器挂钩功能，可以在多种事件（工作项变更、代码提交、流水线运行等）Events发生时，将对应的数据通过服务挂钩的方式发，自动送到第三方系统（如下图）。
在Azure DevOps Server的服务挂钩设计中，原生支持多种应用程序，例如Microsoft Teams，Jenkins，HiChat, Slack等；但是非常遗憾，目前它还不支持我们常用的企业微信、钉钉等国产软件。
由于服务挂钩推送的json数据结构与企业微信群机器人的结构不一致，我们不能直接将企业微信群机器人的接口Url直接配置在服务挂钩中，需要我们自定义一个接口程序，用于将服务挂钩发出的json数据转换为企业微信支持的输入结构。例如我们在使用过程中，自己使用C#编写了一个接口（http://my-api-server/api/QyWechatRobot?url=https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key={wechat-token} ；我们将这个接口配置在DevOps Server的服务挂钩中。如果你在使用专门用于webhook调试和转换的云服务 https://webhook.site/ ，直接使用它的数据转换功能，无需自己开发接口。
完成上面的开放和配置后，我们在企业微信群中，就能收到来自Azure DevOps Server的自动通知。
如果需要，你还可以从微软Azure DevOps Server 的在线文档，查询更多的权威资料，也欢迎通过下面的联系方式与我沟通，相互学习，相互提高！
Azure DevOps MVP 张洪君
