Cliniko API 키 설정하기

핵심 요약

• Cliniko의 My info → Manage API keys에서 키를 만든 뒤, Hanah의 Cliniko 연결 설정에 붙여넣으세요.
• API 연결은 Cliniko 일정을 Hanah로 가져오고, 완성된 기록을 환자 기록에 다시 등록할 수 있게 해요.
• 브라우저 확장 프로그램은 Cliniko 페이지에 녹음과 초안 작성 기능을 더해 주며, API 키 없이도 쓸 수 있어요.
• API 연결과 브라우저 확장 프로그램은 업무 흐름의 서로 다른 부분을 맡아요. 필요한 조합을 시험해 보세요.

Hanah는 Cliniko 공식 연동 앱이에요. Hanah와 Cliniko를 함께 쓰는 방법은 두 가지이고, 둘을 함께 쓸 수도 있어요.

• API 키 — 한 번만 붙여넣으면 Hanah가 예약을 읽고 완성된 기록을 올바른 환자 기록에 다시 등록할 수 있어요.
• 브라우저 연동 — 이미 열어 둔 Cliniko 페이지에 Hanah를 띄워 주는 확장 프로그램으로, 보고 있는 환자 화면을 떠나지 않고 녹음하고 초안을 작성할 수 있어요. 키가 필요 없어요.

이 글에서는 복사해 붙여넣는 단계가 있는 키부터 먼저 설명해요. 그다음 확장 프로그램을 추가해 Cliniko 안에서 작동하는 모습을 볼 거예요. 읽기보다 보는 게 편하시면, 아래 영상에 처음부터 끝까지 전 과정이 담겨 있어요.

1단계 — Cliniko에서 키 만들기

Cliniko에서 왼쪽 메뉴 맨 아래의 My info(내 정보)를 열고 API keys까지 스크롤한 뒤 Manage API keys(API 키 관리) → Add an API key(API 키 추가)를 선택하세요. 바로 가셔도 돼요: https://your-practice.cliniko.com/user/api-keys/new.

나중에 알아볼 수 있는 이름을 붙이세요. “Hanah”면 충분해요.

Create API key를 누르세요. 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 Web Store의 Hanah 확장 프로그램이 열려요. 설치하고 Hanah에 한 번 로그인한 뒤, Cliniko에서 아무 환자나 열어 보세요.

두 가지가 나타나요. 둘 다 Cliniko 페이지 위에 있어요.

• 오른쪽 아래의 ‘진료’ 버튼. 지금 보고 있는 환자 페이지에서 진료를 녹음하세요. 녹취록은 작은 패널에 쌓이고, 보셔도 되고 무시하셔도 돼요.
• 기록 양식의 초안 버튼. 새 치료 기록을 열면 Hanah가 Cliniko 템플릿 선택 메뉴 옆에 있어요. 진료를 고르고, 생성하고, 초안을 검토하면 기록의 섹션이 채워져요. 일반적인 텍스트 덩어리가 아니라 템플릿에 정의된 섹션이에요.

확장 프로그램은 브라우저에서, 이미 열어 두었고 이미 볼 권한이 있는 페이지 위에서 작동해요. API 키가 필요 없고 Cliniko 서버에도 접근하지 않아요. 그래서 1단계와 2단계를 하기 전에도 작동하고, API를 전혀 제공하지 않는 진료 관리 시스템에서도 작동해요.

무엇이 필요할까요?

대부분의 클리닉은 둘 다 원하고, 둘이 하는 일은 서로 달라요.

Cliniko 안에서만 일하신다면 확장 프로그램만으로도 충분하다고 느끼실 거예요. 그날의 일정을 Hanah에서 보고 거기서 기록을 다시 등록하고 싶다면 키도 추가하세요.

어느 단계에서 막히셨거나, 아직 목록에 없는 시스템을 쓰시나요? 데모를 예약하시면 함께 설정해 드릴게요.

자주 묻는 질문

브라우저 확장 프로그램을 쓰려면 API 키가 필요한가요?

아니요. 확장 프로그램은 키 없이도 Cliniko 페이지에서 녹음과 초안 작성을 지원해요. API 연결은 Hanah 안에서의 일정 확인과 기록 등록이라는 별도의 업무 흐름을 지원해요.

Cliniko 키는 어디서 만드나요?

Cliniko에서 My info를 열고 Manage API keys, Add an API key를 차례로 선택하세요. 만들어진 키를 Hanah의 Cliniko 연결 설정에 붙여넣으면 돼요.

API와 확장 프로그램을 왜 둘 다 쓰나요?

확장 프로그램은 녹음과 초안 작성을 환자 페이지 바로 옆에 둬요. API 연결은 일정을 Hanah로 가져오고, 거기서 완성된 기록을 등록할 수 있게 해요.