Skip to main content

​
Implementation and Configuration

​
How do I get an API key for SofIA?

Contact the Omniloy commercial team to obtain SDK access. You will receive credentials for both sandbox and production environments along with documentation for specific endpoints.

​
What’s the difference between sandbox and production?

  • Sandbox: Testing environment with simulated data, ideal for development and integration
  • Production: Real environment with full medical AI processing and usage-based billing

​
Can I use SofIA without audio functionality?

Yes, configure isonlychat=true to enable only clinical chat without audio transcription. Ideal for text-based queries or integrations with existing systems.

​
How do I migrate from sandbox to production?

  1. Update baseUrl and wssUrl to production endpoints
  2. Replace the apiKey with your production credentials
  3. Validate configuration with a test query
  4. Implement appropriate monitoring and logging

​
Data and Integration

​
Where is processed data stored?

SofIA does not persist clinical data. The generated report is delivered through the handleReport callback and it’s your application’s responsibility to store it in your EHR or management system.

​
How do I reduce the size of patientData?

  • Use urls_historial to reference external data instead of including the entire history
  • Include only information relevant to the current consultation
  • Segment data by specialty or time period

​
What format should JSON schemas have?

Schemas must follow JSON Schema Draft-07. Always include: 
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  // ... rest of schema
}

​
Clinical Coding

​
How does automatic coding work?

SofIA uses specialized agents that propose codes from medical terminologies (SNOMED CT, ICD-10, LOINC) based on clinical context and configured schemas.

​
Can I customize the terminologies used?

Yes, configure desired terminologies in your schemas using the reference field. Agents will adapt suggestions according to your specific configuration.

​
How do I validate the accuracy of generated codes?

  • Implement medical review for critical codes
  • Use integrated reviewer agents that verify coherence
  • Configure specific validations in your JSON schemas

​
Performance and Scalability

​
What are the usage limits?

  • Maximum payload: 100 KB for toolsArgs and patientData
  • Simultaneous sessions: According to your subscription plan
  • Rate limiting: Configured per API key according to contract

​
How do I optimize performance?

  • Use concise and specific JSON schemas
  • Implement caching for frequent terminologies
  • Configure appropriate timeouts for your network
  • Pre-load relevant data when possible

​
Technical Support

​
What browsers are compatible?

SofIA is compatible with modern browsers that support WebRTC and WebSockets:
  • Chrome 80+
  • Firefox 75+
  • Safari 13+
  • Edge 80+

​
Is there additional documentation available?

  • Framework-specific integration guides
  • Complete code examples on GitHub
  • Complementary REST API documentation
  • Training resources for development teams