Resolving 3CX Windows Softphone Issues

Introdução

Como os diferentes computadores com Microsoft Windows podem ter versões exatas do Windows ou históricos de atualização distintos, em alguns casos raros, talvez seja necessário tomar medidas para restaurar a funcionalidade do Softphone 3CX.

Este documento aborda alguns dos problemas mais comuns e explica como resolvê-los.

Problemas com o Windows

Softphone iniciado, mas permanece em segundo plano

O Softphone Inicia, mas permanece em segundo plano

Se o seu Softphone 3CX iniciar corretamente, mas não aparecer automaticamente na área de trabalho, siga estas etapas:

  • Como primeiro passo, acesse:

%localappdata%\Packages\3CXDMCC.3CX_97f1hnz6y6tba\LocalCache\Local\3CXSoftphone

OU

%localappdata%\Packages\3CXDMCC.3CX_bhm4yemhnd70e\LocalCache\Local\3CXSoftphone

OU  

%localappdata%\Packages\3CXDMCC.3CXBeta_bhm4yemhnd70e\LocalCache\Local\3CXSoftphone

  • E abra o arquivo .log.
  • Verifique se o arquivo de log contém as linhas mostradas abaixo; observação: você deve procurar a string correspondente à versão atual do seu Softphone, por exemplo, "release-V5.6".

[FTL|2|_3CXSoftphone.App] UNHANDLED EXCEPTION

System.IO.FileNotFoundException: The specified module could not be found. (0x8007007E)

   at System.Runtime.InteropServices.Marshal.ThrowExceptionForHR(Int32 errorCode)

   at WinRT.ActivationFactory.Get(String typeName)

   at Windows.Media.Playback.MediaPlayer.get__objRef_global__Windows_Media_Playback_MediaPlayer()

   at Windows.Media.Playback.MediaPlayer..ctor()

   at _3CXSoftphone.Telephony.Ringtone.RingtonePlayerImpl..ctor(ILoggerFactory loggerFactory, IAudioDeviceSource audioDeviceSource, ISettingsService settingsService) in C:\_\workspace\3CXPhone\softphone\release-V5.6\app\3CXSoftphone\Telephony\Ringtone\RingtonePlayerImpl.cs:line 31

Se essa exceção for exibida, execute as seguintes ações:

  • Clique em Iniciar > Executar, digite optionalfeatures (recursos opcionais) e pressione OK
  • Selecione Recursos de Mídia
  • Expanda e certifique-se de que Windows Media Player Legacy (App) também esteja selecionado
  • Clique no botão OK
  • Após a conclusão do processo, reinicie o computador.
  • Caso as etapas acima não funcionem e você ainda esteja recebendo o mesmo erro, abra o PowerShell como administrador e execute o seguinte comando:

                

Get-WindowsCapability -online | Where-Object -Property name -like "*media*" | Add-WindowsCapability -Online

  • Reinicie o computador.

O Softphone Inicia e Encerra Imediatamente

Se o seu Softphone parecer iniciar normalmente, mas fechar imediatamente em seguida, siga as etapas abaixo para resolver o problema:

  • Como primeiro passo, verifique o Visualizador de Eventos:
  • Expanda Logs de Aplicativos e Serviços > Microsoft > Windows > AppxDeploymentServer > Microsoft-Windows-AppxDeploymentServer/Operacional
  • Verifique se há uma entrada semelhante a esta:

        

MicrosoftCorporationII.WinAppRuntime.Singleton_8000.921.1539.0_x64__8wekyb3d8bbwe :

C:\Program Files\WindowsApps\MicrosoftCorporationII.WinAppRuntime.Singleton_8000.921.1539.0_x64__8wekyb3d8bbwe\microsoft.system.package.metadata\S-1-5-21-...-MergedResources-*.pri :

No user-specific merged files found

Você pode confirmar ainda mais se esse é exatamente o problema a ser resolvido seguindo as etapas abaixo:

  • Confirmando que a execução do Softphone como Administrador funciona corretamente;
  • São especificamente as sessões de usuário padrão que apresentam falhas.
  • Observação: a versão do seu Singleton do WindowsAppRuntime; execute o seguinte comando no PowerShell:

Get-AppxPackage -Name "*WinAppRuntime.Singleton*" | Select-Object Name, Version, PackageFullName

  • Compare com a tabela abaixo, pesquise Windows App SDK + versão no Google e baixe o pacote redistribuível (ZIP) da Microsoft:

Singleton Version

Windows App Runtime Version

7000.xxx.xxxx.x

Windows App SDK 1.7

8000.xxx.xxxx.x

Windows App SDK 1.8

  • Descompacte o arquivo ZIP e acesse:
  • /{ExtractedFolder}/MSIX/win10-x64
  • Siga as duas etapas indicadas a seguir:
  • Como Administrador, copie o arquivo .msix do Singleton para sua pasta pessoal “Downloads” e, em seguida,
  • Execute o seguinte comando no Powershell com direitos de Administrador:

Para o Windows App SDK 1.7

$path = "$env:USERPROFILE\Downloads\Microsoft.WindowsAppRuntime.Singleton.1.7.msix"

Add-AppxProvisionedPackage -Online -PackagePath $path -SkipLicense -LogPath "C:\Temp\Singleton_Provision.log"

Para o Windows App SDK 1.8

$path = "$env:USERPROFILE\Downloads\Microsoft.WindowsAppRuntime.Singleton.1.8.msix"

Add-AppxProvisionedPackage -Online -PackagePath $path -SkipLicense -LogPath "C:\Temp\Singleton_Provision.log"

  • Depois de fazer isso, faça login novamente no Windows como o usuário que está enfrentando o problema de inicialização do Softphone e, sem estar no modo de administrador, execute o seguinte comando no PowerShell:

Add-AppxPackage -RegisterByFamilyName -MainPackage "MicrosoftCorporationII.WinAppRuntime.Singleton_8wekyb3d8bbwe" -Verbose

  • Feche e reinicie o Softphone com a conta do usuário afetado para confirmar se agora ele inicia normalmente

Veja Também

Última Atualização
Este documento foi atualizado pela última vez em 28 de julho de 2026
https://www.3cx.com.br/docs/troubleshoot-softphone/