飞书登录集成

飞书登录用于识别组织成员。它与飞书机器人、飞书工作簿分别配置，不会互相启用。以下操作已按产品 4.2.48-1026 核对；旧实例请先确认版本。

准备应用

1. 在飞书开发者后台创建企业自建应用，启用网页应用能力，取得 App ID 和 App Secret。
2. 由 AskTable 组织 Owner 或 Admin 进入 个人设置 → 登录集成 → 飞书，点击 启用并填写凭据。
3. 在详情页的 权限配置 区点击 复制权限 JSON，到飞书权限管理的 批量处理 → 批量导入/导出权限 中导入。保存配置后，也可点击 前往飞书权限管理打开对应应用。
4. 设置需要导入的部门和成员为通讯录可见范围，发布应用版本，使权限生效。按用户组授权时，还需开通 contact:group:readonly。

登录身份使用应用内的 open_id，不需要申请手机号、邮箱或员工 user_id 权限。成员缺少姓名时，检查成员基本信息权限是否已发布生效。

App ID 保存后不能直接修改；更换应用前先断开集成。保存配置不会自动导入成员，也不表示外部凭据已验证成功。

配置登录地址

复制 AskTable 详情页的完整登录地址，填入飞书网页应用的桌面端和移动端主页，并配置 AskTable 域名为可信域名。选择在飞书客户端内打开。

• 私有部署地址形如 https://你的域名/login/sso/feishu，不带组织参数。
• Cloud 地址带 ?org_id=...，必须完整保留。
• 部署有路径前缀时，以页面显示的完整地址为准。

当前只支持从飞书客户端工作台打开应用免登；普通浏览器入口会提示使用飞书客户端。

导入并验证成员

在 AskTable 飞书详情页点击 导入成员，选择应用可见范围内的人并提交，再用已导入成员从飞书工作台打开应用，确认进入正确组织。

首次登录不会自动创建账号。账号和组织成员关系都必须正常；已停用成员不能靠重新导入恢复。同一员工分别从飞书、企业微信或钉钉导入，会创建各自的 AskTable 账号并分别占用席位，不按相同手机号或邮箱合并。

当前不提供通讯录定时同步或离职自动停用。断开集成保留账号、成员和项目历史。完整规则见企业集成登录。导入后仍需分配项目角色和数据权限。

排障