Preguntas frecuentes

Preguntas comunes sobre configuración del SDK de SofIA, manejo de datos, codificación clínica y soporte técnico

​

Implementación y configuración

¿Cómo obtengo una API key para SofIA?

Envía un email a [e-mail] con tu nombre de empresa, descripción del proyecto y uso esperado. El equipo de Omniloy te proporcionará tu apikey. Para las claves más nuevas el SDK selecciona el endpoint automáticamente; otras claves también incluyen un baseurl — Omniloy te indica cuál aplica a la tuya. El tiempo de respuesta habitual es de 1-2 días laborables. Consulta el Quickstart para más detalles.

¿Cuál es la diferencia entre sandbox y producción?

• Sandbox: Entorno de pruebas con datos simulados, ideal para desarrollo e integración. Sin facturación por uso. Las respuestas de IA pueden usar datos de ejemplo.
• Producción: Entorno real con procesamiento completo de IA médica y facturación por uso. Requiere certificado SSL válido y API key de producción.

El único cambio de código necesario es sustituir tu apikey — Omniloy te da una clave distinta para cada entorno. Si tu clave requiere baseurl, sustitúyelo también. Consulta ¿Cómo migro de sandbox a producción? más abajo.

¿Puedo usar SofIA sin generación de reportes?

Sí, simplemente omita las propiedades template y templateid. SofIA operará automáticamente en modo solo chat sin el botón de generar. Ideal para consultas por texto o integraciones con sistemas existentes.

¿Cómo migro de sandbox a producción?

1. Reemplaza la apikey con tus credenciales de producción — Omniloy emite una clave distinta por entorno
2. Si tu clave requiere baseurl, actualízalo al endpoint de producción
3. Valide la configuración con una consulta de prueba
4. Implemente monitorización y logging apropiados

​

Datos e integración

¿Dónde se almacenan los datos procesados?

SofIA no persiste datos clínicos. El reporte generado se entrega a través del callback handleReport y es responsabilidad de su aplicación almacenarlo en su EHR o sistema de gestión.

Mi sistema cierra la sesión del médico por inactividad mientras graba. ¿Cómo lo evito?

Mientras el médico graba no hay actividad de ratón ni teclado, así que un cierre por inactividad lo desloguea a mitad de consulta. Suscríbete al flujo de eventos del SDK y usa recording.heartbeat como ping de actividad: late con el primer paquete de audio y cada ~30 s mientras siga fluyendo audio al transcriptor, y deja de latir en cuanto la grabación se rompe por cualquier causa, así tu propio timeout sigue protegiéndote.

sofia.eventSubscriptions = ['recording.*', 'activity.*', 'report.*'];
sofia.onEvent = (event) => {
  if (event.name === 'recording.heartbeat' || event.family === 'activity') {
    session.keepAlive();
  }
  // La generación tarda decenas de segundos sin que el médico toque nada:
  // suspende el cierre mientras dura y reanúdalo al terminar.
  if (event.name === 'report.generation_started') session.pauseIdleLogout();
  if (event.name === 'report.settled') session.resumeIdleLogout();
};

Los dos eventos de informe van siempre en pareja, así que el cierre nunca queda suspendido indefinidamente. Los eventos no llevan ningún dato clínico. Ver Eventos de actividad.

¿Cómo reduzco el tamaño de patientData?

• Incluye campos url en las entradas de patient_medical_notes para referenciar registros externos en lugar de incluir todo el historial (ver Datos del paciente)
• Incluya únicamente información relevante para la consulta actual
• Segmente datos por especialidad o periodo temporal

¿Qué formato deben tener los esquemas JSON?

Los esquemas deben seguir JSON Schema Draft-07. Incluya siempre:

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "diagnosis": { "type": "string" }
  },
  "required": ["diagnosis"]
}

​

Codificación clínica

¿Cómo funciona la codificación automática?

La codificación clínica automática (CIE-10, SNOMED CT, LOINC) está disponible a través de la SofIA API (Codify). En el SDK, puedes habilitar referencias de codificación en tu esquema de template usando la propiedad source — consulta Esquemas de datos clínicos para más detalles.

¿Puedo personalizar las terminologías utilizadas?

Sí. En el SDK, puedes solicitar una terminología directamente en la description de un campo (p. ej. “con su código CIE-10”), o codificar contra un master personalizado estableciendo el source del campo. Los masters se provisionan por cuenta — contacta a [e-mail] para que creen tu master personalizado y te proporcionen su valor de source. Consulta Esquemas de datos clínicos para más detalles. En la API, pasa la terminología deseada en el payload de tu petición — consulta la visión general de la API.

¿Cómo valido la precisión de los códigos generados?

• Implementa siempre revisión médica para códigos críticos — los códigos generados por IA deben ser verificados por un clínico antes de su envío
• Configura campos "required" en tu JSON Schema para asegurar que los códigos clave estén siempre presentes
• Usa el callback handleReport para ejecutar lógica de validación personalizada antes de persistir en tu EHR
• Habilita debug="true" durante el desarrollo para inspeccionar el payload completo del reporte

​

Rendimiento y escalabilidad

¿Cuáles son los límites de uso?

• Payload máximo: 100 KB para template y 100 KB para patientdata
• Sesiones simultáneas: Depende de tu plan de suscripción — contacta [e-mail] para más detalles
• Rate limiting: Configurado por API key según tu contrato. Si recibes respuestas HTTP 429, has excedido tu límite de peticiones

¿Cómo optimizo el rendimiento?

• Use esquemas JSON concisos y específicos
• Reduzca el tamaño de template y patientdata para minimizar el tiempo de procesamiento
• Use debug="true" para identificar cuellos de botella en la consola del navegador
• Pre-cargue datos relevantes cuando sea posible

​

Soporte técnico

¿Qué navegadores son compatibles?

SofIA es compatible con navegadores modernos que soporten WebRTC y WebSockets:

• Chrome 80+
• Firefox 75+
• Safari 13+
• Edge 80+

¿Hay documentación adicional disponible?

• Guías de integración específicas por framework (Vanilla JS, React, Angular)
• Ejemplos de código completos en GitHub: sofia-sdk-examples
• Documentación de API REST complementaria: SofIA API