知行之桥如何将消息推送到钉钉群?

在钉钉平台中,机器人主要分为企业机器人和自定义机器人两类。本文将重点介绍如何通过自定义机器人,实现将知行之桥 EDI 系统的通知消息高效推送至钉钉群,帮助企业第一时间掌握业务动态。

一、在钉钉群中添加自定义机器人

在需要接收知行之桥消息的钉钉群组中,找到 群设置->机器人,按照下图所示内容,添加一个自定义机器人。

2025edi-rest-ding1.png
2025edi-rest-ding2.png

添加机器人的时候,在上述页面中需要进行安全设置,用户可以选择 自定义关键词、加签以及IP地址(段)的安全方式。

更多可参考:创建自定义机器人

二、获取已添加机器人的Webhook地址:

在群设置->机器人中,找到我们刚刚添加的机器人。

2025edi-rest-ding3.png
2025edi-rest-ding4.png

更多可参考:获取自定义机器人的Webhook地址

特别提醒:请妥善保管机器人的 Webhook 地址,避免泄露。切勿公开在 GitHub、博客等平台,否则可能被不法分子利用,导致机器人被用于发送垃圾信息。

三、知行之桥设置

在知行之桥EDI系统中,创建一个REST 端口,在 设置 选项卡下,需要完成以下配置:

1.设置 操作 为:Transform
2.将 方法 设置为 POST,将机器人的webhook地址配置在REST端口的URL处。

2025edi-rest-ding5.png

注意:每个机器人的URL 不一样,实际使用时请使用实际机器人的webhook地址即可

3.头部配置:设置 名称 为:Content_Type 设置为:application/json
4.正文配置:设置 正文类型raw,Content Type 设置为:JSON(application/json)

2025edi-rest-ding6.png

四、通过钉钉机器人发消息

至此,就可以通过钉钉机器人发消息了,钉钉自定义机器人支持六种消息类型,包括Text文本类型、Link链接消息、Markdown 类型、整体跳转 ActionCard 类型、独立跳转 ActionCard 类型、FeedCard 类型,消息类型对比可参考:自定义机器人发送消息的消息类型

以发送文本消息为例,要实现钉钉通知,需要传输的json文件格式如下所示:

将上述文件上传至知行之桥REST端口的 输入 选项卡下:

2025edi-rest-ding7.png

文件成功发出后,在设置了自定义机器人的钉钉群中可以收到以下消息:

2025edi-rest-ding8.png

注意:为了保证安全性,钉钉强制使用一种安全方式,本次演示使用的是关键字方式:

2025edi-rest-ding9.png

更多说明:自定义机器人安全设置

五、EDI 消息提醒推送

接下来以接收一个850采购订单为例,为大家演示如何实现钉钉通知。

1.在接收端口(比如AS2)后新增一个报文转换端口(比如X12),报文转换后需要增加XML MAP端口,XML MAP端口后新增JSON端口,最后以REST端口作为工作流的结尾,形成这样的工作流:

2025edi-rest-ding10.png

2.在XML MAP中进行数据提取和格式调整

我们以850采购订单为例,在XML Map端口需要选择来源模板文件和目标模板文件,来源模板文件我们以最常见的00401为例,目标模板文件是将调用钉钉接口的json转换得到xml。以下是一个目标模板文件示例:

上传好来源模板文件和目标模板文件后,首先需要将来源模板中的TX-00401-850节点拖拽到目标模板中的Items上,接下来找到来源模板中存放采购订单编号信息的BEG03节点,将其拖拽到目标模板中的 content上,如下所示:

2025edi-rest-ding11.png

注:用户可以在知行EDI规范查询平台中,查询EDI报文各个字段的含义,本次示例中需要的采购订单编号,对应EDI 850报文中的BEG03节点。

接下来点击上图content节点的 编辑节点 按钮,编辑节点值,为这个映射添加关键字PO,令content元素的值为PO:[xpath("BEG/BEG03")],这样设置的目的是,钉钉群组通知格式将会变成,PO:实际的采购订单编号。用户可以根据实际业务需求,修改这里的文字描述。

2025edi-rest-ding12.png

在此弹窗页面中点击 应用,在XML Map端口点击右上角的 保存 按钮,保存当前映射结果。上述操作完成后,即可提取PO号码,并且用文本类型将PO推送到钉钉群。

接下来回到当前工作流的X12端口,在 输入 选项卡下上传一个测试的850文件,文件将会被自动处理,用户可以在钉钉群中查看如下的消息提示:

2025edi-rest-ding13.png

收到采购订单后,知行之桥成功将消息推送到钉钉群中。

以上就是关于知行之桥如何将消息推送到钉钉群的基础示例介绍。如果您有更复杂的业务通知需求,欢迎随时与我们联系,我们将为您提供更全面、灵活的集成方案。

如果您希望了解有关EDI对接的相关信息,欢迎联系我们。

了解更多 EDI 信息,请您通过邮件 sales@kasoftware.cn 联系我们。点击下方蓝色按钮,即可免费试用 EDI 软件。

注:文案部分图片及内容来源于网络,版权归原创作者所有,如有侵犯到您的权益,请您联系我们进行删除,给您带来困扰,我们深感抱歉。

标签: , , , , , , ,
文章分类 帮助文档, 常见问题和回答, 操作指南, 知识库