企业微信机器人发送 Markdown 消息及表格支持

结论

1. V1 接口可以圈人，但是无法正确展示表格的 Markdown 语法。
2. V2 接口可以展示表格的 Markdown 语法，但是无法圈人。
3. 企微消息有长度限制。

背景

目前机器人通知的内容太单调了，无法满足告警提醒的作用，需要罗列表格进行对比，需要艾特到具体人。目标是生成数据对比表格，然后艾特到具体的人来跟进事物的变化。

解决方案

如何支持 Markdown 表格类型

1. 企业微信从 4.1.38 开始支持 Markdown 表格的语法了。可以参看官方文档 4.1.38 版本新功能介绍。 所以企业客户端要升级。
2. 历史使用的是 msgtype: 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>" } }

3. 需要使用 markdown_v2 的接口才能支持。

{ "msgtype": "markdown_v2", "markdown_v2": { "content": "# 一、标题\n## 二级标题\n### 三级标题\n# 二、字体\n*斜体*\n\n**加粗**\n# 三、列表 \n- 无序列表 1 \n- 无序列表 2\n - 无序列表 2.1\n - 无序列表 2.2\n1. 有序列表 1\n2. 有序列表 2\n# 四、引用\n> 一级引用\n>>二级引用\n>>>三级引用\n# 五、链接\n[这是一个链接](https:work.weixin.qq.com\/api\/doc)\n![](https://res.mail.qq.com/node/ww/wwopenmng/images/independent/doc/test_pic_msg1.png)\n# 六、分割线\n\n---\n# 七、代码\n`这是行内代码`\n```\n这是独立代码块\n```\n\n# 八、表格\n| 姓名 | 文化衫尺寸 | 收货地址 |\n| :----- | :----: | -------: |\n| 张三 | S | 广州 |\n| 李四 | L | 深圳 |\n" } }

具体支持那些可以参看 markdown_v2 类型入参说明。

如何艾特人

V2 的接口明确说了不支持 @群成员的语法，这就是鱼和熊掌不可兼得么。 这里需要使用 Markdown 类型。

{ "msgtype": "markdown", "markdown": { "content": "实时新增用户反馈<font color=\"warning\">132 例</font><@userId>" }

语法就是： 这里可以用 userId, enterpiseWeChatId 这个 ID 也可以。

<@userID> 

参考资料： https://work.weixin.qq.com/nl/act/p/934e08ec64874715?ver=4.1.38&type=mng&lang=zh&scene=undefined