הגדרת מפתח ה-API של Cliniko

עיקרי הדברים

• יוצרים מפתח ב-Cliniko תחת My info → Manage API keys, ואז מדביקים אותו בהגדרות החיבור ל-Cliniko ב-Hanah.
• חיבור ה-API מביא את היומן שלכם מ-Cliniko אל Hanah, ומאפשר לשמור רשומות סופיות בחזרה בתיק המטופל.
• התוסף לדפדפן מוסיף הקלטה וניסוח בעמודים של Cliniko, ואפשר להשתמש בו בלי מפתח API.
• חיבור ה-API והתוסף לדפדפן משרתים חלקים שונים של תהליך העבודה. בדקו את השילוב שאתם צריכים.

Hanah היא אפליקציה מחוברת רשמית של Cliniko. יש שתי דרכים לחבר בין Hanah ל-Cliniko, ואפשר להשתמש בשתיהן יחד.

• מפתח ה-API: הדבקה חד-פעמית שמאפשרת ל-Hanah לקרוא את התורים שלכם ולשמור רשומות סופיות בחזרה בתיק המטופל הנכון.
• האינטגרציה בדפדפן: תוסף שמציב את Hanah בעמודים של Cliniko שכבר פתוחים אצלכם, כך שאפשר להקליט ולנסח בלי לעזוב את המטופל שאתם נמצאים אצלו. לא צריך מפתח.

הפוסט הזה מתחיל במפתח, כי בו יש שלב של העתקה והדבקה. אחר כך נוסיף את התוסף ונראה אותו עובד בתוך Cliniko. אם אתם מעדיפים לראות במקום לקרוא, הסרטון שלמטה מציג את כל התהליך מההתחלה ועד הסוף.

שלב 1 – יוצרים את המפתח ב-Cliniko

ב-Cliniko, פתחו את My info מתחתית התפריט השמאלי, גללו אל API keys ובחרו Manage API keys → Add an API key. אפשר גם להגיע ישירות: https://your-practice.cliniko.com/user/api-keys/new.

תנו לו שם שתזהו אחר כך. "Hanah" יעשה את העבודה.

לחצו על Create API key. Cliniko מציגה לכם את המפתח פעם אחת בלבד: העתיקו אותו עכשיו, הדביקו אותו ב-Hanah בשלב הבא, ולא תצטרכו לשמור עותק בשום מקום אחר. אם איבדתם אותו, זה לא נורא: מעבירים את המפתח הזה לארכיון ויוצרים חדש.

שני דברים שכדאי לדעת לפני שיוצרים אותו. למפתח יש בדיוק אותה גישה לנתוני Cliniko שיש לכם, ולכן המפתחות הם אישיים ולא של הקליניקה: כל מטפל יוצר מפתח משלו מתוך החשבון שלו. ומכיוון שנתתם למפתח הזה שם של אפליקציה אחת, תוכלו להעביר אותו לארכיון בהמשך בלי לפגוע בשום דבר אחר שחיברתם.

שלב 2 – מדביקים אותו ב-Hanah

ב-Hanah, פתחו את Integrations מתפריט הניווט השמאלי. תראו שני חלקים: האינטגרציה בדפדפן (זה שלב 3) ואינטגרציית ה-API.

לחצו על הכרטיס של Cliniko תחת API integration והדביקו את המפתח בשדה API key. Hanah בודקת אותו מול Cliniko תוך כדי הקלדה ומציגה את המטפל שהמפתח שייך לו, כך שתדעו שהוא נכנס לחשבון הנכון עוד לפני ששמרתם משהו.

השדה השני, Cliniko URL, אינו חלק מהמפתח: הדביקו כל כתובת מחשבון ה-Cliniko שלכם (https://your-practice.au5.cliniko.com), ו-Hanah משתמשת בה כדי להפנות מטופלים לעמוד קביעת התורים שלכם. ה-API של Cliniko לא מוסר את הכתובת הזו, ולכן אנחנו מבקשים אותה.

שומרים, והכרטיס מציג Connected. זו כל ההגדרה.

מה החיבור עושה בפועל

• היומן שלכם עובר. תורים ומטופלים מופיעים ב-Hanah, כך שמתחילים מפגש מול האדם הנכון בלי להקליד שם מחדש.
• הרשומות חוזרות לתיק הנכון. רשומה סופית מותאמת למטופל ולתור ב-Cliniko שמהם היא הגיעה.
• שום דבר לא נשמר מעצמו. כל רשומה היא טיוטה עד שמטפל בודק אותה ומאשר.

מבחינת אבטחה: המפתח נשמר בצד השרת ולעולם לא נשלח לדפדפן שלכם. הוא מוגבל למטפל שהנפיק אותו, כך שהרשומות משויכות למטפל הנכון. ואפשר לבטל אותו מ-Cliniko בכל עת על ידי העברת המפתח לארכיון: הוא מפסיק לעבוד מיד, ושום דבר אחר שחיברתם לא מושפע.

שלב 3 – רואים את זה עובד בתוך Cliniko

מפתח ה-API מחבר בין שתי המערכות. האינטגרציה בדפדפן היא מה שמציב את Hanah מולכם בזמן העבודה.

מוסיפים אותה מאותו עמוד Integrations: הכרטיס של Cliniko תחת Browser integration פותח את התוסף של Hanah ב-Chrome Web Store. מתקינים אותו, נכנסים ל-Hanah פעם אחת, ואז פותחים מטופל כלשהו ב-Cliniko.

מופיעים שני דברים, שניהם בעמודים של Cliniko עצמה:

• כפתור Visit, בפינה הימנית התחתונה. מקליטים את המפגש מעמוד המטופל שאתם כבר נמצאים בו. התמליל נבנה בחלונית קטנה שאפשר לעקוב אחריה או להתעלם ממנה.
• תווית טיוטה בטופס הרשומה. פותחים רשומת טיפול חדשה, ו-Hanah נמצאת ליד בורר התבניות של Cliniko. בוחרים את הביקור, מפיקים, בודקים את הטיוטה, והיא ממלאת את החלקים של הרשומה עצמה: אלה שהתבנית שלכם מגדירה, ולא גוש טקסט כללי.

התוסף פועל בדפדפן שלכם, בעמוד שכבר פתוח אצלכם ושיש לכם הרשאה לראות. הוא לא צריך מפתח API ולא נוגע בשרתים של Cliniko, ולכן הוא עובד עוד לפני שביצעתם את שלבים 1 ו-2, וגם במערכות ניהול קליניקה שלא מציעות API בכלל.

מה אתם צריכים?

רוב הקליניקות רוצות את שניהם, והם עושים עבודות שונות:

אם אתם עובדים רק בתוך Cliniko, התוסף לבדו ירגיש שלם. אם אתם רוצים גם את יומן היום שלכם ב-Hanah, ורשומות שנשמרות בחזרה משם, הוסיפו את המפתח.

נתקעתם באחד השלבים, או שאתם עובדים במערכת שעוד לא הזכרנו? קבעו הדגמה ונגדיר את זה יחד איתכם.

שאלות נפוצות

האם צריך מפתח API כדי להשתמש בתוסף לדפדפן?

לא. התוסף יכול לתמוך בהקלטה ובניסוח בעמוד של Cliniko בלי מפתח. חיבור ה-API תומך בתהליך הנפרד של היומן ושל שמירת הרשומות בתוך Hanah.

איפה יוצרים את המפתח של Cliniko?

ב-Cliniko, פותחים את My info, ואז Manage API keys ו-Add an API key. מדביקים את המפתח שנוצר בהגדרות החיבור ל-Cliniko ב-Hanah.

למה להשתמש גם ב-API וגם בתוסף?

התוסף שומר את ההקלטה והניסוח ליד עמוד המטופל. חיבור ה-API מביא את היומן אל Hanah ותומך בשמירת רשומות סופיות משם.