飞书对接E签宝完整方案
1、概述
飞书和E签宝在各自领域都属于领先的产品，但因为E签宝与钉钉的特殊关系，一直以来E签宝都只实现了与钉钉的深度集成，一家企业如果想同时使用飞书和E签宝，则需要通过S-HUB这样的产品来进行桥接，用户在飞书端审批，审批通过后把附件或表单信息同步到E签宝进行签署，签署完的结果回传飞书审批流。
S-HUB电子签章集成对接方案支持附件审批对接、模板审批对接、静默方式、单方电子签、多方电子签、文档水印等复杂场景对接。
2、业务对接流程
2.1、审批流对接
流程说明
- 内部员工通过飞书审批流发起一个审批；
- 完成签章前的审批工作；
- 审批流程发起人选择签章方式，签章方式有“电子签”、“线下签”、“我方电子签｜对方线下签”三种；
- 当审批状态到达待签章状态时，签章人员打开详情能看到通过、拒绝、发起电子签章三个操作，如果是“线下签章”，则需要把文件盖章扫描并上传，然后点通过，也可以通过此处发起电子签章，如果选择线下签章，后续操作跟目前正在运行的流程没有任何差别，如果采用电子签章，还需要经过如下步骤；
- 飞书调用S-HUB提供的链接，通知S-HUB需要发起电子签章；
- S-HUB请求飞书API接口，获取审批流详细信息；
- S-HUB请求E签定API接口，按要求发起电子签章；
- 内部员工在飞书收到一条机器人推送的消息通知，提醒有一个电子签章需要处理，点击打开飞书内嵌浏览器进行身份认证和签章；
- 如果是需要外部人员参与的多方签章，相关人员会收到一条短信和邮件，点击链接完成用户验证并签章；
- 各相关方签章完毕后，S-HUB获取签章后的文件提交到飞书审批流；
- 自动更新飞书审批流的状态为已签章状态；
- 人工操作归档，至此流程结束。
2.2、飞书合同对接
流程说明
- 内部员工通过飞书合同发起一个新的合同审批；
- 完成签章前的审批工作；
- 审批流程发起人选择签章方式，签章方式有“电子签”、“线下签”、“我方电子签｜对方线下签”三种；
- S-HUB会接收到每一个审批动作触发的事件推送，当到达待签章状态时，S-HUB请求飞书API接口，获取审批流详细信息；
- S-HUB请求E签定API接口，按要求发起电子签章；
- 内部员工在飞书收到一条机器人推送的消息通知，提醒有一个电子签章需要处理，点击打开飞书内嵌浏览器进行身份认证和签章，签章操作步骤参考审批流对接章节；
- E签宝通过短信和邮件通知外部人员，外部人员点击链接完成用户验证并签章，签章操作步骤参考审批流对接章节；
- 各相关方签章完毕后，S-HUB获取签章后的文件提交到飞书审批流；
- 自动更新飞书审批流的状态为已签章状态；
- 人工操作归档，至此流程结束。
3、技术对接流程
（整体对接时序图）
3.1、飞书审批流事件通知
审批流类事件订阅参考“审批\审批事件\订阅审批事件”文档https://open.feishu.cn/document/server-docs/approval-v4/event/event-interface/subscribe
飞书合同类事件订阅参考“飞书合同\事件\合同状态变更”文档https://open.feishu.cn/document/server-docs/contract-v1/contract/events/change
3.2、获取飞书审批流详情
参考“飞书合同管理\查看合同详情”文档https://open.feishu.cn/open-apis/contract/v1/contracts/:contract_id
3.3、向E签宝发起签章请求
（E签宝接口调用时序图：双方电子签）
（E签宝接口调用时序图：我方电子签对方线下签）
3.4、给内部签章人发通知
参考飞书在线文档“消息\发送消息内容”章节https://open.feishu.cn/document/server-docs/im-v1/message-content-description/create_json
3.5、e签宝给外部用户发通知
（短信或邮件通知）
3.6、用户签章
（验证登录）
（经办人实名认证）
（企业认证）
（签章）