# 3. Solucionando Problemas da Ema.IA

Este artigo reúne os principais problemas que podem ocorrer com a Ema.IA e as etapas que podem solucioná-los. Os erros que aparecem aqui são principalmente aqueles que são externos e não podem ser corrigidos com uma atualização do aplicativo. O artigo é um trabalho em progresso e ainda não está tão completo quanto pode se tornar, portando sua sugestão será bem-vinda.

<p class="callout warning"><span style="white-space: pre-wrap;">Diversos clientes utilizam as soluções da Ema através de </span>**RemoteApp** (WTS/RDP). Infelizmente, a experiência de uso da Ema.IA por meio deste método é negativamente impactada pelas limitações inerentes à tecnologia, o que foge do nosso alcance. Recomendamos a utilização de outros métodos de acesso para usuários que desejam usar a Ema.IA.</p>

---

### <span style="color: rgb(0, 0, 0);">A Ema.IA não está abrindo</span>

<span style="white-space: pre-wrap;">O que pode estar acontecendo: </span>

- Falhas na comunicação com o ERP ou outro produto Ema
- Falha na comunicação com o servidor da Ema.IA (Cloud)
- Falha no processo de autenticação do usuário

Possíveis soluções:

##### - Verifique se o servidor da Ema.IA está acessível na rede

<span style="white-space: pre-wrap;">Você pode efetuar a verificação abrindo o link </span>[https://ema.ia.br/api/v1/](https://ema.ia.br/api/v1/)<span style="white-space: pre-wrap;"> no navegador, se tudo estiver correto, irá aparecer o conteúdo abaixo:</span>

```json
{"status":"Running"}
```

<span style="white-space: pre-wrap;"> Caso prefira, é possível verificar também executando o comando abaixo no PowerShell:</span>

```powershell
(Invoke-WebRequest https://ema.ia.br/api/v1/).StatusDescription
```

<span style="white-space: pre-wrap;">Se a resposta que aparecer embaixo for diferente de </span>`<span class="editor-theme-code">OK</span>`, existe algo impedindo a conexão com o servidor.

Se a verificação executada falhar, recomendamos tentar acessar o link ([https://ema.ia.br/api/v1/](https://ema.ia.br/api/v1/)) a partir de um dispositivo conectado a uma rede diferente (como por exemplo os Dados Móveis do celular). Isso irá ajudar a determinar se o problema está sendo causado por uma instabilidade no servidor da Ema.IA ou se há algum bloqueio na rede (**Firewall**<span style="white-space: pre-wrap;">) impedindo o acesso, neste caso será necessário solicitar o desbloqueio do domínio </span>`<span class="editor-theme-code">ema.ia.br</span>`<span style="white-space: pre-wrap;"> ao responsável pelo gerenciamento da rede.</span>

##### - Encerre a Ema.IA e limpe os dados do app

Copie o comando abaixo, abra a janela Executar do Windows (Win + R), cole o conteúdo no campo com Ctrl + V, e pressione Enter. O comando irá encerrar os processos da Ema.IA e limpar os dados do app.

```powershell
cmd /c taskkill /f /im "Ema IA.exe" & rmdir /s /q "%appdata%\Ema IA"
```

[![image.png](https://kb.emasistemas.com.br/uploads/images/gallery/2026-04/scaled-1680-/Y1QXgndsxlwNgAdb-image.png)](https://kb.emasistemas.com.br/uploads/images/gallery/2026-04/Y1QXgndsxlwNgAdb-image.png)

Agora feche o programa que você utilizou para abrir a Ema.IA (Ema ERP, Ema DOX, etc...), em seguida abra novamente e tente abrir a Ema.IA. Isso deve resolver a maior parte dos casos onde não é possível abrir o app. Caso não resolva, será necessário acionar o suporte técnico.

---

### O botão de microfone não está funcionando

[![image.png](https://kb.emasistemas.com.br/uploads/images/gallery/2026-04/scaled-1680-/O91iYAGEcTNAuxLO-image.png)](https://kb.emasistemas.com.br/uploads/images/gallery/2026-04/O91iYAGEcTNAuxLO-image.png)

[![image.png](https://kb.emasistemas.com.br/uploads/images/gallery/2026-04/scaled-1680-/kGKg1P1yOUNIDyP2-image.png)](https://kb.emasistemas.com.br/uploads/images/gallery/2026-04/kGKg1P1yOUNIDyP2-image.png)

<span style="white-space: pre-wrap;">Isso costuma ocorrer principalmente quando a Ema.IA está sendo utilizada em uma máquina remota, através de Remote Desktop (RDP/WTS). Neste caso, de acordo com a figura ao lado, clique em "Mais opções" na janela da ferramenta de conexão remota, navegue até a aba "Recursos locais" e clique no botão "Configurações" na seção "Áudio remoto". </span>

Certifique-se de que as duas opções no topo de cada seção estão selecionadas, como indicado pelas setas na captura de tela abaixo:

[![image.png](https://kb.emasistemas.com.br/uploads/images/gallery/2026-04/scaled-1680-/f5YqdmtLV7pLnFIM-image.png)](https://kb.emasistemas.com.br/uploads/images/gallery/2026-04/f5YqdmtLV7pLnFIM-image.png)

Após isso, clique em OK, conecte-se novamente à máquina remota, e verifique se o microfone na Ema.IA passou a funcionar.

<p class="callout info">Alguns softwares de proteção contra ameaças digitais, como o Kaspersky Endpoint Security, costumam bloquear o acesso ao microfone por aplicações desconhecidas, incluindo a Ema.IA. Neste caso se torna necessário solicitar ao administrador do sistema de segurança o desbloqueio da funcionalidade. O processo varia de acordo com a ferramenta, portando verifique a documentação da ferramenta utilizada.</p>

---

### A janela da Ema.IA fica sumindo

<span style="white-space: pre-wrap;">Isso costuma ocorrer quando a Ema.IA é acessada através de RemoteApp. Infelizmente, não é possível mitigar este problema devido às limitações da tecnologia, como informado </span>[acima](#bkmrk-diversos-clientes-ut)<span style="white-space: pre-wrap;">. </span>

---

### Erros causados pela ausência do Microsoft Visual C++ Redistributable

<p class="callout info"><span style="white-space: pre-wrap;">A partir da versão </span>**21.11**<span style="white-space: pre-wrap;"> das soluções Ema desktop, o Microsoft Visual C++ Redistributable passa a ser verificado e instalado automaticamente quando necessário, e esta seção deixa de ser aplicável. Em versões anteriores, o componente precisa ser instalado manualmente no servidor e nas máquinas que rodam o sistema localmente.</span></p>

<span style="white-space: pre-wrap;">O </span>**launcher da Ema.IA**<span style="white-space: pre-wrap;"> (</span>`<span class="editor-theme-code">emaia-launcher.exe</span>`<span style="white-space: pre-wrap;">) e o </span>**Runtime Local**<span style="white-space: pre-wrap;"> dependem do Microsoft Visual C++ Redistributable (x64) para executar. Quando ele não está presente no servidor — ou está presente em uma versão antiga, anterior à linha 14 ("evergreen") — os processos falham logo na inicialização, antes de conseguirem registrar qualquer mensagem de erro útil. Por isso os sintomas costumam ser confusos e não apontam diretamente para a causa.</span>

[![image.png](https://kb.emasistemas.com.br/uploads/images/gallery/2026-08/scaled-1680-/jVDmkqvQ5HmnsAde-image.png)](https://kb.emasistemas.com.br/uploads/images/gallery/2026-08/jVDmkqvQ5HmnsAde-image.png)

Sintomas típicos:

- <span style="white-space: pre-wrap;">Aparece mensagem de erro referente ao </span>`<span class="editor-theme-code">VCRUNTIME140.dll</span>`<span style="white-space: pre-wrap;"> como no popup acima</span>
- A Ema.IA não abre e nenhuma mensagem clara é exibida ao usuário.
- <span style="white-space: pre-wrap;">O launcher encerra com um </span>**código de saída negativo ou aparentemente aleatório**<span style="white-space: pre-wrap;"> (por exemplo </span>`<span class="editor-theme-code">-1073741515</span>`), sem gerar log.
- <span style="white-space: pre-wrap;">O </span>**Runtime Local funciona quando executado manualmente pela linha de comando, mas não inicia como serviço do Windows**. Este caso costuma indicar que existe uma versão antiga do redistributable instalada na máquina.

##### - Verifique se o redistributable está instalado

Execute o comando abaixo no PowerShell:

```powershell
Get-ItemProperty "HKLM:\SOFTWARE\Microsoft\VisualStudio\14.0\VC\Runtimes\x64" -ErrorAction SilentlyContinue | Select-Object Installed, Version
```

<span style="white-space: pre-wrap;">Se o comando não retornar nada, ou se </span>`<span class="editor-theme-code">Installed</span>`<span style="white-space: pre-wrap;"> for diferente de </span>`<span class="editor-theme-code">1</span>`, o runtime não está instalado e precisa ser instalado manualmente.

##### - Instale sempre a versão mais recente

<span style="white-space: pre-wrap;">Mesmo que o comando acima indique que já existe uma versão instalada, </span>**a recomendação diante de qualquer um dos erros acima é instalar a versão mais recente**, que atualiza o runtime existente sem necessidade de desinstalação prévia.

- <span style="white-space: pre-wrap;">Download direto (x64): </span>[https://aka.ms/vc14/vc\_redist.x64.exe](https://aka.ms/vc14/vc_redist.x64.exe)
- <span style="white-space: pre-wrap;">Página oficial da Microsoft, com todas as arquiteturas: </span>[Downloads mais recentes do Visual C++ Redistributable](https://learn.microsoft.com/pt-br/cpp/windows/latest-supported-vc-redist)

<span style="white-space: pre-wrap;">A instalação exige privilégios de administrador. Após a instalação, </span>**reinicie o serviço EmaIALocalRuntime** para que o novo runtime seja carregado, e tente abrir a Ema.IA novamente. Na maioria dos casos não é necessário reiniciar a máquina, mas caso os erros persistam pode se tornar uma etapa necessária.

---

### Não encontrou o problema que está acontecendo com você?

Neste caso, entre em contato com o suporte da Ema.IA para encontrar uma solução. Se for possível corrigiremos o problema com uma atualização do aplicativo, caso contrário, principalmente em situações que dependem de ferramentas externas, atualizaremos este artigo com as possíveis soluções.