🎉 40% de descuento en tu licencia el primer año · Solo hasta el 30 de septiembre 40% dcto hasta el 30 de septiembre Ver promo →

¿Cómo Conectar sus Propias Herramientas con Medifolios?

Hay dos caminos y son complementarios: la <strong>API REST</strong> para cuando su sistema necesita preguntar o registrar algo, y los <strong>webhooks</strong> para cuando Medifolios tiene que avisarle en el instante en que pasa. Ambos vienen con la licencia, sin costo adicional.

API REST Con Swagger
Webhooks Aviso inmediato
Incluido Con su licencia

¿Por Qué Necesita un Ecosistema de Integraciones?

  • Su turnero o pantalla de sala de espera no sabe cuándo se llamó al paciente
  • Un tablero propio consulta la API cada pocos minutos solo para ver si algo cambió
  • Los datos se digitan dos veces: una en Medifolios y otra en el sistema de la entidad
  • La página web o la app institucional funcionan aisladas de la operación real
  • El equipo de desarrollo no tiene documentación para saber qué puede consumir
  • Cuando un aviso falla, nadie se entera ni queda registro de lo que pasó
  • Cada integración nueva se resuelve con un desarrollo a la medida

¿Qué le Ofrece el Ecosistema de Integraciones?

  • Dos direcciones, no una: su sistema pregunta por la API, y Medifolios le avisa por webhook
  • Aviso en el instante: el webhook sale en el momento en que ocurre el evento, sin consultar
  • API REST con Swagger: documentación navegable y autenticación por token
  • Usted decide qué le llega: filtros por sede, punto de atención y profesional
  • Usted decide qué viaja: el contenido del mensaje lo define la entidad
  • Vea antes de activar: vista previa del mensaje armado con sus datos reales, sin enviarlo
  • Nada se pierde en silencio: cola con reintentos y bitácora consultable de cada intento
  • Incluido con la licencia: no es un módulo aparte ni tiene costo adicional

¿Qué Incluye el Ecosistema de Integraciones?

Las dos vías de conexión y lo que trae cada una

1. Webhooks: Medifolios le Avisa NUEVO

¿Su sistema pregunta cada cierto tiempo si algo cambió? Registre una dirección https propia y reciba el aviso en el instante en que ocurre el evento, sin consultar.

  • Aviso al llamar un paciente a consultorio
  • Aviso al crear una cita
  • Aviso al crear una admisión
  • Varios destinos, cada uno con su propia dirección y su propio alcance
  • Alimenta turneros, pantallas de sala de espera y tableros externos

2. API REST: su Sistema Pregunta

Consulte y registre información desde sus propios sistemas, con documentación Swagger navegable y autenticación por token.

  • Documentación Swagger para el equipo de desarrollo
  • Autenticación por token, sin credenciales embebidas en el cliente
  • Consulta y registro según el módulo que se integre
  • El alcance disponible por módulo se confirma con el equipo de soporte
  • Sin costo adicional: viene con la licencia

3. Alcance: Solo lo que le Interesa

Un turnero de una sede no necesita los llamados de las otras. Cada destino se limita por sede, punto de atención y profesional.

  • Filtros por sede, punto de atención y profesional
  • Varias condiciones se cumplen en conjunto
  • Sin filtros, el destino recibe todos los eventos de ese tipo
  • El contenido del mensaje lo define la entidad, campo por campo
  • Evita enviar datos del paciente que el destino no necesita

4. Vista Previa Antes de Activar

Un filtro mal puesto deja el destino mudo sin ningún síntoma. La vista previa arma el mensaje con sus últimos registros reales y no envía nada.

  • Arma el mensaje exacto que se enviaría
  • Usa registros reales de su licencia, no ejemplos
  • Indica cuántos registros cumplen los filtros configurados
  • Avisa si, así configurado, el destino no recibiría nada
  • No envía ninguna notificación durante la prueba

5. Cola con Reintentos y Bitácora

El aviso se registra antes de intentar enviarlo, así que un corte no hace desaparecer el evento. Lo que falla se reintenta solo.

  • El evento se registra antes del envío: no se pierde
  • Reintentos automáticos con espera creciente
  • Cada intento queda con su código de respuesta y su duración
  • Reenvío manual desde la pantalla cuando hace falta
  • Retención de la bitácora configurable por la entidad

6. Seguridad y Trazabilidad

Los avisos salen solo hacia direcciones https públicas, y todo cambio de configuración queda registrado con su autor.

  • Solo direcciones https públicas como destino
  • Se rechazan direcciones internas y rangos privados
  • Token de autenticación propio por cada destino
  • Cada cambio de configuración queda en la bitácora del sistema
  • Se activa por decisión de la entidad: viene desactivado

Preguntas Frecuentes

¿Cuál es la diferencia entre la API y los webhooks?

La dirección. Con la API su sistema pregunta a Medifolios cuando necesita algo. Con los webhooks es Medifolios el que avisa a su sistema en el momento en que ocurre el evento, sin que nadie pregunte. Para un turnero o una pantalla de sala de espera el webhook es el camino correcto, porque no tiene que estar consultando cada pocos segundos.

¿Tiene costo adicional?

No. Tanto la API como los webhooks son propiedades del sistema y vienen con la licencia. Lo que sí puede tener costo es el desarrollo del lado de su entidad, que corre por cuenta de su equipo o de su proveedor tecnológico.

¿Qué eventos puede notificar hoy un webhook?

Tres: cuando se llama a un paciente a consultorio, cuando se crea una cita y cuando se crea una admisión. El cargue masivo histórico de admisiones no emite aviso, porque no corresponde a una atención del día.

¿Qué pasa si mi sistema está caído cuando ocurre el evento?

El aviso queda registrado antes de intentar enviarse, así que el evento no se pierde. Se reintenta de forma automática con una espera que crece entre intentos, y cada intento queda en la bitácora con el código de respuesta. Si se agotan los reintentos, el aviso queda marcado como fallido y se puede reenviar a mano desde la pantalla.

¿Necesito conocimientos de programación?

Para configurar un webhook, no: se registra la dirección, se eligen los filtros y se revisa la vista previa desde la pantalla de parámetros. Para recibir el aviso y hacer algo con él, sí: su equipo de desarrollo o su proveedor debe preparar el punto que lo recibe. La documentación necesaria se solicita por el Centro de Soluciones.

¿Puedo limitar la información del paciente que viaja en el aviso?

Sí, y conviene hacerlo. El contenido del mensaje lo define la entidad campo por campo: una pantalla de sala de espera que solo muestra el nombre no necesita recibir el documento, el teléfono ni el correo del paciente. Si no se define el contenido, viaja el mensaje completo.

¿Cómo se activa?

Viene desactivado. Se habilita desde la configuración de su licencia cuando la entidad ya tiene listo el sistema que va a recibir los avisos, y el Centro de Soluciones acompaña la puesta en marcha.

¿Listo para Conectar sus Herramientas con Medifolios?

La API y los webhooks vienen con su licencia. Solicite la documentación y acompañamos a su equipo en la integración.