Saltar al contenido principal
Sofia SDK es un componente web que proporciona capacidades de IA médica a través de una interfaz conversacional intuitiva. Esta guía le ayudará a integrar Sofia SDK en su aplicación web en pocos minutos.

​
Antes de empezar

​
Requisitos técnicos

  • Aplicación web que soporte web components o JavaScript moderno
  • Conexión HTTPS (TLS requerido para funcionalidades de audio)
  • Credenciales de API de Omniloy

​
Obtener credenciales

Contacte a support@omniloy.com para obtener:
  • API Key: Clave de autenticación
  • Base URL: Endpoint de la API
  • WebSocket URL: URL para conexiones en tiempo real

​
Instalación

​
Opción 1: NPM/Yarn (Recomendado)

npm install @omniloy/sofia-sdk

// En su archivo principal (main.js, app.js, etc.)
import '@omniloy/sofia-sdk';

​
Opción 2: CDN

<script src="https://unpkg.com/@omniloy/sofia-sdk@latest/dist/webcomponents.umd.js"></script>

​
Opción 3: Build manual

Si ya tiene el paquete instalado via npm, incluya el script en su proceso de build: 
<script src="/dist/webcomponents.umd.js"></script>

​
Configuración básica

​
1. Integrar el componente

<sofia-sdk
  baseurl="https://api.example.com/v1"
  wssurl="wss://ws.example.com"
  apikey="sk-your-api-key-here"
  userid="user_12345"
  patientid="patient_67890"
  isopen="true"
  toolsargs='{
    "$schema": "http://json-schema.org/draft-07/schema#",
    "title": "clinical_notes",
    "type": "object",
    "required": ["diagnosis"],
    "properties": {
      "diagnosis": {"type": "string", "description": "Diagnóstico médico"}
    }
  }'
></sofia-sdk>

​
2. Configurar callbacks

const sofiaComponent = document.querySelector('sofia-sdk');

// Manejar reportes generados
sofiaComponent.handleReport = (report) => {
  console.log('Reporte médico generado:', report);
  // Integrar con su sistema de registros médicos
  saveToEHR(report);
};

// Controlar visibilidad del componente
sofiaComponent.setIsOpen = (isOpen) => {
  console.log('Estado del componente:', isOpen ? 'Abierto' : 'Cerrado');
};

​
Verificar la integración

  1. Cargar la página: Sofia SDK debería aparecer como un botón flotante
  2. Abrir el componente: Click para expandir la interfaz
  3. Probar funcionalidad: Use el micrófono para interactuar
  4. Verificar callbacks: Confirme que los reportes se reciben correctamente

​
Próximos pasos

​
Soporte

¿Necesita ayuda? Contacte nuestro equipo: