飞书对接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、用户签章

（验证登录）

（经办人实名认证）

（企业认证）

（签章）