用轻服务,打通你的飞书和 Flomo

626 阅读4分钟

flomo 是新一代「卡片笔记」,专注在碎片化时代,促进你的记录,帮你积累更多知识资产。

而作为一个功能,flomo 为用户提供了在微信侧的快速录入的能力。但受限于飞书的审核问题,flomo 一直没有提供飞书的接入,我们始终无法使用飞书来完成 flomo 的记录,接下来,我们一起动手自己写一个 flomo 机器人来完成类似微信的功能。

基本信息

本教程需要使用飞书账号轻服务账号以及 flomo Pro 的权限,请先自行注册相应的账号。

获取 flomo API 地址

在飞书当中接入 Flomo,需要你已经开通 Flomo Pro,使用 Flomo Pro 提供的 API 来实现。因此,你需要访问 Flomo 的 「API 及第三方工具」页面,复制你的 API 链接,并留存下来,我们稍后会用到。

创建飞书机器人

首先,打开飞书开放平台,使用你的飞书账号登陆,点击首页的「创建应用」,进入到应用的创建页面,创建一个新的「企业自建应用」。

创建完成后,点击你创建好的 Flomo Pro 应用,进入应用详情,找到左侧菜单的「凭证与基础」,找到你的 App IDApp Secret,将这两个值记录下来,后续会用到。
此外,打开左侧菜单中的「事件订阅」,找到 Verification Token ,将这个值记录下来,后续会用到。

此外,你还需要点击左侧 Tab 中「应用功能」中的「机器人」页面,开启机器人功能。

创建轻服务应用

打开轻服务网站,登陆管理控制台

![]((qingfuwu.aliavv.com/wp-content/…)

创建一个新的服务,这里需要选择 Node.js 应用来进行创建。创建完成后,进入到服务内部。

在服务内部点击左侧的「设置」,进入到设置页面,在设置页面中找到「小程序设置」,配置其中的「飞书小程序/机器人」,将刚刚保存的 App ID 、App Secret 填写到这里并保存。

编写代码,安装依赖,并上线函数

复制代码

打开代码页面,复制代码,并在你自己的云函数界面创建同名文件,粘贴对应的内容。

安装依赖

粘贴代码后,点击左下角 「NPM 管理」中输入框右侧的搜索按钮,在弹出的搜索框中输入 axios ,安装 axios 依赖。

配置环境变量

安装完成后,点击右上角配置框中的环境变量,填入_VERIFICATION_TOKEN_ 和 FLOMO_API 以及对应的值:

  • VERIFICATION_TOKEN:飞书开放平台中,「事件订阅」tab 中的 Verification Token。
  • FLOMO_API: flomo 的 api ,可以从这里获取

上线函数

完成上述的代码配置、依赖安装以及环境变量配置后,接下来需要对函数进行上线操作。点击上方的函数上线按钮,即可将当前函数执行上线。

上线完成后,你会获得一个函数的调用地址,复制这个调用地址。

配置飞书机器人权限和 API 地址

配置 API 地址

完成了函数上线之后,接下来我们到飞书开放平台进行配置。

找到你刚刚创建的飞书应用,点击左侧边栏中的「事件订阅」,在事件订阅页面配置请求网址,在请求网址中粘贴刚刚复制的函数调用地址。

配置事件并申请权限

配置好请求网址 URL 后,点击下方的添加事件,在其中选择「接受消息 v2.0

添加事件后,会自动提醒你需要申请相应的权限, 点击权限名称即可在弹出的窗口中申请权限。这里需要申请「读取用户发给机器人的单聊消息」和「获取用户在群聊中@机器人的消息」两个权限。

提交审核并发布机器人

完成各项配置后,点击左侧 Tab 中的「版本管理与发布」,并创建一个新的版本,填写各项基本信息。

需要注意的是,因为我们在这里没有添加鉴权的部分,所以需要设定可见权限为你自己,避免被其他人录入奇怪的信息。

完成填写后,「保存」并「申请发布」,等待审核通过后,你的机器人就可以在飞书当中使用啦~

在飞书上测试机器人

当你的飞书机器人发布成功后,接下来你就可以给 Flomo 机器人发消息了,比如,发个 #轻服务 Hi,你好,轻服务 试试看吧?