⚠️ Clinikoと連携するには、Practiceプランへの加入が必要です（14日間の無料トライアルをご利用いただけます）。 Clinikoとの連携は現在、オーストラリアのみでご利用いただけます。 これはHeidi記録自動作成とHeidi Commsの両方に適用されます。
ビデオデモ — Clinikoのセットアップと使用方法
Cliniko APIキーを生成する
ClinikoでAPIキーを1つ生成し、それを使って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に移動して設定 → 電子カルテ連携 → Clinikoに進みます。
連携をセットアップをクリックし、APIキーを貼り付けます。
連携を接続をクリックします。
接続が完了すると、確認画面が表示されます。 エラーが発生した場合は、サポートチームがお手伝いします。
Practitioner IDを求められた場合
セットアップ中にPractitioner IDの入力を求められる医師・医療従事者もいます。 Clinikoで確認するには：
左側のメニューバーでSettingsをクリックします。
「Our clinic」の下にあるUsers & practitionersを開きます。
自分自身を選択します。
Edit their practitioner settingsをクリックします。
Practitioner IDはURL内の
/practitioners/と/editの間にあります。
Heidi記録自動作成をClinikoで使用する
左側のメニューからSessionsパネルを開きます。
SessionsパネルでScheduleタブを選択します。
カレンダーアイコンをクリックして日付を選択します。 デフォルトでは本日の診察が表示されます。
希望の予約を見つけて患者を選択します。
通常通り診察を行います。
必要に応じて記録を確認・編集します。
準備ができたら、Clinikoに記録をプッシュをクリックします。 HeidiはClinikoのその患者のファイルに新しいTreatment記録を作成します。
💡 重要：「Clinikoにプッシュ」ボタンが表示されるのは、Scheduleタブから開いた患者のみです。
記録の作成と更新
初めて記録をプッシュすると、Heidiは下書きステータスでClinikoにTreatment記録を作成します。
記録を再度プッシュすると、既存のTreatment記録がまだ下書きである限り、Heidiはそれを更新します。
ClinikoのTreatment記録が確定またはアーカイブされている場合、再度プッシュすると代わりに新しい記録が作成されます。
Heidi CommsをClinikoに接続する
Heidi Commsは上記で生成した同じCliniko APIキーを使用しますが、さらに2つの情報が必要です：リージョンコードとベース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にはなぜリージョンコードCが必要なのですか？ Clinikoは世界各地の異なるサーバーでアカウントをホストしています。 リージョンコード（APIキーの末尾にある数文字）により、Heidiはあなたのアカウントがどのサーバーにあるかを判別し、ベースURLはHeidiがそこにアクセスするための完全なアドレスです。 Clinikoの開発者ドキュメントで「shard」という言葉を見たことがある場合、それは同じ意味です — ここでは「リージョンコード」という表現を使用しています。その方がわかりやすいためです。
接続ステップが失敗する場合は、ベースURL内のリージョンコードがAPIキーの末尾と完全に一致していること、余分なスペースがないことを再確認してください。
いずれかの連携のセットアップで問題が発生した場合は、サポートチームまでお問い合わせください — お手伝いします。