本文，我们将以企业内部的工单系统集成到飞书项目为例，讲解如何设计和实现集成插件。
大部分集成，包括devops系统集成，客服系统集成，oa集成等，都可以通过类似方案进行演化完成，如果需要集成后在飞书项目展示更丰富的外部系统信息，可以通过插件前端点位来完成，点位的使用可参考开发者手册。
如下图所示，需求为某工单系统，当工单流转到“转需求时”，自动创建飞书项目需求单，并填写需求来源，需求描述，需求流转到开发节点时，自动同步开发排期到工单系统，需求上线时，触发工单状态更新。
上述方案预期实现技术方案概览：
前置准备 >>
-
在飞书项目开发者后台新建插件，获取插件认证信息
-
并申请相关api 权限，此方案可能会用到 工作项创建api，工作项查询api，查询用户api，在插件后台完成权限申请
开发过程 > >
-
在自研工单系统内添加代码，状态流转到“转需求”时，触发创建飞书项目需求。这个步骤，可能会涉及如下api：
- 获取创建工作项元数据
- 创建工作项
- 获取人员详情 ，用于将自研系统的人员转换成飞书项目人员信息，如系统已经和飞书完成账号互通，可通过email进行查询，如系统未与飞书账号打通，建议通过配置文件配置系统人员id与飞书项目userkey的映射关系。
-
开发可被公网访问的webhook https api，用于接收飞书项目的需求变更事件。并根据事件类型实现更新工单排期或状态。
线上使用 > >
- 插件发布
- 在需要进行同步数据的空间，进入配置->插件管理，添加自研插件
- 在上述空间，进入配置->自动化，配置webhook触发器
