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 中「应用功能」中的「机器人」页面,开启机器人功能。

创建轻服务应用

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

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

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

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

复制代码

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

安装依赖

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

配置环境变量

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

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

上线函数

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

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

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

配置 API 地址

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

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

配置事件并申请权限

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

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

此外,你还需要在权限管理中申请「以应用的身份发消息」这个权限。

提交审核并发布机器人

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

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

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

在飞书上测试机器人

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