Guía de Integración con Speaknosis
Esta documentación te guiará a través de los pasos necesarios para integrar Speaknosis en tu sistema, permitiendo a los profesionales de la salud optimizar la gestión de sus consultas médicas mediante la automatización de la creación de informes.
Ofrecemos una solución inteligente para estructurar consultas médicas directamente desde tu sistema, que puede implementarse de dos maneras:
Para asegurar una integración fluida, hay algunos pasos preliminares que necesitas completar.
🌐 Registro de Dominio
Para garantizar una comunicación segura entre tu sistema y nuestra plataforma, es necesario registrar previamente la URL de tu sistema con nuestro equipo de soporte. Esto aplica tanto si integras mediante pop-up como con iframe.
💡 Importante: Ponte en contacto con nuestro equipo de soporte técnico y proporciona la URL desde la cual utilizarás la integración antes de comenzar cualquier implementación. Este es un paso fundamental para garantizar la seguridad y el correcto funcionamiento.
👥 Registro de Doctores
Antes de utilizar cualquiera de los métodos de integración, es fundamental que los doctores estén registrados en nuestro sistema. Esto puede hacerse de dos maneras:
- A través del Panel de administración, explicado en la sección Panel de administración.
- O mediante nuestra API, en la sección APIs / CRUD de doctores, donde podrás gestionar todo lo relacionado con la creación, consulta, edición y eliminación de doctores.
🔐 Autenticación
Independientemente del método de integración que elijas, primero deberás implementar un método de autenticación para obtener un token de acceso. Este token es indispensable para asegurar que solo usuarios autorizados puedan interactuar con Speaknosis.
📩 Endpoint para recepción de Informes Médicos
Debes disponer de un endpoint configurado en tu sistema, al cual podamos enviar los informes médicos una vez que sean aprobados por el profesional.
Este endpoint debe contar con un método de autenticación que valide las solicitudes entrantes para garantizar la seguridad de los datos.
Cuando el informe es aprobado, comienza un proceso que genera los códigos y catálogos definidos, junto con un archivo en formato JSON que contiene la estructura de respuesta necesaria para su uso dentro de su sistema.
Esta información será enviada automáticamente al endpoint previamente acordado y registrado durante la configuración de la integración.
El Flujo de Trabajo con Speaknosis
Una vez que tengas la integración funcionando, el proceso para los profesionales es sencillo y eficiente:
-
Grabar la consulta y seleccionar plantilla: Los profesionales podrán grabar consultas médicas en tiempo real. Antes de generar el informe, simplemente seleccionarán la plantilla adecuada que deseen utilizar.
📌 Si aún no has configurado tus plantillas, puedes hacerlo desde la sección APIs / Gestión de plantillas de reporte, donde encontrarás todos los endpoints necesarios para crear, editar, listar o eliminar plantillas médicas. Las plantillas pueden estar asociadas tanto al profesional como al centro médico, o bien solo al centro médico, dependiendo de la configuración deseada.
-
Generar el informe: Al presionar el botón “Generar informe”, el sistema iniciará el proceso de generación para producir un informe estructurado, claro y listo para su uso.
📌 Desde APIs / Informes médicos podrás consultar o incluso regenerar informes médicos previamente generados.
-
Revisar, editar y aprobar: Una vez generado el informe, el profesional podrá revisarlo y, si es necesario, editarlo manualmente para ajustar cualquier detalle. Finalmente, al presionar el botón “Aprobar”, toda la información clínica será enviada automáticamente a tu sistema, completando así el flujo de trabajo.