安装 Moka People 主应用

一、创建应用

• 入口：飞书开放平台-开发者后台

• 链接：https://open.feishu.cn/app

二、配置应用

1. 点击，进入应用配置页

1. 添加「网页」

2. 添加：网页应用

3. 桌面端主页：https://gateway-ats.mokahr.com/api/outer/passport/lark/auth/authorize?bus=20&corpId=123&appType=self

4. 移动端主页：https://gateway-ats.mokahr.com/api/outer/passport/lark/auth/authorize?bus=20&corpId=123&appType=self

注意：以上链接标红的「123」为临时填写，需要在第四节CSM完成安装后进行替换为获得的corpId

3. 启用「机器人」

   1. 添加：应用功能-机器人

4. 添加「重定向 URL」

   1. 入口：安全设置

   2. URL 地址：https://gateway-ats.mokahr.com/api/outer/passport/lark/auth/get_user_identity

5. 添加「H5 可信域名」

   1. 入口：安全设置

   2. 可信域名：https://core.mokahr.com

6. 配置「通讯录权限范围」

   1. 入口：权限管理-设置通讯录权限范围

   2. 权限范围选择「全部成员」

1. 配置应用权限

   1. 入口：权限管理-权限配置

   2. 需要开通的权限如下

8. 配置应用图标、名称

   1. 入口：凭证与基础信息

   2. 可以根据客户需求定义 Moka People 的图标和应用名称

2. 如果要用 Moka 图标，可以保存下图使用

三、开启「开放平台」调用飞书自定义字段权限

• 入口：飞书管理后台-组织架构-成员字段管理

• 链接：https://feishu.cn/admin/contacts/employee-field-new/custom

四、获取飞书租户 id，替换网页链接

1. 创建版本并发布

   1. 入口：应用发布-版本管理与发布

   2. 这次发布还不是正式发布，后续需要调整网页的链接。因此可用范围先设置客户管理员

2. 客户管理员审核

   1. 入口：飞书管理后台-工作台-应用审核

   2. 链接：https://feishu.cn/admin/appCenter/audit

3. 将 App ID、App Secret 提供给 Moka 实施

1. Moka 实施在 CSM 后台绑定飞书租户

   1. appId、appSecret、appName 根据客户提供信息填写

   2. landUrl：https://core.mokahr.com/m/login/workwechat

   3. 提交表单后，把 corpId（如下图的 2e559e1d57cf1651）记下来，下一步会用到

2. 回到「飞书开发者后台」，编辑 Moka People 应用的「网页」

   1. 链接：https://open.feishu.cn/app

   2. 入口：Moka People 应用-应用功能-网页

   3. 把桌面端、移动端主页的 123 替换成上一步获得的 appId

      1. 例如安装示例替换后就是：https://gateway-ats.mokahr.com/api/outer/passport/lark/auth/authorize?bus=20&corpId=2e559e1d57cf1651&appType=self

五、正式发布

1. 创建版本

   1. 可用范围按照客户需求设置

2. 申请线上发布

3. 审核

六、在 People 开启飞书同步

• 入口：People-设置-服务对接-IM 对接

• 链接：https://core.mokahr.com/setting/thirdParty/basic

安装打卡应用

一、创建应用

• 入口：飞书开放平台-开发者后台

• 链接：https://open.feishu.cn/app

二、配置应用

1. 点击，进入应用配置页

1. 添加「网页」，打卡首页地址bus=21

2. 桌面端主页：https://gateway-ats.mokahr.com/api/outer/passport/lark/auth/authorize?bus=21&corpId=123&appType=self

3. 移动端主页：https://gateway-ats.mokahr.com/api/outer/passport/lark/auth/authorize?bus=21&corpId=123&appType=self

4. landurl为：https://core.mokahr.com/punch/punch

注意：以上链接标红的「123」为临时填写，需要在CSM完成安装后进行替换为获得的corpId

3. 启用「机器人」

   1. 添加：应用功能-机器人

4. 添加「重定向 URL」

   1. 入口：安全设置

   2. URL 地址：https://gateway-ats.mokahr.com/api/outer/passport/lark/auth/get_user_identity

5. 添加「H5 可信域名」

   1. 入口：安全设置

   2. 可信域名：https://core.mokahr.com

6. 配置「通讯录权限范围」

   1. 入口：权限管理-设置通讯录权限范围

   2. 权限范围选择「全部成员」

1. 配置应用权限

   1. 入口：权限管理-权限配置

   2. 需要开通的权限如下：

8. 配置应用图标、名称

   1. 入口：凭证与基础信息

   2. 可以根据客户需求定义 Moka People 的图标和应用名称

2. 如果要用 Moka 图标，可以保存下图使用

三、开放字段权限、获取飞书租户 ID 同主应用

与开通主应用相同，请开启「开放平台」调用飞书自定义字段权限；获取飞书租户 ID 并替换上述填写链接中的 corpID 的值

四、正式发布

1. 创建版本

   1. 可用范围按照客户需求设置

2. 申请线上发布

3. 审核

五、其他注意事项

在飞书中安装完成moka打卡应用后，还不能打卡，需要 moka 侧开发同学手动调用接口，开启打卡同步功能，请联系 moka 侧服务同学，服务同学会联系假勤组技术同学进行调试

请求示例：

curl --location --request POST 'https://gateway-ats.mokahr.com/api/outer/passport/lark/app' \
--header 'Content-Type: application/json' \
--data-raw '{
    "appType": "self",
    "bus": 21,
    "corpId": "xxxxxxxx",
    "orgId": "xxxxxx",
    "appId": "xxxxxxxxx",
    "appSecret": "xxxxxxxxxxxx",
    "appTicket": "",
    "appName": "Moka打卡",
    "createUser": "mobile",
    "landUrl": "https://core.mokahr.com/punch/punch"
}'

• 飞书中moka打卡应用的 corpId和moka people应用的corpId相同

• corpId获取方式，就是上文提到的在csm后台获取的corpId

调用成功后，即可打卡