Microsip Api Documentation Jun 2026
is an open-source portable SIP softphone for Windows based on the PJSIP stack . It does not have a traditional web-based REST API; instead, it relies on command-line arguments protocol handlers for external automation and integration. Technical Summary Report: MicroSIP Integration Methods As of April 2026, integration with MicroSIP is primarily handled through the following interfaces: 1. Command Line Interface (CLI) MicroSIP can be controlled via its executable using specific flags. This is commonly used by developers to launch the app with custom configurations or to initiate calls from external scripts. Call Execution: microsip.exe sip:user@domain microsip.exe number Custom Configuration: flag to specify a custom MicroSIP.exe /i:custom_config.ini Automation: Developers often use PowerShell or batch scripts to pass telephone numbers to MicroSIP as the default VOIP handler. 2. Protocol Handlers MicroSIP registers standard URI schemes in the Windows Registry, allowing it to respond to links in web browsers or other applications. Supported Schemes: Clicking a link like Call will trigger MicroSIP to dial the number automatically. Stack Overflow 3. PJSIP Library Integration Since MicroSIP is built on the PJSIP stack , advanced developers who need deeper programmatic control (e.g., handling media streams or complex call logic) often interact with the underlying PJSIP libraries rather than the MicroSIP GUI itself. Stack Overflow Source Code: The source is available under the GPL v2 license Requires building PJSIP first and setting appropriate library paths (e.g., for opus or other codecs). 4. Configuration via microsip.ini Most settings, including account credentials and behavior (like auto-answer), are stored in microsip.ini . External tools can programmatically modify this file before launching the application to "push" configurations to the client. Integration Method Best Use Case Complexity URL Protocols Web-based CRM click-to-dial CLI Arguments Simple desktop automation / scripts INI File Editing Remote provisioning / mass deployment PJSIP Source Building custom branded softphones for remote deployment? MicroSIP online help
This is a comprehensive guide to interacting with MicroSIP programmatically. Unlike modern VoIP softphones (like Zoiper or Linphone), MicroSIP does not have a built-in HTTP/REST API or a WebSocket interface. Instead, it relies on Standard Windows Command Line Arguments and Windows Message Hooks . This guide covers how to control MicroSIP externally using these methods.
1. The "API" Architecture Since there is no REST API, "integrating" with MicroSIP typically involves:
CLI (Command Line Interface): Launching the executable with arguments to make calls or send messages. INI File Manipulation: Reading/Writing the configuration file to change settings. Window Messaging (Advanced): Sending Windows API messages to simulate button clicks (e.g., "Hangup"). microsip api documentation
2. Command Line Interface (CLI) API This is the primary way to interact with MicroSIP from external applications (C#, Python, Batch scripts, etc.). Syntax: microsip.exe [command] [arguments]
Available Commands | Command | Argument | Description | Example | | :--- | :--- | :--- | :--- | | (None) | number | Launches MicroSIP and immediately dials the number. | microsip.exe 1001 | | call | number | Dials the number (same as default behavior). | microsip.exe call 1001 | | chat | sip_address | Opens the chat window for a specific SIP address. | microsip.exe chat sip:user@domain.com | Usage Notes:
If MicroSIP is already running, these commands will utilize the existing instance. Arguments are passed after the executable path in your script. is an open-source portable SIP softphone for Windows
3. Configuration "API" (INI File) MicroSIP stores all settings in a standard .ini file. You can programmatically read and write to this file to configure accounts, codecs, and network settings. File Location: By default, the configuration file is located in the user's AppData folder: %APPDATA%\MicroSIP\microsip.ini (Note: If you are using the portable version, the .ini file is in the same folder as the executable.) Key Sections and Parameters [Account] (The SIP Credentials) You can automate the setup of SIP accounts by writing to this section. [Account] Account=name@example.com ; The SIP username/domain Domain=example.com ; SIP Domain (optional) Proxy=sip:proxy.example.com ; Outbound proxy (optional) AuthID=1001 ; Authentication ID (if different from username) Password=secret123 ; Plain text password DisplayName=John Doe ; Caller ID Name
[Settings] (Behavior) Control how the app behaves. [Settings] AutoAnswer=1 ; 1 = Enabled, 0 = Disabled DoNotDisturb=0 ; 1 = DND On SilenceThreshold=10 ; Mic sensitivity
[Codecs] (Audio Priority) Define which audio codecs are enabled and their priority. [Codecs] PCMU=8000 PCMA=8000 G722=8000 Opus=48000 Command Line Interface (CLI) MicroSIP can be controlled
Automation Strategy: A script can generate this file before launching MicroSIP, allowing for dynamic provisioning of SIP accounts.
4. Advanced Control (Windows API) If you need to programmatically perform actions like Hangup , Hold , or Answer while the app is running (without user input), you must use Windows API calls. Note: This requires a programming language that supports Win32 API (C++, C#, Python with pywin32 , AutoIt, etc.). Logic Flow: