Pular para o conteúdo
Iara Syncfusion Adapter

Perguntas Frequentes (FAQ)

Geral

O que é o Iara Syncfusion Adapter?

É uma biblioteca JavaScript/TypeScript que estende o Syncfusion DocumentEditor com funcionalidades de reconhecimento de voz e assistente de IA da Iara Health.

Preciso de uma licença do Syncfusion?

Sim, você precisa de uma licença válida do Syncfusion DocumentEditor. O Iara Adapter é um complemento que funciona sobre o Syncfusion.

Funciona com outras versões do Syncfusion?

O adapter é compatível com Syncfusion DocumentEditor versão 20.0.0 ou superior. Recomendamos usar a versão mais recente.

É gratuito?

O Iara Syncfusion Adapter requer credenciais da Iara Health. Entre em contato com contato@iarahealth.com para informações sobre planos e preços.

Instalação e Configuração

Qual engine devo usar?

Você DEVE usar engine: 'Iara Desktop' ao configurar o recognition para o Iara Syncfusion Adapter.

recognition.init({
  userId: 'meu@email.com',
  apiToken: 'seu-token',
  engine: 'Iara Desktop',  // ⚠️ OBRIGATÓRIO!
  lang: 'pt-BR'
});

Por quê?

  • Sem especificar a engine, o sistema usa ALS por padrão
  • A engine ALS não é compatível com o adapter
  • Isso causará falhas no reconhecimento de voz e comportamento inesperado

Como obtenho credenciais da Iara?

  1. Acesse portal.iarahealth.com
  2. Crie uma conta ou faça login
  3. Navegue até Configurações → API Keys
  4. Copie seu API Token e User ID

Posso usar em produção?

Sim! O adapter é estável e usado em produção por diversos clientes da Iara Health.

Funciona offline?

Não. O reconhecimento de voz e o assistente de IA requerem conexão com os servidores da Iara Health.

Quais navegadores são suportados?

  • ✅ Chrome
  • ✅ Edge
  • ✅ Firefox
  • ✅ Safari

Reconhecimento de Voz

Por que o microfone não funciona?

Verifique:

  1. Permissão do navegador - O navegador precisa de permissão para acessar o microfone
  2. HTTPS - O reconhecimento de voz só funciona em HTTPS (exceto localhost)
  3. Microfone conectado - Verifique se há um microfone funcionando

O reconhecimento está impreciso. Como melhorar?

  • Use um microfone de qualidade
  • Reduza ruído ambiente
  • Fale claramente e em ritmo normal
  • Habilite VAD (Voice Activity Detection): 
    recognition.init({
      useVAD: true
    });

Posso usar em português e espanhol?

Sim! Configure o idioma:

recognition.init({
  lang: 'pt-BR'  // ou 'es' para espanhol
});

Funciona em mobile?

O reconhecimento de voz funciona em navegadores mobile modernos, mas a experiência pode variar. Recomendamos testar em seu dispositivo específico.

Assistente de IA

Como ativo o assistente de IA?

const adapter = new IaraSyncfusionAdapter(
  editor,
  recognition,
  {
    assistant: {
      enabled: true
    }
  }
);

O assistente não aparece. O que fazer?

Verifique:

  1. assistant.enabled está true
  2. Componentes Iara estão carregados: 
    <script src="https://dev.components.iarahealth.com/components-lib.js" type="module"></script>
  3. Container existe no DOM (se usando draggable)

Posso customizar as sugestões da IA?

Sim! Use user_rules:

assistant: {
  enabled: true,
  user_rules: {
    report: ['Usar terminologia SNOMED CT'],
    impression: ['Ser conciso']
  }
}

As sugestões são salvas automaticamente?

Não. O usuário precisa revisar e aceitar as sugestões manualmente.

Performance

O editor está lento. Como otimizar?

  1. Desabilite funcionalidades não usadas:

    {
      assistant: { enabled: false },  // Se não usar IA
      highlightInference: false
    }

  2. Limite histórico de undo:

    editor.documentEditor.editorHistory.undoLimit = 50;

  3. Destrua o adapter quando não precisar:

    adapter.destroy();

Integração

Funciona com React?

Sim! O adapter é framework-agnostic e funciona perfeitamente com React.

Funciona com Vue?

Sim! O adapter é framework-agnostic. Basta criar a instância após o editor estar montado.

Funciona com Angular?

Sim! Siga o mesmo padrão de integração do React/Vue.

Posso usar com TinyMCE?

O Iara Syncfusion Adapter é específico para Syncfusion DocumentEditor. Para TinyMCE, entre em contato com a Iara Health.

Salvamento e Exportação

Como salvo o conteúdo?

Use o Content Manager:

const html = await adapter.contentManager.reader.getHtmlContent();
// Salvar no backend

Quais formatos de exportação são suportados?

  • HTML
  • Texto plano
  • RTF
  • SFDT (Syncfusion Document Format)

Como implemento auto-save?

{
  saveReport: true
}


adapter.onSaveReport = function(content) {
  // Salvar no backend
  saveToBackend(content);
};

Segurança

As credenciais são seguras?

Use variáveis de ambiente e nunca exponha credenciais no código frontend público. Idealmente, implemente autenticação backend.

Os dados são criptografados?

Sim. Toda comunicação com os servidores da Iara Health usa HTTPS/TLS.

Onde os dados são armazenados?

Os dados são processados nos servidores da Iara Health (região configurável: América do Sul ou Europa) e não são armazenados permanentemente sem seu consentimento.

Suporte

Onde encontro mais ajuda?

Como reporto um bug?

Entre em contato com contato@iarahealth.com incluindo:

  • Versão do adapter
  • Versão do Syncfusion
  • Navegador e versão
  • Passos para reproduzir
  • Mensagens de erro (se houver)

Há um roadmap público?

Entre em contato com a equipe Iara Health para informações sobre recursos futuros.