卡兹克曾经给大家分享过他的选题使用方法,前段时间我有类似的需求,就参考回看了一下。
最致命的问题是,卡佬是直接用的 webhook ,简单好用。 问题是这是付费版飞书才能用 webhook 。 为了这碟子醋再弄饺子显然不值。 那有没有别的方法呢?
有的…… 靴微麻烦一点点。
webhook 流程(大概,我没用):
快捷指令 -> webhook -> 写表格
白嫖免费流程:
快捷指令 ->用自建应用app_id 和 app_secret 获取 tenant_access_token -> 通过自建应用关联文档,使用 tenant_access_token 操作表格
展示使用
在手机上看到一些比较好的内容时,我们想稍后阅读或者作为选题时可以使用这个流程:
设置教程
设置前准备
创建一个自建应用
在 https://open.feishu.cn/app?lang=zh-CN 创建一个自建应用,企业自建应用不需要审核。
需要两个操作:
- 1. 进入应用-> 凭证与基础信息:复制自建应用的 App ID 和 App Secret 备用
- 2. 进入权限管理: 开通权限,添加多维表格的写权限(示例中应该只用了写),我直接全选了,方便以后有变化不需要调整权限
创建一个飞书多维表格
在你的云文档新建一个多维表格
https://my.feishu.cn/wiki/{app_token}?table={table_id}&view={view_id}
基本字段只有添加选题时的想法 notes 和链接 url (记住后面要用)
如果你觉得不够,或者可以增强,可以基于已有的链接或想法扩展,甚至通过你已有的内容直接调用模型干点什么,比如直接用你的风格,语言二创。 这里我添加了两个字段:
- 1. 通过url 内容自动添加摘要
- 2. 通过摘要添加分类标签
然后获得了完整的表格
- • 添加文档应用(确保添加)
在右上的 “…” 菜单把你创建的应用添加到文档,打开窗口后搜索名字直接添加就可以。
!!! 这阶段需要记住后面用的东西
- • 这个多维表格的网址:https://my.feishu.cn/wiki/{app_token}?table={table_id}&view={view_id}
- • app_token
- • table_id
- • 表格中的注释和链接的列名(可以自己随便命名,示例是 notes 和 url)
相关文档: https://open.feishu.cn/document/server-docs/docs/bitable-v1/bitable-overview
复制好需要的内容
- • 自建应用:App Id
- • 自建应用:App Secret
- • 通过多维表格网址复制的 app_token
- • 通过多维表格网址复制的 table_id
- • 多维表格的基础字体名 notes, url
准备好这些,我们开始用 iphone 创建快捷指令。
设计快捷指令
快捷指令里面发送请求我们需要用到: 获取URL内容 , 添加时搜索“获取”
我的使用流程是这样的,懒人几乎不想打一个字,直接用语音代替打字。
所以指令的流程是:
看到好的内容,复制链接 -> 轻击背面两下:通过语音录入 -> 获得语音文本作为 notes -> 通过飞书 API 请求 tenant_access_token -> 获取 tenant_access_token -> 用 tenant_access_token 把语音文本的链接同步到表格
流程知道了,需要准备的东西也有了, 主要是需要完成鉴权和内容同步。
其实听写文本,字典这些几乎不用设置,所以就不讲了。 但是需要特殊提醒的是: 编辑时超级容易误操作,格外小心!
在调试时如果不确定每一步结果如何,可以在步骤后面添加一个:显示内容 , 方便调试,完成后删除就行。
关键点在于通过快捷指令来构建两个请求:
自建应用获取 tenant_access_token
通过 POST 请求用 app_id 和 app_secret 从端点 https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal 换取 token。 我们需要用 快捷指令构建。
所以这里比较简单,加一个请求头请求格式是 json (不需要修改)
Content-Type:application/json
请求体,你的自建 app 的 id 和 secret
新增多维表格记录
因为我们只用到新增,这里展示新增和构建方式 ,可以在官方的开发文档中直接测试 https://open.feishu.cn/document/server-docs/docs/bitable-v1/app-table-record/create
如果你有其它的操作,同样可以参考文档的字段和请求格式处理 : https://open.feishu.cn/document/server-docs/docs/bitable-v1/bitable-overview
我们同样使用快捷指令的 获取URL内容 完成表格记录添加,根据官方格式要求我们需要:
- • 在请求头使用 Authrization: Bearer tenant_access_token
- • 在请求头添加固定值 Content-Type: application/json
- • 请求路径参数中使用多维表格的 app_token
- • 请求路径参数中使用多维表格的 table_id
- • 请求体需要添加到 fields 键里
通过前面保存的 app_token 和 table_id ,写出请求 url 端点。
请求方法用 POST
添加请求头: 因为快捷指令前面已经用词典获取了 tenant_acces_token ,所以这里直接选就可以,注意 Bearer 后面有一个空格
注意: 因为请求体在 fields 键,并且链接类型的内容不能只给链接。 所以:
请求体先创建一个 词典, 词典的键是 fields
然后点击 后面的 ”2项“, 刚创建时是 “0项” 因为没添加东西
进入到 fields 键以后,是我们的表格内容的构建, 比如我们有两项: notes 和 url , notes 就是一个字符,直接选择”文本“类型,选择前面我们已经听写获得的文本就可以。
但是超链接的格式是需要有 link 和 text 的,请求体的格式应该是:
{
"fields": {
"notes": "这是笔记",
"url": {
"text": "baidu",
"link": "https://www.baidu.com"
}
}
}
我们需要在 fields 里面再添加一个 词典, 键 url (对应飞书的列名),然后在里面添加两个文本, text 和 link 省事我们直接使用 ”剪贴板“
启用轻点
设置 -> 辅助功能 -> 触控 -> 轻点背面: 轻点两下—— 选题快速收集到飞书
enjoy。