yuhang1995 / checkin-mate-feishu

在飞书中利用机器人指令+机器人，实现定时缺卡提醒，让你不再忘记为数不多的补卡机会

Checkin-Mate-Feishu

在飞书中利用机器人指令+机器人，实现定时缺卡提醒，让你不再忘记为数不多的补卡机会

1.创建一个飞书机器人

1.1 创建机器人

可查看官方文档或参考Gemini-Feishu中的步骤

1.2 添加机器人需要的权限

• 导出打卡数 attendance:task:readonly
• 以应用的身份发送数据 im:message:send_as_bot
• 以应用的身份读取通讯 contact:contact:readonly_as_app
• 获取用户的userID contact:user.employee_id:readonly

2.设置指令

设置指令是为了主动执行机器人，访问飞书机器人助手

1、在新建指令的窗口中，选择定时任务，然后根据自己的需求进行具体设置，然后点击完成

2、选点击选择操作 -> 选择发送HTTP请求 -> 选择请求方式为POST -> 输入URL -> 点击完成

此处的URL需要填写自己实际的服务地址

本地测试

克隆仓库，设置对应的环境变量

• PORT=xxx
• APP_ID=xxx
• APP_SECRET=xxx

安装依赖

pnpm install

启动本地服务

pnpm dev

这里需要飞书回调我们的服务，本地开发是可使用localtunnel进行穿墙