首先,需要在 飞书 注册账号创建团队。
注:已创建过团队则忽略此步骤。
创建完团队后,需要在 飞书开放平台 创建一个自建应用。
未创建过应用的用户可以直接点击「创建应用」新建一个自建应用,如下图所示:
已创建过应用的用户滑动到页面中间区域选择「创建企业自建应用」,如下图所示:
按照要求填写好应用资料,填写完毕点击「确定创建」。
然后点击应用详情,获取相关参数,如下图所示:
在应用详情「凭证与基础信息」中的参数 AppID 和 App Secret 复制备份,如下图所示:
并在综合信息处修改应用图标:
选择权限管理,至少添加以下 13 种权限:
在权限管理中,搜索需要添加的权限,全部选择完毕后,点击批量申请:
上述权限均为免审核权限,点击「批量开通」即可开通。
在安全设置中的重定向 URL 中添加重定向URL,URL 地址组成为:
https://private.yourdomain.com/lark/corp/install/callback
其中 lark 以前的部分为您需要绑定的简道云独享版账号的自有域名。如下图所示:
访问「事件订阅」页面,若首次访问,需点击重置 Encrypt Key,然后复制 Encrypt Key 和 Verification Token 进行备份。如下图所示:
点击「应用功能 >> 网页」在右侧开启网页,地址任意填写(由于最终使用的地址必须在简道云中安装完成才能获取,因此初次安装可以随意填写,后续会修改)。
点击左侧的版本管理与发布, 点击右侧的创建版本.
版本详情页面如下填写:
然后「点击申请发布」。
此时企业管理员将会在飞书 App 内收到一条申请请求,管理员点击详情进行审批并通过。
注:如果是飞书管理员创建的应用, 将自动审批通过, 无需审核应用。
先在独享版企业管理中创建一个独享版企业账号并登录:
如果已创建账号,则直接在独享版中登录此账号,登录方式如下:
注:登录的账号需为内置模式的独享版账号,如果是已经绑定的集成模式独享版账号,则需要先解绑为内置模式,再来绑定飞书。
登录后在浏览器新开一个页面,访问地址:
https://private.yourdomain.com/lark/corp/install
将 lark 之前的内容替换成您自己的域名再访问。如:https://hc.jiandaoyun.com/lark/corp/install。
然后将上述步骤获取的参数 + 企业名称填入下方对应位置,填写完毕「点击安装」。如下图所示:
然后点击「授权」:
授权后,停留在最终页面,请勿离开。如下图所示:
复制页面上的 5 项信息存档,以防丢失:(重要,一定要复制下来进行存档‼️)
将上述页面中的信息回填到 飞书开放平台。
1)重定向 URL 设置
2)网页配置
3)请求地址设置
启用机器人,可以用于接收消息提醒。
在事件订阅中,将以下事件进行添加。
配置 H5 可信域名可以使用定位等 JSAPI 功能。可信域名为您自己的域名:
https://private.yourdomain.com
然后在「安全设置>>H5 可信域名」处添加可信域名。如下图所示:
全部填写完毕后,由于信息发生变动,需要重复【7】的步骤,再发布一个新版本。
访问 https://feishu.cn/admin/appCenter/manage,在「工作台 >> 应用管理」中找到刚才的自建应用,点击右侧的配置,按需配置通讯录可用性权限。如下图所示:
配置完成后需要在简道云中重新同步通讯录。
完成上述步骤后,即完成了简道云与飞书的绑定,拥有可用性权限的成员可以在飞书中使用简道云。
1)应用停用
飞书管理员登录管理后台 ,找到简道云应用并停用。如下图所示:
2)应用删除
停用后,在 开发者后台 将简道云应用删除。如下图所示:
然后管理员以创建者身份登录简道云电脑端,在「企业管理 >> 企业信息 >> 账号模式」,点击「解绑飞书」即可完成解绑操作。如下图所示:
注:一个简道云账号只能绑定一个飞书账号,不建议多次解绑再绑定,解绑操作需谨慎。
当飞书后台的参数发生变动后,需要在简道云中完成同步修改。「右上角头像>>企业管理>>企业信息>>授权信息「修改」>>进行参数修改」,如下图所示:
至此,账号集成相关配置已全部完成。
登录独享版控制台,点击基础信息中的访问地址,通过企业管理员用户名和密码即可以创建者身份登录简道云企业中:
登录后可以看到,企业已由「内置模式」更换为「企业微信集成模式」,如下图所示:
登录 通讯录,可以看到已经同步过来的企业微信成员,如下图所示:
除创建者身份以外的其他成员(包括管理员)登录简道云时,可以通过企业账号 URL 进行登录。如下图所示:
还可以直接在飞书客户端登录简道云: