Cómo configurar tu clave de API de Cliniko

Puntos clave

• Crea una clave en Cliniko en My info → Manage API keys y pégala en los ajustes de la conexión con Cliniko de Hanah.
• La conexión por API trae tu agenda de Cliniko a Hanah y permite archivar las notas terminadas en la ficha.
• La extensión del navegador añade la grabación y la redacción de borradores en las páginas de Cliniko y se puede usar sin clave API.
• La conexión por API y la extensión del navegador cubren partes distintas del flujo de trabajo; prueba la combinación que necesites.

Hanah es un escriba con IA creado para Cliniko y una app conectada oficial de Cliniko. Hay dos formas de combinar Hanah y Cliniko, y se complementan.

• La clave API: se pega una sola vez y permite a Hanah leer tus citas y archivar las notas terminadas en la ficha correcta.
• La integración en el navegador: una extensión que pone Hanah en las páginas de Cliniko que ya tienes abiertas, para que grabes y redactes el borrador sin salir del paciente que estás atendiendo. No requiere clave.

Este artículo explica primero la clave, porque es la que tiene un paso de copiar y pegar. Después añadiremos la extensión y veremos cómo funciona dentro de Cliniko. Si prefieres verlo a leerlo, el recorrido de abajo lo muestra todo de principio a fin.

Paso 1: crea la clave en Cliniko

En Cliniko, abre My info (Mi información) desde la parte inferior del menú de la izquierda, baja hasta API keys (claves API) y elige Manage API keys → Add an API key. O ve directamente: https://your-practice.cliniko.com/user/api-keys/new.

Ponle un nombre que reconozcas más adelante. "Hanah" sirve.

Pulsa Create API key. Cliniko te muestra la clave una sola vez: cópiala ahora, pégala en Hanah en el siguiente paso y no tendrás que guardar una copia en ningún otro sitio. Si la pierdes, no pasa nada: archiva esa clave y crea otra.

Dos cosas que conviene saber antes de crearla. Una clave tiene el mismo acceso a los datos de Cliniko que tienes tú, así que las claves son personales, no de la clínica: cada profesional crea la suya desde su propio inicio de sesión. Y como la nombraste para una sola aplicación, puedes archivarla más adelante sin afectar a nada más que tengas conectado.

Paso 2: pégala en Hanah

En Hanah, abre Integrations (integraciones) desde el menú de la izquierda. Verás dos secciones: la integración en el navegador (el paso 3) y la integración por API.

Haz clic en la tarjeta de Cliniko en API integration y pega la clave en el campo API key. Hanah la comprueba con Cliniko mientras escribes y te muestra el profesional al que pertenece la clave, para que sepas que ha ido a la cuenta correcta antes de guardar nada.

El segundo campo, Cliniko URL, no forma parte de la clave: pega cualquier dirección de tu cuenta de Cliniko (https://your-practice.au5.cliniko.com) y Hanah la usa para dirigir a los pacientes a tu página de reservas. La API de Cliniko no facilita esa dirección, y por eso la pedimos.

Guarda, y la tarjeta mostrará Connected (conectado). Esa es toda la configuración.

Qué hace realmente la conexión

• Tu agenda se traslada. Las citas y los pacientes aparecen en Hanah, así que empiezas una sesión con la persona correcta sin volver a escribir un nombre.
• Las notas vuelven a la ficha correcta. Una nota terminada se asocia al paciente y a la cita de Cliniko de los que procede.
• Nada se archiva solo. Cada nota es un borrador hasta que un profesional la revisa y la da por buena.

En cuanto a la seguridad: la clave se guarda en el servidor y nunca se envía a tu navegador. Está limitada al profesional que la emitió, así que las notas se atribuyen al profesional correcto. Y puedes revocarla desde Cliniko en cualquier momento archivando esa clave: deja de funcionar de inmediato y no afecta a nada más que tengas conectado.

Paso 3: compruébalo dentro de Cliniko

La clave API conecta los dos sistemas. La integración en el navegador es lo que pone Hanah delante de ti mientras trabajas.

Añádela desde la misma página de Integrations: la tarjeta de Cliniko en Browser integration abre la extensión de Hanah en la Chrome Web Store. Instálala, inicia sesión en Hanah una vez y abre cualquier paciente en Cliniko.

Aparecen dos cosas, ambas en las propias páginas de Cliniko:

• Un botón Visit (consulta), abajo a la derecha. Graba la consulta desde la página del paciente en la que ya estás. La transcripción se va formando en un pequeño panel que puedes mirar o ignorar.
• Una píldora de borrador en el formulario de la nota. Abre una nueva nota de tratamiento y Hanah aparece junto al selector de plantillas de Cliniko. Elige la consulta, genera, revisa el borrador y rellenará las secciones de la propia nota: las que define tu plantilla, no un bloque de texto genérico.

La extensión funciona en tu navegador, en la página que ya tienes abierta y que ya tienes permiso para ver. No necesita clave API ni toca los servidores de Cliniko, y por eso funciona incluso antes de hacer los pasos 1 y 2, y también en programas de gestión clínica que no ofrecen ninguna API.

¿Cuál necesitas?

La mayoría de las clínicas quieren las dos, y hacen trabajos distintos:

Si solo trabajas dentro de Cliniko, la extensión por sí sola te parecerá completa. Si también quieres la agenda del día en Hanah, y archivar las notas desde ahí, añade la clave.

¿Te has atascado en algún paso, o usas un sistema que aún no aparece aquí? Reserva una demo y lo configuramos contigo.

Preguntas frecuentes

¿Necesito una clave API para usar la extensión del navegador?

No. La extensión permite grabar y redactar el borrador en la página de Cliniko sin clave. La conexión por API se encarga del flujo aparte de agenda y archivo dentro de Hanah.

¿Dónde creo la clave de Cliniko?

En Cliniko, abre My info, luego Manage API keys y Add an API key. Pega la clave resultante en los ajustes de la conexión con Cliniko en Hanah.

¿Por qué usaría tanto la API como la extensión?

La extensión mantiene la grabación y la redacción del borrador junto a la página del paciente. La conexión por API trae la agenda a Hanah y permite archivar las notas terminadas desde ahí.