在钉钉平台中，机器人主要分为企业机器人和自定义机器人两类。本文将重点介绍如何通过自定义机器人，实现将知行之桥 EDI 系统的通知消息高效推送至钉钉群，帮助企业第一时间掌握业务动态。
一、在钉钉群中添加自定义机器人
在需要接收知行之桥消息的钉钉群组中，找到 群设置->机器人，按照下图所示内容，添加一个自定义机器人。
添加机器人的时候，在上述页面中需要进行安全设置，用户可以选择 自定义关键词、加签以及IP地址（段）的安全方式。
更多可参考：创建自定义机器人
二、获取已添加机器人的Webhook地址：
在群设置->机器人中，找到我们刚刚添加的机器人。
更多可参考：获取自定义机器人的Webhook地址
特别提醒：请妥善保管机器人的 Webhook 地址，避免泄露。切勿公开在 GitHub、博客等平台，否则可能被不法分子利用，导致机器人被用于发送垃圾信息。
三、知行之桥设置
在知行之桥EDI系统中，创建一个REST 端口，在 设置 选项卡下，需要完成以下配置：
1.设置 操作 为：Transform
2.将 方法 设置为 POST，将机器人的webhook地址配置在REST端口的URL处。
注意：每个机器人的URL 不一样，实际使用时请使用实际机器人的webhook地址即可
3.头部配置：设置 名称 为：Content_Type，值 设置为：application/json
4.正文配置：设置 正文类型 为 raw,Content Type 设置为：JSON（application/json）
四、通过钉钉机器人发消息
至此，就可以通过钉钉机器人发消息了，钉钉自定义机器人支持六种消息类型，包括Text文本类型、Link链接消息、Markdown 类型、整体跳转 ActionCard 类型、独立跳转 ActionCard 类型、FeedCard 类型，消息类型对比可参考：自定义机器人发送消息的消息类型
以发送文本消息为例，要实现钉钉通知，需要传输的json文件格式如下所示：
| 1 2 3 4 5 6 7 | {"text":{ "content":"IRIS,123" }, "msgtype":"text"} |
将上述文件上传至知行之桥REST端口的 输入 选项卡下：
文件成功发出后，在设置了自定义机器人的钉钉群中可以收到以下消息：
注意：为了保证安全性，钉钉强制使用一种安全方式，本次演示使用的是关键字方式：
更多说明：自定义机器人安全设置
五、EDI 消息提醒推送
接下来以接收一个850采购订单为例，为大家演示如何实现钉钉通知。
1.在接收端口（比如AS2）后新增一个报文转换端口（比如X12），报文转换后需要增加XML MAP端口，XML MAP端口后新增JSON端口，最后以REST端口作为工作流的结尾，形成这样的工作流：
2.在XML MAP中进行数据提取和格式调整
我们以850采购订单为例，在XML Map端口需要选择来源模板文件和目标模板文件，来源模板文件我们以最常见的00401为例，目标模板文件是将调用钉钉接口的json转换得到xml。以下是一个目标模板文件示例：
| 1 2 3 4 5 6 | <Items xmlns:json="http://arc.cdata.com/ns/jsonconnector" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <msgtype>text</msgtype> <text> <content>hello world</content> </text> </Items> |
上传好来源模板文件和目标模板文件后，首先需要将来源模板中的TX-00401-850节点拖拽到目标模板中的Items上，接下来找到来源模板中存放采购订单编号信息的BEG03节点，将其拖拽到目标模板中的 content上，如下所示：
注：用户可以在知行EDI规范查询平台中，查询EDI报文各个字段的含义，本次示例中需要的采购订单编号，对应EDI 850报文中的BEG03节点。
接下来点击上图content节点的 编辑节点 按钮，编辑节点值，为这个映射添加关键字PO，令content元素的值为PO:[xpath("BEG/BEG03")]，这样设置的目的是，钉钉群组通知格式将会变成，PO:实际的采购订单编号。用户可以根据实际业务需求，修改这里的文字描述。
在此弹窗页面中点击 应用，在XML Map端口点击右上角的 保存 按钮，保存当前映射结果。上述操作完成后，即可提取PO号码，并且用文本类型将PO推送到钉钉群。
接下来回到当前工作流的X12端口，在 输入 选项卡下上传一个测试的850文件，文件将会被自动处理，用户可以在钉钉群中查看如下的消息提示：
收到采购订单后，知行之桥成功将消息推送到钉钉群中。
以上就是关于知行之桥如何将消息推送到钉钉群的基础示例介绍。如果您有更复杂的业务通知需求，欢迎随时交流。
