Конфигурационный файл 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 Показывать окно Мини-окно управления звонком
MainWindowOnIncomingAnswer 1 Выводить на передний план главное окно при входящем звонке
MainWindowOnOutgoing 1 Выводить на передний план главное окно при исходящем звонке
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, speex/16000/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 403 Положение главного окна по оси X
MainWindowY 244 Положение главного окна по оси Y
ActiveCallsWindowX 766 Положение окна Активные звонки по оси X
ActiveCallsWindowY 244 Положение окна Активные звонки по оси Y
ContactsWindowX 1129 Положение окна Контакты по оси X
ContactsWindowY 244 Положение окна Контакты по оси Y
CallHistoryWindowX 1492 Положение окна Журнал звонков по оси X
CallHistoryWindowY 244 Положение окна Журнал звонков по оси Y
FloatingWindowX 704 Положение окна Мини-окно управления звонком по оси X
FloatingWindowY 484 Положение окна Мини-окно управления звонком по оси Y
PostProcessingWindowX 860 Положение окна Постобработка по оси X
PostProcessingWindowY 470 Положение окна Постобработка по оси Y
Language Russian Язык интерфейса
AnswerShortcutKey Горячие клавиши для ответа на входящий звонок
HangupShortcutKey Горячие клавиши для сброса звонка
IgnoreShortcutKey Горячие клавиши для игнорирования звонка
FixRecording 0 Повторно инициализирует запись звонка при изменениях медиа-сессии. Примените этот параметр, если на записи звонка слышно только одного собеседника
DisableSessionTimers 0 Отключение сессионных таймеров. Примените этот параметр, если ваши звонки прерываются через ХХ минут
JabraHeadsetIntegration 0 Поддержка гарнитур Jabra
PlantronicsHeadsetIntegration 0 Поддержка гарнитур Plantronics
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 серверов через пробел
ACWReminderEnabled 0 Активация поля напоминания в окне Постобработка
ACWNotesEnabled 0 Активация поля комментария в окне Постобработка
ACWMinimumCallDuration 0 Минимальное время звонка (в секундах), при превышении которого будет показываться окно постобработки.
При значении 0 окно постобработки показывается после всех входящих и исходящих звонков.
ForceCodecForIncoming 0 Требование использования определенных кодеков от другой стороны звонка
DenyIncoming 0 Разрешить входящие только с зарегистрированных доменов
PlayCallWaitingTone Проигрывать звуковой сигнал при входящем вызове на вторую линию
ShowSipNameInCallHistoryWindow Показывать имя учетной записи sip-аккаунта в окне Журнал звонков
EnableLocalAccount 0 Создается локальный аккаунт (Позволяет совершать звонки, если у вас нет SIP сервера и SIP аккаунта. В таком случае вы сможете использовать ip как номер телефона)
SoundEvents 1 Активация звуков нажатия кнопок набора, звука после сброса вызова и др.
ReloadSipOnNetworkChanged 0 Обновление параметров подключения и перерегистрация SIP учетных записей при смене сети, например, с проводной на Wi-Fi. Работает только на ОС Windows.

Раздел [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 сигнал
CallTransferDTMF Суффикс и префикс для DTMF команды перевода звонка, разделенные знаком пробел
CallPickupDTMF Перехват звонка DTMF
PublishPresence 0 Публиковать состояние пользователя (presence indication)
RtpPortStart Начальное значение интервала локальных RTP портов
RtpPortEnd Конечное значение интервала локальных RTP портов
FirewallTraversalMethod ICE Метод обхода брандмауэра
Возможные значения:
ICE
STUN
LOCAL
AllowIpRewrite 0 Разрешить перезапись IP
IsDefault Аккаунт по умолчанию, выбранный в поле Набрать через
KeepAliveTimeout 15 SIP keep-alive таймаут, сек.
RingingSound Мелодия звонка для SIP учетной записи (Пример: C:/Users/.../custom.wav)

Раздел [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 Аккаунт для получения информации о состоянии абонента


Подключение внешней телефонной книги в 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 - Смена статуса
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, если выбрать событие Завершение звонка и действие Загрузить аудиозапись звонка (или видеозапись))
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)