# 如何对接飞书
#### 使用说明
Astro可以在飞书中以自建应用的方式进行集成。集成后，支持直接将飞书侧的组织架构同步到Astro中。在Astro中集成飞书主要包括如下几步：
1. [步骤1：在飞书中自建应用]
2. [步骤2：设置通讯录权限范围]
3. [步骤3：在Astro中，配置飞书集成认证信息]
 
#### 约束与限制
仅AstroFlow专业版或企业版实例支持对接飞书。若您购买的是基础版，请先将实例升级到专业版或企业版，再执行对接飞书的操作。
 #### 步骤1：在飞书中自建应用
1. 开发者访问飞书开放平台，单击右上角"开发者后台"。
2. 单击"创建企业自建应用"，进入创建应用页面。
3. 设置应用的名称、描述信息和图标，单击"创建"。 
   图1创建企业自建应用   
   ![](https://support.huaweicloud.com/usermanual-astroflow/zh-cn_image_0000001785481342.png)
   
   
4. 选择"基础信息 \> 凭证与基础信息"，进入应用详情页。
5. 添加七个API权限。 
   请为"获取应用信息"、"以应用身份读取通讯录"、"获取通讯录部门组织架构信息"、"获取用户user ID"、"获取用户手机号"、"获取用户邮箱信息"和"获取用户受雇信息"七个API，开通权限。
   1. 在左侧导航栏中，选择"开发配置 \> 权限管理"。
   
   2. 在权限管理的"API权限"页签，搜索"获取应用信息"权限，单击"开通权限"。
      图2搜索获取应用信息   
      ![](https://support.huaweicloud.com/usermanual-astroflow/zh-cn_image_0000001953987277.png) 
   
   3. 按照上述操作，依次为"以应用身份读取通讯录"、"获取通讯录部门组织架构信息"、"获取用户user ID"、"获取用户手机号"、"获取用户邮箱信息"和"获取用户受雇信息"六个接口开通权限。
    
   
   
6. 配置数据权限。 
   1. API权限配置完成后，在"数据权限"页签中，选择"通信录权限范围 \> 权限范围"后的"配置"。
   
   2. 在弹出的页面，勾选"与应用的可用范围一致"，单击"确定"。
      图3设置数据权限   
      ![](https://support.huaweicloud.com/usermanual-astroflow/zh-cn_image_0000001786393216.png) 
   
   
   
   
7. 发布版本、选择可用人员范围。 
   1. 在左侧导航栏中，选择"应用发布 \> 版本管理与发布"。
   
   2. 在版本管理与发布页面，单击"创建版本"。
   
   3. 输入应用的版本号和说明信息。 如果是更新版本时，版本号需要增大，如由1.0.0改为1.0.1。
      
   
   4. 单击"可用范围 \> 部分成员"后的"编辑"，配置同步人员范围和应用可见人员范围，单击"确定"。
      此处选择的人员和部门，就是在飞书中可看到Astro应用的人员，也是同步到Astro的人员和部门。例如，您公司使用飞书的人数100人，使用Astro的人数是30人，则这里就选择使用Astro的30人。
      图4可用范围配置   
      ![](https://support.huaweicloud.com/usermanual-astroflow/zh-cn_image_0000001832041045.png) 
   
   5. 在版本详情页，单击页面右上角的"申请线上发布"。
   
   6. 在弹出的确认页面，单击"版本管理与发布"。
   
   7. 等待飞书管理员审核。 每次调整应用后，都需要创建新的版本并发布提交给飞书管理员审核。调整的内容中，有些会自动审核通过，有些则需要管理员手动审核。如[图5]，为需要管理员审核的内容，管理员也可以将此应用设置为免审核（如[图6]），这样提交发布申请后会自动通过审核。
      图5需要管理员审核的内容   
      ![](https://support.huaweicloud.com/usermanual-astroflow/zh-cn_image_0000001785481346.png)
      图6开启免审核   
      ![](https://support.huaweicloud.com/usermanual-astroflow/zh-cn_image_0000001926788784.png)
      当版本状态为"已发布"时，才可正常使用调整后的内容。
      图7查看版本状态   
      ![](https://support.huaweicloud.com/usermanual-astroflow/zh-cn_image_0000001832160993.png) 
   
   
   
   
8. 获取应用凭证信息。
   
   1. 在左侧导航栏中，选择"基础信息 \> 凭证与基础信息"。
   
   2. 在应用凭证中，获取App ID和App Secret。 请记录已获取的值，在Astro中对接飞书时需要使用。
      
   
   
   
   
 
 #### 步骤2：设置通讯录权限范围
1. 租户管理员登录飞书开放平台。
2. 在左侧导航栏中，选择"工作台 \> 应用管理"。
3. 在应用列表中，单击已创建的应用（如Astro），进入应用详情页。
4. 在应用权限中，单击"通讯录设置"。
5. 在应用权限中，取消"与可用人员范围保持一致"前的选中。
6. 单击"获取通讯录权限范围 ：部分员工"后的"配置"，进入通讯录权限范围设置页面。
7. 选中"全部成员"，单击"确定"。
8. 再次单击"确定"，查看应用权限。 
   图8查看应用权限   
   ![](https://support.huaweicloud.com/usermanual-astroflow/zh-cn_image_0000001832041049.png)
   
   
 
 #### 步骤3：在Astro中，配置飞书集成认证信息
1. 参考[如何登录Astro低代码平台](https://support.huaweicloud.com/usermanual-astroflow/astroflow_05_0105.html)中操作，登录Astro低代码平台。
2. 在左侧导航栏中，选择"组织管理"。
3. 在"开发集成配置"页签中，单击第三方集成中的飞书图标。 
   图9单击飞书图标   
   ![](https://support.huaweicloud.com/usermanual-astroflow/zh-cn_image_0000001832022105.png)
   
   
4. 在弹出的确认对话框中，单击"确定"。 
   一旦确定，不支持修改，请谨慎选择。
   图10确认通讯录维护类型   
   ![](https://support.huaweicloud.com/usermanual-astroflow/zh-cn_image_0000001816653060.png)
   
   
5. 设置飞书集成认证信息，单击"保存"。 
   对端鉴权ID、对端鉴权密钥请配置为[8]中，获取的Astro应用的App ID、App Secret。
   图11飞书集成认证   
   ![](https://support.huaweicloud.com/usermanual-astroflow/zh-cn_image_0000001863415389.png)
   
   
6. 单击"同步信息"，同步组织机构和用户信息。 
   ![](https://support.huaweicloud.com/usermanual-astroflow/public_sys-resources/note_3.0-zh-cn.png)
   您也可以在组织层级页签中，单击"同步信息"，同步组织机构和用户信息。
   同步成功后，单击"查看部门信息"。在"组织层级"中，可查看到同步的组织和用户信息。
   
   
7. 参考[如何进行服务授权](https://support.huaweicloud.com/usermanual-astroflow/astroflow_05_0094.html)中操作，对成员进行授权。
   
   授权后，成员即可通过手机号或者邮箱访问AstroFlow中开发的应用（运行态应用），但不能登录AstroFlow界面进行应用、流程等开发操作。如果需要登录AstroFlow界面开发应用、流程等，需要先注册华为云账号或子账号，并从管理员处获取[图12]中的授权码进行关联。关联后，参考[赋予成员不同的角色权限](https://support.huaweicloud.com/usermanual-astroflow/astroflow_05_0028.html)中操作，为成员添加所需的权限。
   图12查看已授权的成员   
   ![](https://support.huaweicloud.com/usermanual-astroflow/zh-cn_image_0000001793153958.png)