API e integraciones: conectar el sistema de tu clínica con la agenda
Con la API de Odontosys, otro sistema de tu clínica —tu sitio de reservas, tu central de citas, un asistente de inteligencia artificial— puede mirar tus agendas, ver los horarios libres y agendar o eliminar citas sin que nadie pase por la pantalla. Para eso, desde la App Web creás una clave de integración y se la das a tu programador, que la usa para conectar su sistema.
La API está en piloto y sin costo, y se activa clínica por clínica. Si te interesa, escribinos por WhatsApp al +598 97 100 888 y la activamos. Mientras tu clínica no la tenga, la pantalla te explica qué es y cómo pedirla.
Dónde está
En Configuración > Avanzado > API e integraciones. Solo entra el usuario administrador de la clínica: cada clave es un acceso a la agenda, así que al resto del personal, Avanzado le muestra el aviso “Solo el administrador puede acceder a esta sección.”
Si ya te activaron la API y seguís viendo la pantalla que explica qué es, cerrá sesión y volvé a entrar.
Crear una clave
- En API e integraciones, hacé clic en Nueva clave.
- Poné un Nombre que te diga para qué es (por ejemplo, “Sitio de reservas”). Con ese nombre la vas a reconocer en la lista y en el Historial de actividad.
- En Qué puede hacer, tildá solo lo que la integración necesita:
- Ver las agendas y sus horarios libres.
- Crear citas, y ver y eliminar las que creó. La integración solo puede eliminar las citas que agendó ella, y solo si todavía no pasaron ni tienen la asistencia marcada.
- Buscar pacientes por celular, correo o número de ficha: devuelve únicamente el nombre del paciente, nunca el resto de su ficha.
- Ver todas las citas de la agenda, con los nombres de los pacientes y las notas. Es el que más datos expone: activalo solo si la integración de verdad lo necesita.
- En En qué agendas, dejá Todas las agendas de la clínica o elegí Sólo estas agendas y marcá cuáles. Para la integración, las agendas que no marques no existen.
- Leé las condiciones de uso (con Ver las condiciones) y tildá la casilla para aceptarlas.
- Hacé clic en Continuar, escribí tu contraseña (la misma con la que entrás a Odontosys) y hacé clic en Crear la clave.
Los permisos y las agendas no se cambian después: si hace falta otra cosa, se revoca la clave y se crea una nueva.
Guardá la clave: se muestra una sola vez
Al crearla, la clave aparece completa una única vez. Copiala con Copiar la clave y dásela a tu programador junto con la dirección de la API que figura ahí mismo. Odontosys no la guarda: si se pierde, no hay forma de volver a verla, pero se soluciona en un minuto revocándola y creando otra.
Qué implica darle la clave a alguien
- Es un acceso a tu agenda. Quien la tenga puede hacer todo lo que le permitiste, en las agendas que elegiste. Dásela solo a quien va a hacer la integración.
- Se usa desde el servidor de tu proveedor, nunca pegada en una página web ni en una app que se instale en el celular de un paciente: ahí cualquiera podría leerla.
- Una clave por sistema: si conectás dos sistemas distintos, creá una clave para cada uno. Así podés cortarle el acceso a uno sin tocar al otro.
Revocar una clave
En la lista, hacé clic en Revocar en la clave y confirmá. El sistema que la esté usando deja de funcionar en menos de un minuto, y no se puede deshacer. Hacelo siempre que dejes de trabajar con ese proveedor o sospeches que la clave se filtró.
Las claves revocadas quedan al final de la lista, atenuadas, con la fecha y quién las revocó. De cada clave ves además con qué empieza (para reconocerla), sus permisos, sus agendas, quién la creó y cuándo se usó por última vez.
Cómo se ven en la agenda las citas de la integración
Son citas como cualquier otra, y la integración elige a quién agenda:
- Un paciente con ficha: la cita queda a su nombre y recibe los recordatorios de siempre, como si la hubieran agendado en el mostrador.
- Alguien sin ficha: la cita lleva el nombre que mandó el sistema y el teléfono en la nota. No recibe recordatorios; si querés, después la vinculás con la ficha a mano.
En el Historial de actividad, lo que hace la integración figura con el usuario API · seguido del nombre de la clave, así sabés qué sistema creó o eliminó cada cita.