⚠️ 若要與 Cliniko 整合，您需要使用 Practice 方案（提供 14 天免費試用）。 Cliniko 整合目前僅在澳洲提供。這適用於 Heidi 記錄和 Heidi Comms。

影片示範 — 設定並使用 Cliniko

產生您的 Cliniko API 金鑰

您將在 Cliniko 中產生一個 API 金鑰，然後用它將 Cliniko 連接至 Heidi 記錄、Heidi Comms，或兩者皆連接。請先在 Cliniko 中完成以下步驟，然後跳至您正在設定的 Heidi 相關區段。

登入您的 Cliniko 帳號。
點擊畫面左下角您姓名旁邊的箭頭。
點擊 My Info。
向下捲動至 API keys 區段。將標示「Allow yourself to create and use API keys」的開關切換至 Yes。
點擊頁面底部的 Update user。
Cliniko 將要求您以密碼或通行金鑰驗證身份。
驗證完成後，頁面將重新整理。在 API keys 下方，點擊 Manage API keys。
在 API Keys 頁面上，點擊 Add an API Key。
為您的 API 金鑰命名。我們建議使用「Heidi Health」，這樣您之後可以輕鬆辨識。
點擊 Create API Key。您將看到一串字母和數字 — 那就是您的 API 金鑰。 請立即複製 — Cliniko 不會再次顯示。如果錯過了，您隨時可以建立新的金鑰。

💡 如需了解更多關於 Cliniko API 金鑰的資訊，請參閱 Cliniko 的說明文章。

您現在可以將 Cliniko 連接至 Heidi 了。請選擇下方相關區段，或同時設定兩者。

將 Heidi 記錄連接至 Cliniko

複製 API 金鑰後，前往 Heidi 並導覽至 Settings → EMR 整合 → Cliniko。
點擊 Set up Integration，然後貼上您的 API 金鑰。
點擊 Connect Integration。
連接成功後，您將看到確認畫面。如果遇到任何錯誤，我們的支援團隊隨時為您提供協助。

如果系統要求您輸入 Practitioner ID

部分臨床醫師在設定過程中會收到輸入 Practitioner ID 的提示。若要在 Cliniko 中找到您的 Practitioner ID：

點擊左側選單列中的 Settings。
在「Our clinic」下方開啟 Users & practitioners。
選擇自己。
點擊 Edit their practitioner settings。
您的 Practitioner ID 在網址中，位於 /practitioners/ 和 /edit 之間。

搭配 Cliniko 使用 Heidi 記錄

從左側選單開啟 Sessions 面板。
在 Sessions 面板中，選擇 Schedule 標籤。
點擊日曆圖示選擇日期。預設顯示今日的診療工作階段。
找到您要的預約並選擇病患。
照常進行您的診療。
視需要審閱並編輯您的記錄。
準備好後，點擊 Push note to Cliniko。 Heidi 將在該病患的 Cliniko 檔案中建立一則新的 Treatment 記錄。

💡 重要：只有從 Schedule 標籤開啟的病患才會顯示「Push to Cliniko」按鈕。

建立及更新記錄

第一次推送記錄時，Heidi 會在 Cliniko 中以草稿狀態建立 Treatment 記錄。
如果再次推送記錄，只要該記錄仍為草稿狀態，Heidi 將更新現有的 Treatment 記錄。
如果 Cliniko 的 Treatment 記錄已完成或封存，再次推送將改為建立新記錄。

將 Heidi Comms 連接至 Cliniko

Heidi Comms 使用與上述相同的 Cliniko API 金鑰，另外還需要兩項額外資訊：您的地區代碼和基礎 URL。

複製 API 金鑰後，開啟 Heidi Comms 並點擊 Integrations 標籤。
將您的 Cliniko API 金鑰貼入 API key 欄位。
找到您的地區代碼。 您的 API 金鑰末尾有一個短代碼（例如 au1、au4 或 uk1），用於告知 Heidi 您的帳戶所在的 Cliniko 伺服器。查看您的金鑰，找到最後一個連字號（-）之後的幾個字元 — 那就是您的地區代碼。
輸入您的基礎 URL。 您的基礎 URL 是 Heidi 用來與 Cliniko 通訊的地址。在下一個欄位中，貼上以下 URL 並將 REGION 替換為您剛才找到的值：
```
<https://api.REGION.cliniko.com/v1>
```
例如，如果您的地區代碼是 au4，您的基礎 URL 則為：
```
<https://api.au4.cliniko.com/v1>
```
點擊 Connect to Cliniko。大功告成。

💡 Heidi 為何需要「地區代碼」？ Cliniko 在世界各地的不同伺服器上託管不同帳戶。地區代碼（API 金鑰末尾的幾個字元）告知 Heidi 您的帳戶所在的伺服器，而基礎 URL 則是 Heidi 用來連接該伺服器的完整地址。如果您在 Cliniko 的開發者文件中看過「shard」一詞，那與地區代碼是同一回事 — 我們在此使用「地區代碼」是因為它更為清晰易懂。

如果連接步驟失敗，請再次確認基礎 URL 中的地區代碼與 API 金鑰末尾完全相符，且沒有多餘的空格。

如果您在設定任一整合時遇到問題，請聯繫我們的支援團隊 — 我們隨時為您提供協助。