一、创建应用
入口：飞书开放平台-开发者后台
二、配置应用
点击整行，进入应用配置页
启用「网页」
a. 入口：应用功能-网页
b. 桌面端主页：https://gateway-ats.mokahr.com/api/outer/passport/lark/auth/authorize?bus=20&corpId=123&appType=self
c. 移动端主页：https://gateway-ats.mokahr.com/api/outer/passport/lark/auth/authorize?bus=20&corpId=123&appType=self
注意：以上链接标红的「123」为临时填写，需要在第四节CSM完成安装后进行替换为获得的appid
启用「机器人」
a. 入口：应用功能-机器人
添加「重定向 URL」
a. 入口：安全设置
b. URL 地址：https://gateway-ats.mokahr.com/api/outer/passport/lark/auth/get_user_identity
添加「H5 可信域名」
a. 入口：安全设置
b. 可信域名：https://core.mokahr.com
配置「通讯录权限范围」
a. 入口：权限管理-设置通讯录权限范围
b. 权限范围选择「全部成员」
配置应用权限
a. 入口：权限管理-权限配置
b. 需要开通的权限如下
模块 | 权限 |
用户 | 获取用户邮箱信息 |
获取用户手机号 | |
获取用户 user ID | |
通过手机号或邮箱获取用户 ID | |
获取用户基本信息 | |
日历 | 获取日历、日程及忙闲信息 |
更新日历及日程信息 | |
消息 | 获取与上传图片或文件资源 |
以应用的身份发消息（历史版本） | |
获取用户在群聊中@机器人的消息（历史版本 | |
获取用户发给机器人的单聊消息（历史版本） | |
通讯录 | 获取用户雇佣信息 |
获取用户性别 | |
获取用户组织架构信息 | |
获取角色权限 | |
获取部门组织架构信息 | |
获取部门基础信息 | |
更新通讯录 | |
以应用身份访问通讯录（历史版本） | |
以应用身份读取通讯录 | |
搜索用户 | |
获取用户手机号 | |
获取用户受雇信息更新 | |
获取用户组织架构信息 | |
通过手机号或邮箱获取用户 ID | |
获取用户 user ID | |
企业信息 | 获取企业信息 |
设置-服务对接-IM对接，开启请假、出差、外出数据同步
前置条件：安装PP应用，权限管理中开启如下权限
员工端样式：请假同步后，飞书员工的状态会变为请假，显示请假的时段
【个人视角查看】
【其他人视角查看、聊天窗口查看】
配置应用图标、名称
a. 入口：凭证与基础信息
b. 可以根据客户需求定义 Moka People 的图标和应用名称
c. 如果要用 Moka 图标，可以保存下图使用
三、开启「开放平台」调用飞书自定义字段权限
入口：飞书管理后台-组织架构-成员字段管理
链接：https://feishu.cn/admin/contacts/employee-field-new/custom
四、获取飞书租户 id，替换网页链接
创建版本并发布
a. 入口：应用发布-版本管理与发布
b. 这次发布还不是正式发布，后续需要调整网页的链接。因此可用范围先设置客户管理员
客户管理员审核
a. 入口：飞书管理后台-工作台-应用审核
将 App ID、App Secret 提供给 Moka 实施
回到「飞书开发者后台」，编辑 Moka People 应用的「网页」
a. 链接：https://open.feishu.cn/app
b. 入口：Moka People 应用-应用功能-网页
c. 把桌面端、移动端主页的 123 替换成上一步获得的 appId
例如安装示例替换后就是：https://gateway-ats.mokahr.com/api/outer/passport/lark/auth/authorize?bus=20&corpId=2e559e1d57cf1651&appType=self
五、正式发布
创建版本
a. 可用范围按照客户需求设置
申请线上发布
审核
六、开通飞书 bot 消息免登录
提供以下信息：
客户飞书应用的appId
七、在 People 开启飞书同步
入口：People-设置-服务对接-IM 对接
八、飞书 moka 打卡应用安装步骤
安装moka独立打卡应用，安装步骤和安装moka people一致，打卡首页地址bus=21
a. 桌面端主页：https://gateway-ats.mokahr.com/api/outer/passport/lark/auth/authorize?bus=21&corpId=123&appType=self
b. 移动端主页：https://gateway-ats.mokahr.com/api/outer/passport/lark/auth/authorize?bus=21&corpId=123&appType=self
landurl为：https://core.mokahr.com/punch/punch
调用成功后，即可打卡
