知行之桥企业微信端口:让 EDI 处理结果自动触达业务团队
© All rights reserved. • 西安知行软件有限公司 • 陕ICP备09022277号
产品版本: 知行之桥 EDI 系统 V2026 / 26.4
适用对象: 需要通过企业微信发送业务通知、处理结果或文件的企业用户与集成实施人员
产品文档: 企业微信端口官方说明
EDI 处理完成后,让相关人员及时收到结果
采购订单转换完成后,业务人员需要及时查看处理结果;文件校验出现异常时,运维人员也需要尽快收到提醒。如果这些信息仍依赖人工查日志、下载文件和转发,处理流程与人员跟进之间就多了一道等待。
知行之桥企业微信端口可接收工作流传入的消息或文件,通过企业微信自建应用发送给指定成员,或按部门、标签组织投递。文本、Markdown 通知与结果文件可以进入团队日常使用的沟通工具,方便业务与运维人员跟进。
业务事件的识别、触发条件和通知内容由上游工作流或监控逻辑提供,企业微信端口负责发送。 例如,要在校验失败时告警,需要先在流程中捕获失败结果并生成通知,再交给企业微信端口处理。
三个典型 EDI 应用场景
1. 采购订单处理结果通知
工作流接收并转换采购订单后,将订单号、处理结果和文件名组织成文本或 Markdown 消息,通过企业微信端口发送给指定业务人员,方便继续跟进。
如果不同业务分支需要通知不同人员,可启用消息头覆盖,由上游为每条通知指定接收人,减少重复配置。
2. 转换或校验后的文件交付
工作流生成转换文件或校验结果文件后,可通过文件模式发送给业务人员。需要补充上下文时,可启用附带消息,说明文件名、批次号或处理摘要。
文件与说明是两条独立消息,应分别关注发送结果;设计重试流程时,也要考虑重复交付的可能性。
3. 异常处理提醒
在工作流或监控逻辑捕获到处理失败、重试耗尽或超时事件,并生成通知消息后,可通过企业微信端口向指定运维人员发送提醒。
通知中可根据上游已有数据提供文件名、异常摘要和处理线索,帮助接收人员定位问题。
以上为流程设计示例,具体触发逻辑与通知字段需按项目配置。
核心功能
| 能力 | 说明 |
|---|---|
| 四种发送模式 | 文本、模板、文件和原始 JSON,适配不同通知与交付需求 |
| 按组织投递 | 通过成员、部门或标签 ID 配置接收对象 |
| 连接复用 | 多个端口可共用同一企业微信连接,分别配置接收人与发送模式 |
| 令牌管理 | 由端口处理访问令牌的获取与缓存,减少流程中的重复鉴权配置 |
| 动态接收人 | 启用消息头覆盖后,可由上游消息指定接收人及类型 |
| 文件附带说明 | 文件发送成功后,可继续发送文本或 Markdown 说明 |
| 日志与重试 | 在交易日志中查看处理结果,并结合端口重试设置处理失败消息 |
开始前:准备企业微信自建应用
需要具备企业微信企业账号与相应应用管理权限,并准备以下信息:
| 凭据 | 来源与用途 |
|---|---|
| 企业 ID(Corp ID) | 从企业信息中获取,用于标识自建应用所属企业 |
| 应用 ID(Agent ID) | 从自建应用详情中获取,用于标识发送消息的应用 |
| 应用密钥(Secret) | 从同一自建应用中获取,用于接口鉴权 |
企业 ID 应与自建应用所属企业一致,应用 ID 与应用密钥应来自同一自建应用。
在企业微信管理后台创建或打开自建应用后,还需完成以下准备:
- 设置应用可见范围,确保覆盖目标接收成员。
- 根据企业微信后台要求配置企业可信 IP,核对运行端口服务器访问接口时的公网出口 IP;经代理访问时,核对实际代理出口。
- 获取目标成员、部门或标签的 ID,供端口配置使用。
具体后台入口和访问要求,以企业微信当前管理后台及官方文档为准。
配置连接与接收人
1. 创建连接并测试
在端口设置中创建或选择企业微信连接,填写企业 ID、应用 ID 与应用密钥,然后执行「测试连接」或「保存并测试」。
连接测试用于验证能否获取访问令牌,不会发送消息,也不能据此确认目标人员能够收到消息。 测试通过后,还应向应用可见范围内的测试成员实际发送一条消息,核对发送日志与接收端结果。

图为连接设置界面示意,状态展示不作为实际连接或消息发送成功的验证依据。
2. 配置接收人与发送行为

| 设置 | 配置说明 |
|---|---|
| 接收人类型 | 成员(User)、部门(Department)或标签(Tag);默认成员 |
| 接收人 | 填写所选类型对应的 ID;多个 ID 用分号分隔,如 user001;user002 |
| 允许消息头覆盖 | 默认关闭;启用后,可通过 WeCom-Recipient 和 WeCom-RecipientType 动态覆盖接收人及类型 |
| 发送模式 | 文本(Text)、模板(Template)、文件(File)或原始 JSON(RawJSON);默认文本 |
| 消息格式与模板 | 模板模式下选择 Text 或 Markdown,并填写消息模板;支持 ArcScript 与宏 |
| 发送附带消息 | 仅文件模式,默认关闭;启用后选择说明消息格式并填写模板 |
在文本、模板和文件模式下,每条消息通过端口配置或消息头选择一种接收人类型。RawJSON 模式由请求体指定接收对象,不使用端口的接收人设置。
消息头覆盖只影响接收人及类型,连接凭据与 Agent ID 仍来自所选连接。高级选项卡还可配置每次企业微信 API 请求的超时时间,单位为秒,默认值为 60。
四种发送模式怎么用
1. 文本:发送已经组织好的通知
选择连接、接收人和 Text 模式,将 UTF-8 文本消息传入端口,并在自动化中启用发送。
文本模式直接发送输入内容,不进行模板渲染。内容不能为空,长度最多为 2048 字节,按 UTF-8 字节数计算。适合上游已经生成通知正文的场景,例如订单处理结果与异常摘要。
2. 模板:统一通知格式
将发送模式设为 Template,选择 Text 或 Markdown,并填写模板。每条输入消息触发一次模板渲染,渲染结果不能为空。
例如,在 Markdown 模式中使用以下模板,展示处理完成的文件名:
## 文件处理完成
文件名:%Filename%
模板支持 ArcScript 与宏。渲染后的文本最多为 2048 字节,Markdown 最多为 4096 字节,均按 UTF-8 字节数计算。字节数不等同于字符数,包含中文时尤其需要注意长度。

3. 文件:交付处理结果
将发送模式设为 File。输入消息需要带有文件名,端口先上传文件,再使用返回的媒体 ID 发送文件消息。文件大小须在 5 字节至 20 MiB 之间。
如需说明文件用途,可启用「发送附带消息」,选择文本或 Markdown,并填写说明模板。
文件与说明分别发送,不是一次整体交付。 如果文件已经发送成功,而附带说明失败,重新处理前应核对日志:若重试重新执行文件发送步骤,接收人可能再次收到同一文件。具体重试行为应结合所用版本与实际流程验证。

4. 原始 JSON:自定义消息请求
需要自行构造企业微信消息请求时,可选择 RawJSON 模式。输入应为 JSON 对象,例如:
{
"touser": "user001|user002",
"msgtype": "text",
"text": {
"content": "订单处理完成。"
}
}
请求需包含 msgtype,以及 touser、toparty、totag 中至少一个接收人字段;具体字段组合和消息内容须符合企业微信对应接口要求。
此模式忽略端口的接收人、消息头覆盖与消息格式设置,由 JSON 请求体指定相关内容。注意示例中的企业微信接口接收人分隔符为 |,与端口接收人输入框使用的分号不同。
端口会补充所选连接的 agentid 并完成鉴权。不要在输入中放入 access_token;如自行填写 agentid,应与连接中的值保持一致。其他消息类型的请求结构请对照企业微信官方文档。
验证结果与排查问题
端口处理成功后,输入消息标记为成功;配置错误、上传失败或发送失败时,可在交易日志中查看原因。端口成功状态不能用来证明接收人员已经阅读或处理了通知。 首次上线时,应同时核对接收端的实际展示结果。
建议按以下顺序验证与排查:
- 检查连接。 执行连接测试;若获取令牌失败,按错误信息核对企业 ID、应用密钥、网络与访问要求。
- 实际发送。 向可见范围内的测试成员发送消息,检查应用 ID、接收人类型、接收人 ID 与可见范围。
- 检查内容。 按模式核对文本长度、模板渲染结果、文件名、文件大小或 JSON 结构。
- 定位失败阶段。 通过交易日志判断问题发生在配置、上传还是发送环节,再决定如何修正或重试。
下图为无效凭据的排错示例:使用占位企业 ID 时,日志显示 40013 invalid corpid。应先核对企业 ID,修正后重新测试;后续若出现其他错误,再按新的日志信息继续排查。填入真实凭据并不保证其他配置和访问条件同时满足要求。

上线前重点检查
- 连接测试与消息发送分别验证。 获取令牌成功后,再检查实际消息能否发送及接收。
- 接收对象配置正确。 核对 ID 类型、应用可见范围,以及动态消息头是否符合预期;RawJSON 按请求体检查。
- 控制通知与文件大小。 文本、Markdown 按字节计数;文件按所用版本及企业微信接口要求核对限制。
- 处理重复发送风险。 文件与附带说明分别发送,重试前检查已完成的步骤,并结合流程安排补发。
同一企业微信连接可供多个端口复用。可按业务线、接收人群或发送模式拆分端口,共享连接凭据,同时保持各流程的发送配置清晰。
让处理结果进入团队日常协作
企业微信端口为知行之桥工作流提供了向企业内部人员发送通知和文件的通道。完成连接、接收人与发送模式配置,并验证实际接收结果后,即可将上游生成的 EDI 处理结果发送到企业微信,方便业务与运维人员及时跟进。
参考资料
- 企业微信端口官方说明(26.4)
- 企业微信官方文档:发送应用消息
- 企业微信管理后台:自建应用、企业信息与企业可信 IP 配置说明。


