إعداد مفتاح 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. وإن كنتم تفضّلون المشاهدة على القراءة، فالفيديو أدناه يعرض العملية كاملة من البداية إلى النهاية.

الخطوة ١: إنشاء المفتاح في 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 التي تملكونها أنتم، لذلك تكون المفاتيح لكل شخص لا لكل عيادة، فيُنشئ كل ممارس مفتاحه من حساب دخوله. ولأنكم سمّيتم هذا المفتاح لتطبيق واحد، يمكنكم أرشفته لاحقًا دون التأثير في أي شيء آخر ربطتموه.

الخطوة ٢: لصقه في Hanah

في Hanah، افتحوا «Integrations» من شريط التنقل الأيسر. سترون قسمين: التكامل عبر المتصفح (وهو الخطوة ٣) والتكامل عبر API.

انقروا على بطاقة Cliniko تحت «API integration» والصقوا المفتاح في حقل «API key». تتحقق Hanah منه لدى Cliniko أثناء الكتابة وتعرض لكم الممارس الذي يعود إليه المفتاح، فتعرفون أنه وصل إلى الحساب الصحيح قبل أن تحفظوا أي شيء.

الحقل الثاني، «Cliniko URL»، ليس جزءًا من المفتاح: الصقوا أي عنوان من حسابكم في Cliniko (https://your-practice.au5.cliniko.com)، وستستخدمه Hanah لتوجيه المرضى إلى صفحة الحجز لديكم. فواجهة API في Cliniko لا تقدّم هذا العنوان، ولهذا نطلبه.

احفظوا، وستظهر على البطاقة عبارة «Connected». هذا هو الإعداد كله.

ما الذي يفعله الاتصال فعلًا

• ينتقل جدول مواعيدكم. تظهر المواعيد والمرضى في Hanah، فتبدؤون الجلسة مع الشخص الصحيح دون إعادة كتابة اسمه.
• تعود الملاحظات إلى الملف الصحيح. تُطابَق الملاحظة النهائية مع مريض Cliniko والموعد الذي جاءت منه.
• لا شيء يُحفظ من تلقاء نفسه. كل ملاحظة مسودة إلى أن يراجعها الممارس ويعتمدها.

من ناحية الأمان: يُخزَّن المفتاح على الخادم ولا يُرسل إلى متصفحكم أبدًا. ويقتصر نطاقه على الممارس الذي أصدره، فتُنسب الملاحظات إلى الممارس الصحيح. ويمكنكم إلغاؤه من Cliniko في أي وقت بأرشفة ذلك المفتاح، فيتوقف عن العمل فورًا، ولا يتأثر أي شيء آخر ربطتموه.

الخطوة ٣: مشاهدته يعمل داخل Cliniko

يربط مفتاح API بين النظامين. أما التكامل عبر المتصفح فهو ما يضع Hanah أمامكم أثناء العمل.

أضيفوه من صفحة «Integrations» نفسها: تفتح بطاقة Cliniko تحت «Browser integration» إضافة Hanah في متجر Chrome الإلكتروني. ثبّتوها، وسجّلوا الدخول إلى Hanah مرة واحدة، ثم افتحوا ملف أي مريض في Cliniko.

يظهر عنصران، كلاهما في صفحات Cliniko نفسها:

• زر «Visit» في أسفل اليمين. سجّلوا الاستشارة من صفحة المريض التي تعملون عليها. ويتكوّن التفريغ النصي في لوحة صغيرة يمكنكم متابعتها أو تجاهلها.
• زر المسودة في نموذج الملاحظات. افتحوا ملاحظة علاج جديدة، وستظهر Hanah بجانب أداة اختيار القوالب في Cliniko. اختاروا الزيارة، وأنشئوا المسودة، وراجعوها، فتملأ أقسام الملاحظة نفسها، أي الأقسام التي يحددها قالبكم، لا كتلة نص عامة.

تعمل الإضافة في متصفحكم، على الصفحة المفتوحة أمامكم والتي يحق لكم رؤيتها أصلًا. ولا تحتاج إلى مفتاح API ولا تتصل بخوادم Cliniko، ولهذا تعمل حتى قبل أن تُنجزوا الخطوتين ١ و٢، ولهذا أيضًا تعمل مع أنظمة إدارة العيادات التي لا تقدّم واجهة API على الإطلاق.

أيهما تحتاجون؟

تريد معظم العيادات الاثنين معًا، فلكل منهما مهمة مختلفة:

إن كنتم تعملون داخل Cliniko فقط، فستبدو الإضافة وحدها كافية. وإن أردتم أيضًا جدول يومكم في Hanah وحفظ الملاحظات من هناك، فأضيفوا المفتاح.

هل تواجهون صعوبة في أي من الخطوتين، أو تستخدمون نظامًا لم نذكره بعد؟ احجزوا عرضًا توضيحيًا وسنُعِدّه معكم.

الأسئلة الشائعة

هل أحتاج إلى مفتاح API لاستخدام إضافة المتصفح؟

لا. يمكن للإضافة دعم التسجيل وإعداد المسودات في صفحة Cliniko دون مفتاح. أما اتصال API فيدعم سير العمل المنفصل الخاص بجدول المواعيد والحفظ داخل Hanah.

أين أُنشئ مفتاح Cliniko؟

في Cliniko، افتحوا «My info» ثم «Manage API keys» ثم «Add an API key». والصقوا المفتاح الناتج في إعدادات الاتصال بـ Cliniko في Hanah.

لماذا قد أستخدم API والإضافة معًا؟

تُبقي الإضافة التسجيل وإعداد المسودات بجانب صفحة المريض. أما اتصال API فيجلب جدول المواعيد إلى Hanah ويدعم حفظ الملاحظات النهائية من هناك.