设置 Cliniko API 密钥

要点

• 在 Cliniko 的 My info（我的信息）→ Manage API keys（管理 API 密钥）中创建密钥，然后粘贴到 Hanah 的 Cliniko 连接设置中。
• API 连接会把您的 Cliniko 日程带入 Hanah，并支持将完成的病历归档回病历档案。
• 浏览器扩展在 Cliniko 页面上增加录音和起草功能，无需 API 密钥即可使用。
• API 连接和浏览器扩展服务于工作流程的不同环节；请测试您需要的组合。

Hanah 是 Cliniko 官方连接应用。将 Hanah 与 Cliniko 结合使用有两种方式，而且可以叠加使用。

• API 密钥：只需粘贴一次，Hanah 就能读取您的预约，并将完成的病历归档回正确的病历档案。
• 浏览器集成：一个扩展程序，把 Hanah 放到您已打开的 Cliniko 页面上，让您无需离开当前患者页面就能录音和起草。无需密钥。

本文先介绍密钥，因为它需要一步复制粘贴。然后我们会添加扩展，看看它在 Cliniko 中如何运行。如果您更想看而不是读，下面的演示视频完整展示了整个流程。

第 1 步：在 Cliniko 中创建密钥

在 Cliniko 中，从左侧菜单底部打开 My info（我的信息），滚动到 API keys（API 密钥），选择 Manage API keys（管理 API 密钥）→ Add an API key（添加 API 密钥）。也可以直接前往：https://your-practice.cliniko.com/user/api-keys/new。

给它起一个您以后认得出的名字。“Hanah”就可以。

点击 Create API key（创建 API 密钥）。Cliniko 只会显示这个密钥一次：现在就复制，在下一步粘贴到 Hanah 中，之后无需在其他任何地方保留副本。如果丢失了也没关系：归档这个密钥，再创建一个新的即可。

创建之前，有两点值得了解。密钥拥有与您本人相同的 Cliniko 数据访问权限，因此密钥是按个人而非按诊所发放的：每位临床医生都用自己的账户登录并创建自己的密钥。另外，由于这个密钥是为单一应用命名的，以后您可以把它归档，而不影响您连接的其他任何应用。

第 2 步：粘贴到 Hanah 中

在 Hanah 中，从左侧导航打开「集成」。您会看到两个部分：浏览器集成（即第 3 步）和 API 集成。

点击「API 集成」下的 Cliniko 卡片，把密钥粘贴到「API 密钥」字段中。您输入时，Hanah 会向 Cliniko 验证，并显示该密钥所属的从业者，让您在保存之前就能确认它连接到了正确的账户。

第二个字段 Cliniko URL 不属于密钥的一部分：粘贴您 Cliniko 账户中的任意地址（https://your-practice.au5.cliniko.com），Hanah 会用它把患者引导到您的预约页面。Cliniko 的 API 不提供这个地址，所以我们需要您填写。

保存后，卡片会显示「已连接」。设置就此完成。

连接实际上做了什么

• 日程同步过来。预约和患者会出现在 Hanah 中，您无需重新输入姓名，就能为正确的患者开始就诊。
• 病历回到正确的病历档案。完成的病历会与其来源的 Cliniko 患者和预约相匹配。
• 不会自动归档。每份病历在临床医生审阅并确认之前都只是草稿。

在安全方面：密钥存储在服务器端，从不发送到您的浏览器。它的权限范围限于签发它的临床医生，因此病历会归属于正确的从业者。您可以随时在 Cliniko 中归档该密钥来撤销它：它会立即失效，您连接的其他任何应用都不受影响。

第 3 步：在 Cliniko 中查看运行效果

API 密钥连接两个系统。浏览器集成则让 Hanah 在您工作时就出现在眼前。

在同一个「集成」页面添加：「浏览器集成」下的 Cliniko 卡片会在 Chrome 网上应用店中打开 Hanah 扩展。安装后登录一次 Hanah，然后在 Cliniko 中打开任意患者。

会出现两样东西，都在 Cliniko 自己的页面上：

• 右下角的「就诊」按钮。在您已打开的患者页面上直接为诊疗录音。转录稿会在一个小面板中逐步生成，您可以看，也可以不管它。
• 病历表单上的草稿标签。打开一份新的治疗记录，Hanah 就出现在 Cliniko 的模板选择器旁边。选择就诊、生成、审阅草稿，它就会填入病历自身的各个部分：即您的模板定义的部分，而不是一整块通用文本。

扩展在您的浏览器中运行，就在您已经打开、并且本来就有权查看的页面上。它不需要 API 密钥，也不接触 Cliniko 的服务器，所以即使您还没完成第 1 步和第 2 步，它也能工作；它也因此能在完全不提供 API 的诊所管理系统上使用。

您需要哪一种？

大多数诊所两者都需要，它们分工不同：

如果您只在 Cliniko 中工作，单用扩展就已经很完整。如果您还希望在 Hanah 中看到当天的日程，并从 Hanah 归档病历，那就再加上密钥。

在某一步卡住了，或者您使用的系统我们还没有列出？预约演示，我们会和您一起完成设置。

常见问题

使用浏览器扩展需要 API 密钥吗？

不需要。扩展无需密钥即可支持在 Cliniko 页面上录音和起草。API 连接则支持 Hanah 内另外的日程和归档流程。

在哪里创建 Cliniko 密钥？

在 Cliniko 中，打开 My info（我的信息），然后选择 Manage API keys（管理 API 密钥）和 Add an API key（添加 API 密钥）。把生成的密钥粘贴到 Hanah 的 Cliniko 连接设置中。

为什么要同时使用 API 和扩展？

扩展让录音和起草就在患者页面旁边进行。API 连接把日程带入 Hanah，并支持从 Hanah 归档完成的病历。