用 vika 维格云 API 配合 iOS 快捷指令实现语音待办录入

vika 维格云是一款面向 API 的智能多维表格，数据存放在表里，同时可以通过开放 API 从外部写入和读取。这篇教程要解决的是一个很具体的问题：在 iPhone 上不打开任何 App，轻点手机背面说一句话，这句话就作为一条待办记录写进指定的 vika 数据表。实现方式是 iOS 系统自带的「快捷指令」调用 vika 的 API，不需要写原生代码，也不需要自己搭服务端。适合已经在用 vika 管理任务、又希望把录入动作压缩到一两秒的人，也适合想先摸清 vika API 调用方式、之后再扩展到其他业务系统的开发者。如果你还想了解这个工具的其他用法，可以看 vika 维格云 的工具页。

整条链路由四段组成：一张准备好的数据表、一个数据表 ID、一个开发者 Token、一段配置好的快捷指令。四段里任何一段出错，最终表现都是「说了话但表里没数据」，所以下面的步骤会特别强调每一段该从哪里取、该长什么样。

准备工作

账号与数据表

需要一个可用的 vika 维格云账号，并且已经登录到自己的工作空间。教程使用一张现成的待办模板表作为起点，把它复制到自己的空间里，后续所有配置都指向这张复制出来的表。不要直接在模板原件上操作，模板表通常不属于你的空间，权限和 ID 都对不上。

设备与系统

• 一台 iPhone，系统需要支持「轻点背面」这一辅助功能，素材中的要求是 iOS 14 及以上。
• 系统自带的「快捷指令」App，不需要额外安装第三方工具。
• 手机能正常联网，因为快捷指令最终是向 vika 的 API 发 HTTP 请求。

需要提前拿到的两个值

整个配置过程中真正需要手工填写的只有两个字符串，务必先取到手再开始配快捷指令：

• 数据表 ID：以 dst 开头的一串字符。
• 开发者 Token：在 vika 用户中心的开发者配置里复制得到。

这两个值都属于敏感信息，Token 等同于账号在该空间下的调用凭证，不要贴到公开的聊天群、截图或代码仓库里。

操作步骤

第一步：把模板复制到自己的空间

打开待办模板，选择保存或复制到自己的空间。复制完成后，在自己的空间里打开这张表，确认表结构和字段都正常显示。这一步的意义不只是拿到数据，更是确认你对这张表有写入权限——如果表在别人的空间里，即使 API 调用格式完全正确，写入也会失败。

第二步：从浏览器地址栏取出数据表 ID

在浏览器中打开刚复制好的表，看地址栏。数据表 ID 的特征很明确：

• 以 dst 开头；
• 位于地址中两个斜杠 / 之间；
• 是一段连续的字符串，中间没有空格。

把这一段完整复制下来，先存到备忘录里。地址栏里还有空间 ID、视图 ID 等其他片段，它们同样夹在斜杠之间，很容易复制错。判断方法就是看开头是不是 dst。复制时注意不要带上前后的斜杠，也不要把换行带进去。

第三步：打开「允许不受信任的快捷指令」

如果这台 iPhone 从来没有用过快捷指令，需要先打开一个开关，否则从链接添加的快捷指令无法运行。路径是：设置 → 快捷指令 → 打开「允许不受信任的快捷指令」。

这里有一个常见的卡点：第一次使用快捷指令功能时，这个开关可能是灰的，点不动。解决办法是先在「快捷指令」App 里用系统自带的任意一个快捷指令完整跑一次，让系统认为你已经使用过该功能，再回到设置里打开开关。

第四步：把语音待办快捷指令添加到「我的快捷指令」

在 iPhone 的浏览器中打开语音待办快捷指令的分享链接，页面会提供「获取捷径」的入口，点击后该快捷指令会被保存到「我的快捷指令」列表里。添加完成后，打开「快捷指令」App，在「我的快捷指令」中找到它，接下来要改的就是它内部的两个文本变量。

第五步：填入数据表 ID 与开发者 Token

打开这个快捷指令的编辑界面，找到「执行」区块里的第一个「文本」动作，把第二步拿到的数据表 ID 填进去；第二个文本动作填入开发者 Token。这两个值就是快捷指令向 vika API 发起请求时携带的目标表与身份凭证。

开发者 Token 的获取路径：在 vika 界面右下角打开「用户中心」，找到开发者配置，点击复制 API Token。复制后直接粘贴到快捷指令的文本动作里，不要手工重新敲一遍。

填写完成后，在快捷指令的「文稿」设置中允许语音识别访问，然后点右上角「完成」保存。到这一步，快捷指令本身已经可以运行了，剩下的只是给它配一个触发方式。

第六步：设置「轻点背面」触发

依次进入：设置 → 辅助功能 → 动作交互 → 触控 → 拉到最下方找到「轻点背面」。可以选择「轻点两下」或「轻点三下」，按自己的使用习惯来。选中之后，在下方列表的「快捷指令」分类里找到刚才添加的语音待办快捷指令并勾选。

选择两下还是三下有个实际考量：轻点两下更容易误触，比如把手机放桌上、从口袋里掏出来时都可能触发；轻点三下误触率低，但操作稍慢。如果日常会频繁把手机放下拿起，建议先用三下。

第七步：实际触发一次

轻点手机背面，快捷指令会启动语音识别，说出待办内容，识别结束后请求发往 vika，记录写入数据表。回到表里刷新，应该能看到新增的一行。如果表里没有出现记录，先不要怀疑 API 或权限，直接跳到「注意事项」里的空格与换行排查。

一个完整示例

下面按时间顺序走一遍从零到可用的完整流程，可以对照着操作。

场景：手上有一张待办表，希望在通勤路上想到什么就记什么，不用解锁找 App。

1. 登录 vika，打开待办模板，选择复制到自己的空间，命名为「我的待办」。
2. 在自己的空间里打开「我的待办」，看浏览器地址栏，找到形如 dst 开头的那一段，复制。假设复制到的内容是 dstXXXXXXXXXXXX（实际值以你自己的地址栏为准）。
3. 点右下角进入用户中心 → 开发者配置 → 复制 API Token，粘贴到备忘录，标记为「vika token」。
4. 在 iPhone 上打开设置 → 快捷指令，若「允许不受信任的快捷指令」是灰的，先去快捷指令 App 跑一次自带指令，再回来打开开关。
5. 用 Safari 打开语音待办快捷指令的分享链接，点「获取捷径」，确认它出现在「我的快捷指令」里。
6. 打开该快捷指令，第一个文本动作粘贴 dstXXXXXXXXXXXX，第二个文本动作粘贴 API Token。检查两处粘贴内容的首尾都没有多余空格和换行。
7. 在「文稿」中允许语音识别访问，点右上角「完成」。
8. 设置 → 辅助功能 → 动作交互 → 触控 → 轻点背面 → 轻点两下 → 选择该快捷指令。
9. 轻点手机背面两下，说「明天上午十点跟设计确认首页改版」，等识别结束。
10. 回到 vika 打开「我的待办」，确认新增了一条记录，内容与刚才说的一致。

如果第 10 步没有看到记录，按下面的顺序排查，不要一上来就重建快捷指令：

• 重新打开快捷指令，逐个检查两个文本动作，光标放到内容末尾看有没有多出一行。
• 确认数据表 ID 是 dst 开头的那一段，而不是地址里其他夹在斜杠之间的片段。
• 确认 Token 是从用户中心的开发者配置里复制的完整值，没有在粘贴时被截断。
• 确认这张表在你自己的空间里，而不是模板原件或他人共享给你的只读表。
• 确认语音识别权限已允许，否则快捷指令会在识别阶段就停下，请求根本不会发出。

注意事项

空格与换行是最常见的失败原因

在复制粘贴数据表 ID 和 API Token 时，不能有多余的空格，也不能跨行。从浏览器地址栏复制时很容易带上首尾空白，从备忘录复制时很容易带上换行符。这两个字符在界面上几乎看不出来，但会让请求里的表标识或凭证变成另一个字符串，服务端自然无法识别。设置完成后如果语音输入没有同步到表里，优先排查这一项，而不是怀疑接口本身。

Token 的保管

开发者 Token 是调用凭证，拿到它就能以你的身份操作对应空间的数据。不要把它写进公开文档、截图分享或提交到代码仓库。如果怀疑泄露，应在用户中心的开发者配置里重新生成，并同步更新快捷指令里的文本动作。

快捷指令的权限开关

「允许不受信任的快捷指令」这个开关在首次使用时可能无法打开，需要先在快捷指令 App 里运行一次系统自带指令。这是系统层面的限制，与 vika 无关，但会直接卡住第四步。

轻点背面的误触

轻点两下比轻点三下更容易被日常动作误触发。如果发现表里出现莫名其妙的空记录或重复记录，先检查是不是误触导致快捷指令被反复唤起。

适用范围

这套方案适合简单的数据录入，比如待办事项、备忘录这类字段少、结构固定的场景。它依赖快捷指令自身的编程能力去发请求，不需要编写复杂的快捷指令逻辑。如果要做批量导入、多表关联写入或带复杂校验的录入，就不适合继续在快捷指令里堆动作，应该改为在服务端调用 vika 的开放 API。

价格与配额

vika 维格云的套餐、API 调用配额、空间成员数量等属于会调整的信息，本文不给出具体数字。实际使用前请以官网当前公布的套餐说明与开发者文档为准，尤其是打算把 API 用于生产环境时，先确认所在套餐的调用限制。

把同一套思路用到其他场景

语音待办只是 vika API 最轻量的一个用法。这套「快捷指令发请求 → vika 写入」的结构可以替换成别的触发源和别的目标表：把语音识别换成扫码，就能做现场盘点录入；把待办表换成客户跟进表，就能在拜访结束后立刻记录一条跟进；把触发方式从轻点背面换成快捷指令里的时间自动化，就能定时把某些数据推到表里。

再往前一步，vika 的开放 API 可以让表格与第三方业务系统、智能硬件对接。企业场景里常见的项目数据分散在多个部门、多个系统，各自维护一份 Excel，口径对不上；通过 API 把各系统的数据汇总到同一张多维表，再用视图做筛选和看板展示，可以省掉大量手工汇总。这类集成通常需要服务端参与，不适合放在快捷指令里做，但调用的接口和凭证体系与本文是同一套——先在小场景里把表 ID、Token、字段结构摸清楚，再扩展到系统对接会顺利很多。

配置完成后的检查清单

把下面几项逐条确认一遍，可以避免绝大多数「配了但没生效」的情况：

• 模板已复制到自己的空间，且自己对该表有写入权限。
• 数据表 ID 以 dst 开头，取自浏览器地址栏两个斜杠之间。
• Token 从用户中心开发者配置复制，完整无截断。
• 两个文本动作的内容首尾无空格、无换行。
• 「允许不受信任的快捷指令」已打开。
• 快捷指令的「文稿」中已允许语音识别访问。
• 「轻点背面」已绑定到该快捷指令，且选择的次数与自己的使用习惯匹配。
• 实测一条记录，回到表里确认字段落在正确的列上。

全部确认之后，这套录入方式就可以日常使用了。后续如果要改目标表，只需要替换第一个文本动作里的数据表 ID；如果要换账号或重新生成凭证，只需要替换第二个文本动作里的 Token，其余配置不用动。