3CX Softphone AutoDeployment Using Intune

Overview

Deploying the 3CX Softphone via Microsoft Intune allows IT admins to install the application on many devices running Windows 11 simultaneously, without manual intervention.

Configure the Intune Portal

To configure the Intune Portal for automatic distribution of the 3CX Softphone:

  • Click the Create button

  • Set the app type to Microsoft Store app (new); click the Select button at the bottom of the panel

  • Click the Search the Microsoft Store app (new) link

  • Enter 3CX in the search field, click the 3CX app from the list, and click the Select button at the bottom of the panel

  • In the App information tab, leave all fields at their default value, and click the Next button

  • In the Assignments tab, select which users should have the app deployed; typically you would assign one or more Security Groups representing those users who need to use the app; click the Next button when done
  • In the Review + create tab, simply click the Create button

The 3CX Softphone is now added to Intune, and will deploy to your selected users.

Additional: Command-line Argument support

The following command-line options are currently supported:

  • --restore-defaults, -R: Restores all CLI-configurable settings to their default values. If additional options are provided, they are applied after defaults are restored.
  • --host: Pre-load the PBX URL when provisioning manually via credentials or 2FA.
  • --echo-cancellation, -e: Enable or disable echo cancellation (true | false).
  • --ringer-volume, -r: Set the ringer volume (25, 50, 75, 100).
  • --mic-gain, -m: Set microphone gain (100–400).
  • --crm: Enable or disable CRM integration (true | false).
  • --crm-action: Set CRM integration behavior (OpenBrowser | OpenApp).
  • --crm-exe-path: Define the executable path for CRM integration.
  • --crm-exe-params: Define parameters passed to the CRM executable.
  • --crm-notify-when: Set when CRM notifications are triggered (Ringing | Connected).
  • --tapi: Enable or disable TAPI integration (true | false).
  • --provision-via-desktop-app: Migrate existing Desktop app account to the new Softphone

Note: For settings to apply successfully, the Softphone client must be installed and fully closed before running commands. Executing the commands will automatically launch the application. Administrators deploying these settings via scripts should terminate any existing instance beforehand. Example PowerShell command: Stop-Process -Name "3CXSoftphone" -Force

Full PowerShell Example:

Start-Process "shell:AppsFolder\3CXDMCC.3CX_bhm4yemhnd70e!App" -ArgumentList "--host https://my3cxpbxurl.domain.tld --echo-cancellation true --ringer-volume 50 --mic-gain 250 --crm true --crm-action OpenApp --crm-exe-path ""C:\Program Files\App.exe"" --crm-exe-params ""%CallerNumber% %CallerDisplayName%"" --crm-notify-when Connected --tapi true"

See also

Last updated

This document was last updated 27 July 2026

https://www.3cx.com/docs/softphone-intune/