Si tu clínica usa otro sistema —una historia clínica, un software de gestión, un laboratorio, una farmacia, la app de una obra social— la API le permite a ese sistema leer y escribir en tu agenda como si fuera parte del equipo: ver horarios libres, reservar turnos, consultar fichas de contacto, emitir recetas. Y los webhooks hacen el camino inverso: cada vez que pasa algo en tu agenda, le avisamos a ese sistema al instante.
1. ¿Cuándo te conviene?
- Tenés un sistema propio y querés que los turnos que entran por WhatsApp, por el micrositio o por el panel aparezcan ahí solos, sin cargarlos dos veces.
- Un tercero necesita reservar por vos: un call center, un laboratorio que agenda extracciones, una obra social que deriva pacientes.
- Una farmacia registra la dispensa de tus recetas electrónicas en su propio sistema.
Si no tenés ninguno de esos casos, no necesitás crear nada: la API está apagada hasta que creás la primera clave, y no cambia nada de lo que ya usás.
2. Qué es una clave y qué autoriza
Una clave es una contraseña larga que le das al sistema que se va a conectar (no a una persona). Al crearla elegís exactamente qué puede hacer:
- Sólo mirar: ver profesionales, prestaciones, horarios libres, turnos.
- Reservar y cambiar turnos: crear, confirmar, reprogramar, cancelar.
- Fichas de pacientes: sólo contacto y cobertura. Nunca la historia clínica, ni las notas, ni los formularios: eso no sale por la API, con ninguna clave.
- Recetas: emitir, leer, anular, o —para una farmacia— registrar la dispensa.
3. Crear una clave, paso a paso
- 1
Andá a ConfiguraciónIntegracionesAPI y webhooks
- 2
Tocá «Nueva clave» y ponele el nombre del sistema
Por ejemplo «Sistema de la clínica» o «Laboratorio Norte». Después vas a querer saber cuál es cuál. - 3
Elegí qué puede hacer
Lo mínimo. Se puede ampliar después sin cambiar la clave. - 4
Copiá la clave y pasásela al sistema
Se muestra UNA sola vez. Si se pierde, se revoca y se crea otra: no hay forma de volver a verla, ni la tenemos nosotros. - 5
Probala
El sistema del otro lado puede pedir «quién soy» (/v1/me) para confirmar que la clave anda. Si configuraste un webhook, quien programa puede pedir un aviso de prueba («ping») con la misma clave, y vos ves en la tarjeta de la clave si llegó y qué contestó.
4. Webhooks: nosotros les avisamos
Si el sistema del otro lado quiere enterarse de lo que pasa en tu agenda sin preguntar todo el tiempo, quien lo programa te va a pedir que cargues una URL y un secreto en la clave. Con eso, cada turno nuevo, cancelación, reprogramación, ficha nueva o receta emitida le llega al instante, firmado con ese secreto para que pueda comprobar que somos nosotros.
Qué viaja en un aviso
Pasa algo en tu agenda
turno, ficha, receta
Le avisamos al sistema
ids y estado, nada clínico
Si no contesta, reintentamos
seis veces en ~14 horas
Ves cada intento en el panel
y podés reenviar uno
Los avisos son flacos: llevan el id del turno y su estado, no los datos del paciente. Si el sistema necesita más, lo pide por la API con la misma clave, con los permisos que le diste.
5. Claves de prueba
Una clave marcada como prueba opera sobre tu misma agenda, pero no le manda ningún mensaje al paciente por lo que crea, y deja marcado lo que hizo para poder borrarlo después. Sirve para que el integrador pruebe sin molestar a nadie. Igual, probá contra un consultorio de prueba y no contra uno con pacientes reales.
6. Cortar el acceso
Revocar una clave es instantáneo: desde ese momento el sistema que la usaba no puede leer ni escribir nada, y no recibe más avisos. No hay que avisarle a nadie ni esperar. Si cambiás de proveedor, revocá la clave vieja el mismo día que le das la nueva al nuevo.
Si tu cuenta queda suspendida, todas las claves dejan de funcionar solas y los avisos dejan de salir, hasta que se reactive.
7. Lo que la API no hace, para que sepas qué estás autorizando
- No expone historia clínica, notas, formularios ni resúmenes, con ninguna clave.
- No configura nada del consultorio: horarios, profesionales, precios, plan e integraciones se cambian sólo desde el panel, con tu sesión.
- No manda mensajes de texto libre a pacientes: los avisos salen por tus plantillas y canales de siempre.
- No hace sobreturnos ni turnos en el pasado: eso queda para una persona en el panel.
- Cada uso queda registrado, y cada intento rechazado también: si alguien prueba una clave que no existe, lo vemos.