飞书集成手册
一、前提事项
进入飞书开放平台
二、飞书应用配置
参考文档 – 创建应用
进入【飞书开放平台 - 开发者后台】创建企业自建应用
记录应用凭证， 后续填入到EHR系统中
进入刚创建的应用， 进行应用配置
1. 机器人能力配置
【机器人】应用直接添加即可， 无需做额外配置
2. 网页应用能力配置
配置主页链接
进入【应用能力 - 网页应用】，主页链接用于从飞书工作台单点登录
桌面端和移动端的跳转链接都是EHR的员工端， 例如：
https://{ssoUrl}/middle?tenantId={tenantId}&redirectUrl=https://{mobileUrl}/me/portal&scene=feishu
安全设置
进入【开发配置 - 安全设置】配置重定向URL。白名单和H5可信域名可不配置， 默认不启用。例如：
https://{domain}/api/feishu/auth
权限管理
在【开发配置 - 权限管理】中开启api调用需要的权限（根据下方权限项名字搜索）
权限项清单：
| 接口用途 | 权限项名称 |
|---|---|
| 获取用户消息 | 获取用户受雇信息 |
| 获取用户 user ID | |
| 获取用户手机号 | |
| 获取用户邮箱信息 | |
| 批量发送消息 | 获取与发送单聊、群组消息 |
| 以应用的身份发消息 | |
| 给多个用户批量发消息 | |
| 同步审批待办 | 查看、创建、更新、删除审批应用相关信息 |
3. 发布应用
修改后点击上方【创建版本】发布最新的改动
4. 配置到工作台
进入【飞书管理后台 - 工作台 - 应用配置】， 启用应用， 并且配置可见范围
- 全部员工（正式开始上线钉钉集成）
- 部分员工、管理员、仅我可见（可供灰度测试验证阶段使用）
三、消息模板配置
配置发送飞书通知的通用模板， 前往飞书卡片搭建工具 – 卡片搭建工具（新版）
1. 导入卡片
点击【导入卡片】，文件内容可以参考通用消息模板V2..card， 没有特殊需求可以直接使用
导入后记录模板ID， 后续填入EHR系统中
2. 保存并发布
四、配置EHR飞书集成
