Конфигурационный файл SoftphonePro.ini

Конфигурационный файл SoftphonePro.ini используется для хранения настроек Softphone.Pro и находится в папке с данными приложения:

Windows
C:\Users\[WINDOWS-USER]\AppData\Local\SoftphonePro
где [WINDOWS-USER] - имя пользователя Windows.

MacOS
/Users/[USER]/Library/Application Support/SoftphonePro/
где [USER] - имя пользователя MacOS.

Редактирование конфигурационного файла

Чтобы отредактировать конфигурационный файл, необходимо выполнить следующие действия:

1. Выйдите из Softphone.Pro:

Выход из SoftphonePro

2. Oткройте файл SoftphonePro.ini с помощью Notepad или другой программы для редактирования текстовых файлов:

Конфигурационный файл SoftphonePro.ini

Раздел [AppSettings]

Параметр Значение по умолчанию Описание
LicenseKey Лицензионный ключ
RunOnStartup 0 Запускать приложение при старте Windows
SaveRecords 1 Автоматический запуск аудио-записи звонка
ShowActiveCallsWindow 1 Показывать окно Активные звонки
ShowContactsWindow 1 Показывать окно Контакты
ShowHistoryWindow 1 Показывать окно Журнал звонков
ShowFloatingWindow 1 Показывать окно Мини-окно управления звонком
ShowPersonalStatisticsWindow 1 Показывать окно Персональная статистика
ShowMessagingWindow 1 Показывать окно Сообщения
MainWindowOnIncomingAnswer 1 Выводить на передний план главное окно при входящем звонке
MainWindowOnOutgoing 1 Выводить на передний план главное окно при исходящем звонке
WindowModeSelectedIdx TwoWindowMode Последний выбранный режим интерфейса софтфона: TwoWindowMode - двуоконный режим (выбран по умолчанию), MultiWnidowMode - многоконный режим, CompactWindowMode - компактный режим
LastFullSizeWindowMode TwoWindowMode Режим интерфейса софтфона, в котором он был свёрнут: TwoWindowMode - двуоконный режим (выбран по умолчанию), MultiWnidowMode - многоконный режим
EnableCallWaiting 1 Включить режим удержания второго и последующих активных звонков
AutoAnswer None Включить режим автоответа. Возможные значения: None - выключен, All - включен, SipHeader - автоответ при получении специального SIP заголовка
VoiceActivityDetection 1 Отправлять сигнал с микрофона собеседнику, только если пользователь говорит
EchoCancellation 1 Включить режим подавления эха
AudioCodecs PCMA/8000/1 PCMU/8000/1 Список аудио-кодеков, разделенных знаком пробел. Возможные значения: 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 Количество последних звонков и соответствующих им аудиозаписей, которое сохраняется и отображается в окне Журнал звонков
ShowSipAccountInCallHistoryWindow 1 Показывать название SIP учетной записи в окне Журнал звонков
ContactsWindowWidth Ширина окна Контакты в пикселях
PostProcessingWindowEnabled 0 Включить режим постобработки звонка
PostProcessingStatus Статус пользователя, который будет автоматически установлен при переходе в режим постобработки звонка
IncomingCallWindowPosition Center Местоположение окна-уведомления о входящем звонке. Возможные значения: Center - в центре экрана, BottomRightCorner - в нижнем правом углу окна.
RingDevice Устройство, на котором будет проигрываться мелодия входящего звонка
Speaker Устройство вывода
Microphone Устройство ввода
LogEnabled 1 Активация логирования
LogLevel Warning Уровень логирования
LogFileSize 1MB Максимальный размер лог-файла
LogFilesCount 3 Максимальное количество лог-файлов
LogPath file:///C:/.../SoftphonePro/ Путь до папки с данными
VolumeLevelMicrophone 0.5 Уровень громкости Microphone
VolumeLevelSpeaker 0.5 Уровень громкости Speaker
VolumeLevelRingDevice 0.5 Уровень громкости RingDevice
ReduceExternalSounds 1 Приглушать звуки Windows во время звонка
EnableKeyPressSounds 1 Озвучивать нажатие кнопок при наборе номера
PlaySoundAfterHangup 1 Проигрывать звук после отбоя вызова
PhoneStatus Online Текущий статус
MainWindowX Положение главного окна по оси X
MainWindowY Положение главного окна по оси Y
ActiveCallsWindowX Положение окна Активные звонки по оси X
ActiveCallsWindowY Положение окна Активные звонки по оси Y
ContactsWindowX Положение окна Контакты по оси X
ContactsWindowY Положение окна Контакты по оси Y
CallHistoryWindowX Положение окна Журнал звонков по оси X
CallHistoryWindowY Положение окна Журнал звонков по оси Y
FloatingWindowX Положение окна Мини-окно управления звонком по оси X
FloatingWindowY Положение окна Мини-окно управления звонком по оси Y
PostProcessingWindowX Положение окна Постобработка по оси X
PostProcessingWindowY Положение окна Постобработка по оси Y
PersonalStatisticsWindowX Положение окна Персональная статистика по оси X
PersonalStatisticsWindowY Положение окна Персональная статистика по оси Y
MessagingWindowX Положение окна Сообщения по оси X
MessagingWindowY Положение окна Сообщения по оси Y
Language Russian Язык интерфейса
AnswerShortcutKey Горячие клавиши для ответа на входящий звонок
HangupShortcutKey Горячие клавиши для сброса звонка
IgnoreShortcutKey Горячие клавиши для игнорирования звонка
FixRecording 0 Повторно инициализирует запись звонка при изменениях медиа-сессии. Примените этот параметр, если на записи звонка слышно только одного собеседника
DisableSessionTimers 0 Отключение сессионных таймеров. Примените этот параметр, если ваши звонки прерываются через ХХ минут
JabraHeadsetIntegration 0 Поддержка гарнитур Jabra. Параметр не используется с версии 5.5, используйте параметр HidIntegrationDevice.
PlantronicsHeadsetIntegration 0 Поддержка гарнитур Plantronics. Параметр не используется с версии 5.5, используйте параметр HidIntegrationDevice.
Scale 100 Масштаб интерфейса в %
SetSipBusyHereForNA 1 Отклонять вызовы, если статус пользователя "Занят"
SetSipBusyHereForAway 1 Отклонять вызовы, если статус пользователя "Отошел"
UserIdleSetAway 1 Менять статус на "Отошел" при отсутствии активности через UserIdleTime минут
UserIdleTime 5 Количество минут для смены статуса при отсутствии активности
UserIdleSetOnline 1 Менять статус на "Онлайн" при обнаружении активности
AwayStatusSelectionDisabled 0 Запретить выбор статуса "Отошел"
BusyStatusSelectionDisabled 0 Запретить выбор статуса "Занят"
AfterCallWorkTimeout 0 Ограничение по времени на постобработку в секундах
DisableCallRecordingControl 0 Отключение возможности выключить автоматическую запись звонков
IgnoreInboundCallIfStatusNA 0 Игнорировать входящие вызовы, если статус пользователя "Занят"
IgnoreInboundCallIfStatusAway 0 Игнорировать входящие вызовы, если статус "Отошел"
UnregAccsForNA 0 Разрегистрировать SIP учётные записи, если статус пользователя "Занят"
UnregAccsForAway 0 Разрегистрировать SIP учётные записи, если статус "Отошел"
ExtensionDialingEnabled 1 Активация функции донабора
ExtensionDialingPauseSymbol Символ паузы в функции донабора
ExtensionDialingPauseSec 2 Длительность паузы в секундах
CameraRecordingEnabled 0 Активация записи оператора камерой
CameraRecordingIntervalSec 10 Интервал съемки оператора в секундах
VideoRecordingEnabled 0 Активация записи экрана оператора
VideoRecordingFramerate 1 Частота кадров в секунду при записи экрана оператора
AlwaysOnTop 0 Отображать Softphone.Pro поверх всех окон
ClipboardIntegration 0 Отслеживать состояние буфера обмена
ClipboardCopyNumberOnIncomingAnswer 0 Копировать номер в буфер обмена при ответе на входящий звонок
StunServers stun.softphone.pro Список глобальных STUN серверов через пробел
DnsServers Список DNS серверов через пробел
ACWReminderEnabled 0 Активация поля напоминания в окне Постобработка
ACWNotesEnabled 0 Активация поля комментария в окне Постобработка
ACWMinimumCallDuration 0 Минимальное время звонка (в секундах), при превышении которого будет показываться окно постобработки.
При значении 0 окно постобработки показывается после всех входящих и исходящих звонков.
ForceCodecForIncoming 0 Требование использования определенных кодеков от другой стороны звонка
DenyIncoming 0 Разрешить входящие только с зарегистрированных доменов
PlayCallWaitingTone Проигрывать звуковой сигнал при входящем вызове на вторую линию
ShowSipNameInCallHistoryWindow Показывать имя учетной записи sip-аккаунта в окне Журнал звонков
EnableLocalAccount 0 Создается локальный аккаунт (Позволяет совершать звонки, если у вас нет SIP сервера и SIP аккаунта. В таком случае вы сможете использовать ip как номер телефона)
SoundEvents 1 Активация звуков нажатия кнопок набора, звука после сброса вызова и др.
ReloadSipOnNetworkChanged 1 Обновление параметров подключения и перерегистрация SIP учетных записей при смене сети, например, с проводной на Wi-Fi. Работает только на ОС Windows
SendEndOfCallStatistics 0 Отправлять на SIP-сервер диагностическую информацию в сообщении BYE. Подробности в статье
DisplayBlfContactsFirst 1 Отображать контакты с включенной функцией BLF вверху списка контактов
RecordType Stereo Тип записи разговора. Возможные значения: Stereo, Mono. Подробности в статье
RecordExtension Mp3 Формат записи разговора. Возможные значения: Wav, Mp3. Подробности в статье
ClickToCallHeader Заголовок в сообщении INVITE, по которому софтфон может распознать исходящий звонок из сторонней системы. Подробности в статье
MessagingEnabled 1 Включить отправку сообщений. Подробности в статье
MessagingProtocol Sip Протокол отправки сообщений. Возможные значения: Sip, HttpApi
MessagingHttpApiUrl http://example.com Софтфон отправит сообщение на указанную ссылку в запросе, если используется протокол отправки сообщений HttpApi
MessagingHttpApiSecurityToken Токен в заголовке сообщения, отправленного через HttpApi
MessageMaximumLength 200 Максимальное число символов в сообщении
MaxNumberStoredMessages 100 Количество сообщений, которые сохраняются в приложении
HideCallerIDForInboundCalls 0 Скрывать номер при входящих звонках. Подробности в статье
HiddenCallerIDTemplate XX-XX-XX Текст, который показывается вместо номера, если включено скрытие номеров при входящих звонках
HidIntegrationDevice Disabled Вид гарнитур, с которой включена интеграция. Возможные значения: Disabled (интеграция с гарнитурами выключена), Jabra, Plantronics, Leitner, Yealink.

Раздел [SipAccount]

Для каждой SIP учетной записи в SoftphonePro.ini необходимо определить отдельный раздел [SipAccount].

Каждый раздел должен иметь уникальное название, состоящее из названия раздела и его порядкового номера, например: [SipAccount1], [SipAccount2], [SipAccount3].

В конфигурационном файле не может быть нескольких разделов [SipAccount] с одинаковыми названиями.

Параметр Значение по умолчанию Описание
RegisterOnStartup 1 Регистрировать учетную запись при старте Softphone.Pro
Name Название SIP учетной записи, отображаемое в интерфейсе приложения Softphone.Pro
Server 0 Имя\IP адрес и порт SIP сервера. Порт по умолчанию 5060
Proxy Имя\IP адрес и порт прокси сервера
Domain Домен
AuthId Авторизационное имя пользователя
Username Имя пользователя
Password Пароль для авторизации
DisplayName Отображаемое имя пользователя
PublicAddress Публичный IP адрес
LocalPort Локальный SIP порт
RegisterTimeout 300 Таймаут SIP регистрации, сек.
SRTP None Шифрование медиа
Transport Auto Транспорт
CallTransferMode Sip Метод перевода звонков. Возможные значения: Sip - метод SIP REFER, Dtmf - DTMF сигнал
CallTransferSipMethod TransferNow Вид перевода, выбранный по умолчанию в окне Перевод звонка, если используется SIP перевод. Возможные значения: TransferNow - перевод без консультации, CallFirst - перевод с консультацией
CallTransferDTMF Суффикс и префикс для DTMF команды перевода звонка, разделенные знаком пробел
CallPickupDTMF Перехват звонка DTMF. Подробности в статье
PublishPresence 0 Публиковать состояние пользователя (presence indication)
RtpPortStart Начальное значение интервала локальных RTP портов
RtpPortEnd Конечное значение интервала локальных RTP портов
FirewallTraversalMethod STUN Метод обхода брандмауэра
Возможные значения:
ICE
STUN
LOCAL
AllowIpRewrite 0 Разрешить перезапись IP
IsDefault Аккаунт по умолчанию, выбранный в поле Набрать через
KeepAliveTimeout 15 SIP keep-alive таймаут, сек.
RingingSound Мелодия звонка для SIP учетной записи (Пример: C:/Users/.../custom.wav)
SipId Идентификатор SIP учётной записи. Используется для автоматического выбора SIP учётной записи при совершении исходящего звонка. Подробности в статье.
CallDialingExpression Выражение, которое позволяет модифицировать номер перед исходящим звонком. Примеры выражений и подробности в статье

Раздел [ContactAccount]

Для каждой телефонной книги в SoftphonePro.ini необходимо определить отдельный раздел [ContactAccount].

Каждый раздел должен иметь уникальное название, состоящее из названия раздела и его порядкового номера, например: [ContactAccount1], [ContactAccount2], [ContactAccount3].

В конфигурационном файле не может быть нескольких разделов [ContactAccount] с одинаковыми названиями.


Подключение телефонной книги Google Contacts

Softphone.Pro может загружать и отображать в своей телефонной книге список контактов из аккаунта Google Contacts. Вы не можете изменять в Softphone.Pro контактные данные людей, загруженых из Google Contacts.

Параметр Значение по умолчанию Описание
ContactType GoogleContacts Тип телефонной книги
Enabled 1 Включение/выключении интеграции
Name Название книги
UpdateTimeout Частота обновления
AccessToken Токен доступа (если требуется)
AccessTokenExpiration Истечение токена (если требуется)
TokenType Тип токена для отправки в HTTP запросе (обычно TokenType=Bearer)
RefreshToken Токен, с помощью которого обновляется временный AccessToken
UseForTransfer Использовать для перевода звонков
UseForPresense получать информацию о состоянии абонента
PresenceSipAccount Аккаунт для получения информации о состоянии абонента
MaxDownloadedContactsCount 25 Количество контактов, получаемых за один запрос при синхронизации с Google контактами. Поддерживается в Softphone.Pro 4.7.


Подключение внешней телефонной книги в XML формате Cisco, Yealink

Softphone.Pro может загружать и отображать в своей телефонной книге список контактов из XML файла.

Скачать пример XML файла в формате Cisco, Yealink

Параметр Значение по умолчанию Описание
ContactType CiscoXml Тип телефонной книги
Enabled 1 Включение/выключении интеграции
Name Название книги
UpdateTimeout Частота обновления
Location Полный путь до файла XML
UseForTransfer Использовать для перевода звонков
UseForPresense получать информацию о состоянии абонента
PresenceSipAccount Аккаунт для получения информации о состоянии абонента

Раздел [CrmAccount]

Для каждой CRM в SoftphonePro.ini необходимо определить отдельный раздел [CrmAccount].

Каждый раздел должен иметь уникальное название, состоящее из названия раздела и его порядкового номера, например: [CrmAccount1], [CrmAccount2], [CrmAccount3].

В конфигурационном файле не может быть нескольких разделов [CrmAccount] с одинаковыми названиями.

Параметр Значение по умолчанию Описание
CrmType AmoCRM Тип CRM
Enabled 0 Включение/выключение интеграции
Server amocrm.ru Сервер CRM
Account Аккаунт компании
Login Логин (Для интеграций с авторизацией по OAuth 2.0 данный параметр содержит один из токенов)
Password Пароль (Для интеграций с авторизацией по OAuth 2.0 данный параметр содержит один из токенов)
DigitsCount 7 Количество цифр для определения номера
MaxDigitsCount 20 Максимальное количество цифр для определения номера

Раздел [SimpleCallsAccount]

Раздел SimpleCallsAccount предназначен для настройки интеграции с "Простые звонки".

Параметр Значение по умолчанию Описание
SendAccountNumber 0 Передавать название аккаунта в качестве входящей линии
AllowOutgoingCalls 1 Разрешить исходящие звонки
ServerName wss://softphone.prostiezvonki.ru:443 Имя сервера
ServerPassword Пароль
InnerPhoneNumber Внутренний номер телефона
RecordServer http://rec.prostiezvonki.ru/upload_post.php Сервер записи
ReconnectTimeoutSec 10 Интервал переподключения в секундах
Guid Guid клиента
LoginUrl Адрес для логина

Раздел [EmailNotifyAccount]

Раздел EmailNotifyAccount предназначен для отправки уведомления о пропущенных звонках по Email.

Для каждого Email в SoftphonePro.ini необходимо определить отдельный раздел [EmailNotifyAccount].

Каждый раздел должен иметь уникальное название, состоящее из названия раздела и его порядкового номера, например: [EmailNotifyAccount1], [EmailNotifyAccount2], [EmailNotifyAccount3].

В конфигурационном файле не может быть нескольких разделов [EmailNotifyAccount] с одинаковыми названиями.

Параметр Значение по умолчанию Описание
Address Email
Enabled 0 Включение/выключении функции

Раздел [ExternalEventReceiver]

Раздел ExternalEventReceiver предназначен для обработки событий.

Для каждого события в SoftphonePro.ini необходимо определить отдельный раздел [ExternalEventReceiver].

Каждый раздел должен иметь уникальное название, состоящее из названия раздела и его порядкового номера, например: [ExternalEventReceiver1], [ExternalEventReceiver2], [ExternalEventReceiver3].

В конфигурационном файле не может быть нескольких разделов [ExternalEventReceiver] с одинаковыми названиями.

Параметр Значение по умолчанию Описание
EventType Тип события

IncomingCallStarted - Начало входящего звонка

IncomingCallAnswered - Ответ на входящий звонок

OutgoingCall - Начало исходящего звонка

CallFinished - Завершение звонка

ACWFinished - Завершение постобработки

StatusChanged - Смена статуса

ButtonClick - Нажатие кнопки
AppType Тип действия

Web - Вызвать web-сервис

Local - Запустить приложение

LocalBrowser - Открыть ссылку в браузере

CallRecordToWeb - Загрузить аудиозапись звонка

VideoRecordToWeb - Загрузка видеозаписи экрана

WebCamImageToWeb - Загрузить фото с веб-камеры
Link Ссылка

Для вызова web-сервиса
Link="http://example.com?event=%EVENT%×tamp=%TIMESTAMP%
&direction=%DIRECTION%&login=%LOGIN%&server=%SERVER%&number=%NUMBER%&
callername=%CALLERNAME%&applogin=%APPLOGIN%&header=%HEADER1%"

Для запуска приложения
Link="C:\\Example\\example.exe -event=%EVENT% -timestamp=%TIMESTAMP%
-direction=%DIRECTION% -login=%LOGIN% -server=%SERVER% -number=%NUMBER%
-callername=%CALLERNAME% -applogin=%APPLOGIN% -header=%HEADER1%"

Для открытия ссылки в браузере
Link="http://example.com?event=%EVENT%×tamp=%TIMESTAMP%&
direction=%DIRECTION%&login=%LOGIN%&server=%SERVER%&number=%NUMBER%&
callername=%CALLERNAME%&applogin=%APPLOGIN%&header=%HEADER1%"

Для постобработки
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%"

Для смены статуса
Link="http://example.com?event=%EVENT%×tamp=%TIMESTAMP%&
number=%NUMBER%&direction=%DIRECTION%
&statusname=%STATUSNAME%&statustype=%STATUSTYPE%"

Для загрузки аудиозаписи звонка
http://example.com/uploadCallRecords/upload.php

Для загрузки видеозаписи
Link=http://example.com/uploadScreenRecords/upload.php

Для загрузки фото с веб-камеры
Link=http://example.com/uploadCameraSnapshot/upload.php

Описание событий

%EVENT% - тип события
%TIMESTAMP% - дата и время события
%DIRECTION% - направление вызова
%LOGIN% - SIP логин акканту
%SERVER% - SIP сервер аккаунта
%NUMBER% - номер другой стороны
%CALLERNAME% - имя другой стороны
%APPLOGIN% - логин пользователя
%HEADER1% - заголовок из SIP INVETE
%DURATION% - продолжительность вызова
%RECORD% - ссылка на аудиозапись
%APPLOGIN% - логин пользователя
%RECORDFILENAME% - имя файла аудиозаписи
%VIDEORECORDFILENAME% - имя файла видеозаписи экрана
%ACW_DURATION% - длительность постобработки в секундах
%ACW_TAG% - тег звонка
%ACW_REMINDER% - напоминание в формате UNIX timestamp
%ACW_NOTES% - комментарий
%STATUSNAME% - имя статуса
%STATUSTUPE% - тип статуса
InputName Атрибут name тега <input> (Поле появляется в GUI, если выбрать событие Завершение звонка и действие Загрузить аудиозапись звонка (или видеозапись))
Title Название обработчика нажатия на кнопку. Подробности в статье.
PeriodicalSendPhoneStatusEnabled 0 Активация периодической отправки статуса оператора
PeriodicalSendPhoneStatusIntervalSec 10 Период отправки в секундах
SipAccount 0 ID SIP аккаунта, для которого срабатывает обработчик

Раздел [CallForwardAccount]

Раздел CallForwardAccount предназначен для настройки переадресации вызовов.

Для каждого номера для переадресации в SoftphonePro.ini необходимо определить отдельный раздел [CallForwardAccount].

Каждый раздел должен иметь уникальное название, состоящее из названия раздела и его порядкового номера, например: [CallForwardAccount1], [CallForwardAccount2], [CallForwardAccount3].

В конфигурационном файле не может быть нескольких разделов [CallForwardAccount] с одинаковыми названиями.

Параметр Значение по умолчанию Описание
Enabled 0 Включение/выключение функции
Number Номер
WaitTimeoutSec Переадресация при отсутствии ответа в течении WaitTimeoutSec секунд

Раздел [PrerecordedAudioFile]

Раздел PrerecordedAudioFile предназначен для настройки предварительно записанных аудио-сообщений.

Для каждого аудио-сообщения в SoftphonePro.ini необходимо определить отдельный раздел [PrerecordedAudioFile].

Каждый раздел должен иметь уникальное название, состоящее из названия раздела и его порядкового номера, например: [PrerecordedAudioFile1], [PrerecordedAudioFile2], [PrerecordedAudioFile3].

В конфигурационном файле не может быть нескольких разделов [PrerecordedAudioFile] с одинаковыми названиями.

Параметр Значение по умолчанию Описание
Name Название сообщения
Path C:\\...\\message.wav Путь к аудио-сообщению

Раздел [CallTag]

Раздел CallTag предназначен для добавления тегов постобработки.

Для каждого тега в SoftphonePro.ini необходимо определить отдельный раздел [CallTag].

Каждый раздел должен иметь уникальное название, состоящее из названия раздела и его порядкового номера, например: [CallTag1], [CallTag2], [CallTag3].

В конфигурационном файле не может быть нескольких разделов [CallTag] с одинаковыми названиями.

Параметр Значение по умолчанию Описание
Name Название тега

Раздел [CustomStatus]

Раздел CustomStatus предназначен для добавления пользовательских статусов.

Для каждого статуса в SoftphonePro.ini необходимо определить отдельный раздел [CustomStatus].

Каждый раздел должен иметь уникальное название, состоящее из названия раздела и его порядкового номера, например: [CustomStatus1], [CustomStatus2], [CustomStatus3].

В конфигурационном файле не может быть нескольких разделов [CustomStatus] с одинаковыми названиями.

Параметр Значение по умолчанию Описание
Name Имя нового статуса
Status Состояние статуса (Online, Away, NA, Offline)