easyflow-thirdparty
SKILL.md
EasyFlow 流协对接第三方系统
核心知识
仅插件可实现的功能
✅ 可以实现:
- 通知推送能力(待办、已办、办结)
- 第三方节点审批能力(需主体已开启第三方节点功能)
❌ 无法实现:
- 在客户系统中直接操作流协工单
- 查询工单详情和审批日志
- 全流程在客户侧审批(但如果整个流程只有一个第三方节点,则等价于全流程客户侧审批)
- 通知流程无关的特定人员
关键限制
- 移动端无法跳转审批(流协无移动端版本)
- 插件只能基于流协提供的流程相关人信息发送通知
- 或签/会签的审批人区分通过 finishedUsers 和 approveUsers 实现
成本参考
- 通知插件:3人天 + 每流程1人天
- 第三方节点插件:5人天 + 每流程2人天
钉钉对接特别说明
对接架构
流协插件 → 钉钉开放平台 API → 钉钉审批/工作通知
需要钉钉端配置(需参考钉钉开放平台文档)
- 创建钉钉应用 - 获取 AppKey / AppSecret
- 申请权限 - 审批、工作通知、通讯录等相关接口权限
- 配置回调地址 - 钉钉审批状态变更回调到流协插件
- 审批模板设计 - 在钉钉管理后台设计审批表单模板
关键对接点(需参考钉钉文档评估实现细节)
| 功能 | 流协侧 | 钉钉侧(需查文档) |
|---|---|---|
| 发送待办通知 | 插件捕获 TASK_CREATED 事件 | 钉钉工作通知 API |
| 创建审批实例 | 插件调用钉钉 API | 钉钉审批创建接口 |
| 审批状态同步 | 插件接收钉钉回调 | 钉钉回调配置 |
| 用户身份映射 | 流协用户 → 钉钉 UserID | 钉钉通讯录接口 |
注意事项
- 钉钉接口有频率限制,需评估并发场景
- 用户需要在钉钉和流协两侧都有账号,需建立映射关系
- 钉钉审批和流协审批的状态机需要仔细对齐
- 详细实现需参考钉钉开放平台官方文档
参考文档
主要知识库
- 流协对接第三方系统知识库 - 整合后的完整知识库
原始参考文档(originals/)
AI 使用说明:回答复杂问题时,必须读取以下原始文档获取详细信息:
- 流协对接第三方评估文档.md - 对接方案评估和成本分析
- 流协主版本发送第三方通知优化.md - 通知推送机制优化说明
- 流程协作对接第三方系统通知.md - 通知对接详细设计
- 流程协作第三方节点使用说明.md - 第三方节点配置和使用指南
(注:原始 .docx 文件也在 originals/ 目录中)
外部文档
- 钉钉开放平台文档(需自行查阅最新版)
作者
- 整理者:AI Assistant
- 整理时间:2026-03-12