SoftphonePro.ini configuration file

SoftphonePro.ini file stores Softphone.Pro user settings. It is located at the following folder by default:

Windows
C:\Users\[WINDOWS-USER]\AppData\Local\SoftphonePro
, where [WINDOWS-USER] - is your Windows user name.

MacOS
/Users/[USER]/Library/Application Support/SoftphonePro/
, where [USER] - is your MacOS user name.

How to edit SoftphonePro.ini

1. Exit Softphone.Pro:

Exiting SoftphonePro

2. Open SoftphonePro.ini in Notepad or any program you like for editing the text file:

SoftphonePro.ini configuration file

[AppSettings] Section

Parameter Default value Description
License License key
RunOnStartup 0 Run application on Windows startup
SaveRecords 1 Start call recording automatically
ShowActiveCallsWindow 1 Display Active Calls window
ShowContactsWindow 1 Display Contacts window
ShowHistoryWindow 1 Display Call Log window
ShowFloatingWindow 1 Display Floating call control window
MainWindowOnIncomingAnswer 1 Pop-up main window on incoming call answer
MainWindowOnOutgoing 1 Pop-up main window on outgoing call
EnableCallWaiting 1 Enable call waiting
AutoAnswer None Enable auto answer. Available options: None - disabled, All - always enabled, SipHeader - enabled if specific SIP INVITE header exists
VoiceActivityDetection 1 Enable voice activity detection
EchoCancellation 1 Enable echo cancellation
AudioCodecs PCMA/8000/1 PCMU/8000/1 Enabled audio codecs separated with space character. Available options: PCMA/8000/1 - G.711 a-law, PCMU/8000/1 - G.711 u-law, G722/16000/1, G729/8000/1, GSM/8000/1, L16/44100/1, L16/44100/2, iLBC/8000/1, opus/48000/2, speex/16000/1, speex/32000/1, speex/8000/1
CallHistoryCount 100 Number of last calls and corresponding audio recordings to store and display on Call Log window
ShowSipAccountInCallHistoryWindow 1 Display SIP account name on Call Log window
ContactsWindowWidth Contacts window width, pixels
PostProcessingWindowEnabled 0 Enable after call work (ACW)
PostProcessingStatus After call work status
IncomingCallWindowPosition Center Incoming call notification window position. Available options: Center - center, BottomRightCorner - botoom right corner.
RingDevice The device on which the melody of the incoming call will be played
Speaker Output device
Microphone Input device
LogEnabled 1 Activating logging
LogLevel Warning Logging level
LogFileSize 1MB Maximum log file size
LogFilesCount 3 Maximum number of log files
LogPath file:///C:/.../SoftphonePro/ Path to data folder
VolumeLevelMicrophone 0.5 Microphone volume
VolumeLevelSpeaker 0.5 Speaker volume
VolumeLevelRingDevice 0.5 RingDevice volume level
ReduceExternalSounds 1 Mute Windows sounds during a call
EnableKeyPressSounds 1 Sound the press of buttons when dialing a number
PlaySoundAfterHangup 1 Play audio after call hangup
PhoneStatus Online Current status
MainWindowX 403 X-axis position of the main window
MainWindowY 244 Y-axis position of the main window
ActiveCallsWindowX 766 Position of the Active calls window along the X axis
ActiveCallsWindowY 244 Position of the Active calls window on the Y axis
ContactsWindowX 1129 Position of the Contacts window on the X axis
ContactsWindowY 244 Position of the Contacts window on the Y axis
CallHistoryWindowX 1492 Position of the Call log window on the X axis
CallHistoryWindowY 244 Position of the Call log window on the Y axis
FloatingWindowX 704 Position of the mini pop-up window Call controll on the X axis
FloatingWindowY 484 Position of the mini pop-up window Call controll on the Y axis
PostProcessingWindowX 860 Position of the Post-processing window on the X axis
PostProcessingWindowY 470 Position of the Post-processing window on the Y axis
Language Russian Interface language
AnswerShortcutKey Hotkey to answer an incoming call
HangupShortcutKey Hotkey to reset the call
IgnoreShortcutKey Hotkey to ignore the call
FixRecording 0 Reinitializes call recording on media session changes. Use this option if only one person is heard on the call recording
DisableSessionTimers 0 Disable session timers. Use this option if your calls are interrupted after XX minutes
JabraHeadsetIntegration 0 Jabra headset support
PlantronicsHeadsetIntegration 0 Plantronics headset support
Scale 100 Interface scale in %
SetSipBusyHereForNA 1 Reject calls if user status is "Busy"
SetSipBusyHereForAway 1 Reject calls if user status is "Away"
UserIdleSetAway 1 Change the status to "Away" if there is no activity after UserIdleTime minutes
UserIdleTime 5 The number of minutes to change the status in case of inactivity
UserIdleSetOnline 1 Change status to "Online" when activity is detected
AwayStatusSelectionDisabled 0 Prevent selection of the "Away" status
BusyStatusSelectionDisabled 0 Prevent selection of the "Busy" status
AfterCallWorkTimeout 0 Time limit for post-processing in seconds
DisableCallRecordingControl 0 Disable the ability to turn off automatic call recording
IgnoreInboundCallIfStatusNA 0 Ignore incoming calls if user status is "Busy"
IgnoreInboundCallIfStatusAway 0 Ignore incoming calls if user status is "Away"
UnregAccsForNA 0 Unregister SIP accounts if user status is "Busy"
UnregAccsForAway 0 Unregister SIP accounts if user status is "Away"
ExtensionDialingEnabled 1 Activating the extension dialing function
ExtensionDialingPauseSymbol Pause symbol in extension dialing function
ExtensionDialingPauseSec 2 Pause duration in seconds
CameraRecordingEnabled 0 Activating operator recording by camera
CameraRecordingIntervalSec 10 Operator shooting interval in seconds
VideoRecordingEnabled 0 Activating operator screen recording
VideoRecordingFramerate 1 Frame rate per second for operator screen recording
AlwaysOnTop 0 Show Softphone.Pro above all windows
ClipboardIntegration 0 Track the status of the clipboard
ClipboardCopyNumberOnIncomingAnswer 0 Copy number to clipboard when answering an incoming call
StunServers stun.softphone.pro List of global STUN servers separated by a space
ACWReminderEnabled 0 Activating the reminder field in Post-processing window
ACWNotesEnabled 0 Activating the notes field in Post-processing window
ACWMinimumCallDuration 0 Minimum duration of the call in seconds that triggers After Call Work window pop-up.
If the value is 0, After Call Window will show after every inbound and outbound call.
ForceCodecForIncoming 0 Requiring the use of certain codecs from the other side of the call
DenyIncoming 0 Allow incoming from registered domains only
PlayCallWaitingTone Play a sound signal for an incoming call when it's calling to the second line
ShowSipNameInCallHistoryWindow Show sip account name in Call log window
EnableLocalAccount 0 A local account is created (Allows you to make calls if you do not have a SIP server and SIP account. In this case, you can use ip as a phone number)
SoundEvents 1 Activation of sounds for pressing dial buttons, sound after call rejection, etc.
ReloadSipOnNetworkChanged 0 Update connection parameters and re-register SIP accounts on network change (i.e. when switching from wired connection to Wi-Fi). Supported only in Windows OS.

[SipAccount] Section

You should create separate [SipAccount] section for each SIP account you're going to use [SipAccount].

Each section must have unique name containing section name and its index: [SipAccount1], [SipAccount2], [SipAccount3].

A config file cannot have multiple sections [SipAccount] with the same names.

Parameter Default value Description
RegisterOnStartup 1 Register on startup
Name Account name
Server 0 SIP server hostname\IP and port. Default port is 5060
Proxy SIP proxy hostname\IP and port. Default port is 5060.
Domain Registration domain
AuthId Authorization name
Username Username
Password Authorization password
DisplayName Display name
PublicAddress Public IP
LocalPort Local SIP port
RegisterTimeout 300 SIP registration timeout, seconds
SRTP None Media encryption
Transport Auto Transport protocol
CallTransferMode Sip Call transfer mode. Available options: Sip - SIP REFER, Dtmf - DTMF
CallTransferDTMF DTMF mode call transfer suffix and prefix separated by space character
CallPickupDTMF DTMF Call Pickup
PublishPresence 0 Publish presence indication
RtpPortStart RTP ports interval start value
RtpPortEnd RTP ports interval end value
FirewallTraversalMethod ICE Firewall Bypass Method
ICE
STUN
LOCAL
AllowIpRewrite 0 Allow IP rewrite
IsDefault Selected on Outbound accountfield
KeepAliveTimeout 15 SIP keep-alive timeout, seconds
RingingSound Ringtone for SIP account (Ex.: C:/Users/.../custom.wav)

[ContactAccount] section

For each phone book in SoftphonePro.ini it is necessary to define a separate section [ContactAccount].

Each section must have unique name containing section name and its index: [ContactAccount1], [ContactAccount2], [ContactAccount3].

A config file cannot have multiple sections [ContactAccount] with the same names.


Google Contacts phone book synchronization

Softphone.Pro can synchronize address book with Google Contacts. You can't add or modify Google Contacts with Softphone.Pro.

Parameter Default value Description
ContactType GoogleContacts Phone book type
Enabled 1 Enabling / disabling integration
Name Name of the book
UpdateTimeout Update frequency
AccessToken Access token (if required)
AccessTokenExpiration Token expiration (if required)
TokenType The type of token to send in an HTTP request (usually TokenType = Bearer)
RefreshToken The token with which the temporary AccessToken is updated
UseForTransfer Use to transfer calls
UseForPresense Receive information about the state of the subscriber
PresenceSipAccount Account for receiving information about the state of the subscriber
MaxDownloadedContactsCount 25 The amount of contacts requested in one batch when using Google Contacts sync. Supported in Softphone.Pro 4.7.


Cisco, Yealink XML remote phone book synchronization

Softphone.Pro can synchronize with remote phone book. The remote phone book should be Cisco, Yealink XML file format located on shared network folder or HTTP/HTTPS web-server.

Download Cisco, Yealink XML remote phone book example

Parameter Default value Description
ContactType CiscoXml Phone book type
Enabled 1 Enabling / disabling integration
Name Name of the book
UpdateTimeout Update frequency
Location Full path to the XML file
UseForTransfer Use to transfer calls
UseForPresense Receive information about the state of the subscriber
PresenceSipAccount Account for receiving information about the state of the subscriber

[CrmAccount] section

For every CRM in SoftphonePro.ini it is necessary to define a separate section [CrmAccount].

Each section must have a unique name, consisting of the name of the section and its serial number, for example: [CrmAccount1], [CrmAccount2], [CrmAccount3].

A config file cannot have multiple sections [CrmAccount] with the same names.

Parameter Default value Description
CrmType AmoCRM CRM type
Enabled 0 Enabling / disabling integration
Server amocrm.ru CRM server
Account Company account
Login Login (For integrations with OAuth 2.0 authorization, this parameter contains one of the tokens)
Password Password (For integrations with OAuth 2.0 authorization, this parameter contains one of the tokens)
DigitsCount 7 Number of digits to identify the number
MaxDigitsCount 20 The maximum number of digits to identify the number

[SimpleCallsAccount] section

SimpleCallsAccount section intended for setting up integration with "Simple Calls".

Parameter Default value Description
SendAccountNumber 0 Send account name as incoming line
AllowOutgoingCalls 1 Allow outgoing calls
ServerName wss://softphone.prostiezvonki.ru:443 Server name
ServerPassword Password
InnerPhoneNumber Internal phone number
RecordServer http://rec.prostiezvonki.ru/upload_post.php Recording server
ReconnectTimeoutSec 10 Reconnection interval in seconds
Guid Client Guid
LoginUrl Login address

[EmailNotifyAccount] section

EmailNotifyAccount section designed to send notifications about missed calls by Email.

For each Email in SoftphonePro.ini it is necessary to define a separate section [EmailNotifyAccount].

Each section must have a unique name, consisting of the name of the section and its serial number, for example: [EmailNotifyAccount1], [EmailNotifyAccount2], [EmailNotifyAccount3].

A config file cannot have multiple sections [EmailNotifyAccount] with the same names.

Parameter Default value Description
Address Email
Enabled 0 Turn function on / off

[ExternalEventReceiver] section

ExternalEventReceiver section designed to handle events.

For every event in SoftphonePro.ini it is necessary to define a separate section [ExternalEventReceiver].

Each section must have a unique name, consisting of the name of the section and its serial number, for example: [ExternalEventReceiver1], [ExternalEventReceiver2], [ExternalEventReceiver3].

A config file cannot have multiple sections [ExternalEventReceiver] with the same names.

Parameter Default value Description
EventType EventType

IncomingCallStarted

IncomingCallAnswered

OutgoingCall

CallFinished

ACWFinished

StatusChanged
AppType Action type

Web - Call a web service

Local - Launch a program

LocalBrowser - Open a link in web browser

CallRecordToWeb - Upload a call recording

VideoRecordToWeb - Upload a screen recording

WebCamImageToWeb - Upload a camera snapshot
Link Link

Call a web service
Link="http://example.com?event=%EVENT%×tamp=%TIMESTAMP%
&direction=%DIRECTION%&login=%LOGIN%&server=%SERVER%&number=%NUMBER%&
callername=%CALLERNAME%&applogin=%APPLOGIN%&header=%HEADER1%"

Launch a program
Link="C:\\Example\\example.exe -event=%EVENT% -timestamp=%TIMESTAMP%
-direction=%DIRECTION% -login=%LOGIN% -server=%SERVER% -number=%NUMBER%
-callername=%CALLERNAME% -applogin=%APPLOGIN% -header=%HEADER1%"

Open a link in web browser
Link="http://example.com?event=%EVENT%×tamp=%TIMESTAMP%&
direction=%DIRECTION%&login=%LOGIN%&server=%SERVER%&number=%NUMBER%&
callername=%CALLERNAME%&applogin=%APPLOGIN%&header=%HEADER1%"

After call work finished
Link="http://example.com?event=%EVENT%×tamp=%TIMESTAMP%&
direction=%DIRECTION%&login=%LOGIN%&server=%SERVER%&number=%NUMBER%&
callername=%CALLERNAME%&duration=%DURATION%&header=%HEADER1%&
acw_duration=%ACW_DURATION%&acw_tag=%ACW_TAG%&
acw_reminder=%ACW_REMINDER%&acw_notes=%ACW_NOTES%"

Status change
Link="http://example.com?event=%EVENT%×tamp=%TIMESTAMP%&
number=%NUMBER%&direction=%DIRECTION%
&statusname=%STATUSNAME%&statustype=%STATUSTYPE%"

Upload a call recording
http://example.com/uploadCallRecords/upload.php

Upload a screen recording
Link=http://example.com/uploadScreenRecords/upload.php

Upload a camera snapshot
Link=http://example.com/uploadCameraSnapshot/upload.php

Events description

%EVENT% - event type
%TIMESTAMP% - event date and time
%DIRECTION% - incoming/outbound call
%LOGIN% - SIP login
%SERVER% - SIP server
%NUMBER% - caller ID
%CALLERNAME% - caller name
%APPLOGIN% - user login
%HEADER1% - SIP INVETE header
%DURATION% - call duration
%RECORD% - recordinf file full path on local computer
%RECORDFILENAME% - audio recording file name
%VIDEORECORDFILENAME% - screen recording file name
%ACW_DURATION% - after call work duration in seconds
%ACW_TAG% - call tag
%ACW_REMINDER% - after call work reminder UNIX timestamp
%ACW_NOTES% - notes
%STATUSNAME% - status name
%STATUSTUPE% - status type
InputName Tag name attribute <input> (The field appears in the GUI if you select the End call event and the Load audio recording of a call (or video) action)
PeriodicalSendPhoneStatusEnabled 0 Activation of periodic sending of operator status
PeriodicalSendPhoneStatusIntervalSec 10 Send period in seconds
SipAccount 0 SIP account ID for which the handler is triggered

[CallForwardAccount]

CallForwardAccount section for setting up call forwarding.

For each number to be diverted to SoftphonePro.ini it is necessary to define a separate section [CallForwardAccount].

Each section must have a unique name, consisting of the name of the section and its serial number, for example: [CallForwardAccount1], [CallForwardAccount2], [CallForwardAccount3].

A config file cannot have multiple sections [CallForwardAccount] with the same names.

Parameter Default value Description
Enabled 0 Turn function on / off
Number Number
WaitTimeoutSec Redirect if there is no response within WaitTimeoutSec seconds

[PrerecordedAudioFile] section

PrerecordedAudioFile section designed to customize pre-recorded audio messages.

For each audio message in SoftphonePro.ini it is necessary to define a separate section [PrerecordedAudioFile].

Each section must have a unique name, consisting of the name of the section and its serial number, for example: [PrerecordedAudioFile1], [PrerecordedAudioFile2], [PrerecordedAudioFile3].

A config file cannot have multiple sections [PrerecordedAudioFile] with the same names.

Parameter Default value Description
Name Message title
Path C:\\...\\message.wav Audio message path

[CallTag] section

CallTag section intended for adding post-processing tags.

For each tag in SoftphonePro.ini it is necessary to define a separate section [CallTag].

Each section must have a unique name, consisting of the name of the section and its serial number, for example: [CallTag1], [CallTag2], [CallTag3].

A config file cannot have multiple sections [CallTag] with the same names.

Parameter Default value Description
Name Tag name

[CustomStatus] section

CustomStatus section intended for adding custom user statuses.

For each status in SoftphonePro.ini it is necessary to define a separate section [CustomStatus].

Each section must have a unique name, consisting of the name of the section and its serial number, for example: [CustomStatus1], [CustomStatus2], [CustomStatus3].

A config file cannot have multiple sections [CustomStatus] with the same names.

Parameter Default value Description
Name Custom status name
Status Condition of status (Online, Away, NA, Offline)