skills/skills.netease.im/easyflow-thirdparty

easyflow-thirdparty

SKILL.md

EasyFlow 流协对接第三方系统

核心知识

仅插件可实现的功能

✅ 可以实现:

  • 通知推送能力(待办、已办、办结)
  • 第三方节点审批能力(需主体已开启第三方节点功能)

❌ 无法实现:

  • 在客户系统中直接操作流协工单
  • 查询工单详情和审批日志
  • 全流程在客户侧审批(但如果整个流程只有一个第三方节点,则等价于全流程客户侧审批
  • 通知流程无关的特定人员

关键限制

  • 移动端无法跳转审批(流协无移动端版本)
  • 插件只能基于流协提供的流程相关人信息发送通知
  • 或签/会签的审批人区分通过 finishedUsers 和 approveUsers 实现

成本参考

  • 通知插件:3人天 + 每流程1人天
  • 第三方节点插件:5人天 + 每流程2人天

钉钉对接特别说明

对接架构

流协插件 → 钉钉开放平台 API → 钉钉审批/工作通知

需要钉钉端配置(需参考钉钉开放平台文档)

  1. 创建钉钉应用 - 获取 AppKey / AppSecret
  2. 申请权限 - 审批、工作通知、通讯录等相关接口权限
  3. 配置回调地址 - 钉钉审批状态变更回调到流协插件
  4. 审批模板设计 - 在钉钉管理后台设计审批表单模板

关键对接点(需参考钉钉文档评估实现细节)

功能 流协侧 钉钉侧(需查文档)
发送待办通知 插件捕获 TASK_CREATED 事件 钉钉工作通知 API
创建审批实例 插件调用钉钉 API 钉钉审批创建接口
审批状态同步 插件接收钉钉回调 钉钉回调配置
用户身份映射 流协用户 → 钉钉 UserID 钉钉通讯录接口

注意事项

  • 钉钉接口有频率限制,需评估并发场景
  • 用户需要在钉钉和流协两侧都有账号,需建立映射关系
  • 钉钉审批和流协审批的状态机需要仔细对齐
  • 详细实现需参考钉钉开放平台官方文档

参考文档

主要知识库

原始参考文档(originals/)

AI 使用说明:回答复杂问题时,必须读取以下原始文档获取详细信息:

  1. 流协对接第三方评估文档.md - 对接方案评估和成本分析
  2. 流协主版本发送第三方通知优化.md - 通知推送机制优化说明
  3. 流程协作对接第三方系统通知.md - 通知对接详细设计
  4. 流程协作第三方节点使用说明.md - 第三方节点配置和使用指南

(注:原始 .docx 文件也在 originals/ 目录中)

外部文档

  • 钉钉开放平台文档(需自行查阅最新版)

作者

  • 整理者:AI Assistant
  • 整理时间:2026-03-12
Installs
2
First Seen
Apr 2, 2026