Общая информация

SIPModule более не поддерживается в современных версиях ПО Delivery.

Вместо него необходимо использовать SipekPhone. Работает, начиная с версии 3.2

Интеграция с АТС позволяет приложению Оператор принимать входящие звонки с определением номера звонящего.

Если номер звонящего присутствует в базе доставки (или в базе R-Keeper CRM, если используется доставка для RK7), будет показана информация по клиенту (ФИО и адрес) с возможностью быстрого открытия карточки клиента для оформления заказа.
Интеграция реализована посредством стороннего приложения SIPModule.exe (далее SIPModule), разработку и поддержку которого осуществляет компания CallSoft.

Для версий Delivery до 3.2.
Приложение "Оператор" взаимодействует с SIPModule через API, тогда как команды SIP-протокола реализованы на уровне SIPModule.

Приложение SIPModule.exe выполняет только функции транспорта для подключения к АТС по SIP- протоколу и не взаимодействует с конечным оборудованием, таким как гарнитура или софтфон!

Состав и дистрибутив системы

В состав системы входят два приложения:

  • SIPModule.exe - основное приложение для взаимодействия с АТС по SIP-протоколу
  • SipModule-HID.exe - утилита для получения идентификатора оборудования (Hardware ID, требуется для лицензирования)

Дистрибутив доступен на FTP ftp://ftp.ucs.ru/Delivery/SIPModule

Лицензирование

Приложение SIPModule защищено программным ключом, который "привязан" к аппаратной конфигурации компьютера.

Важно!

Политика лицензирования SIPModule допускает установку приложения на 5 (пять) разных ПК при приобретении одной лицензии.
Приложение SIPModule должно быть установлено на каждое рабочее место оператора - одновременное подключение нескольких операторов к одному экземпляру SIPModule не реализовано.

Для получения лицензионного ключа необходимо:

  • на компьютере, где планируется установка  SIPModule, запустить утилиту SipModule-HID.exe (далее SipModule-HID)
  • после запуска в поле "Hardware-ID" отобразится текущий идентификатор "железа":
  • сохранить полученный идентификатор и отправить запрос на получение лицензии для SIPModule в коммерческий отдел компании ЮСИЭС
  • в ответ на запрос будет выслан программный ключ sip.lic, который необходимо записать в рабочую директорию приложения SIPModule
Примечание: Если имя полученного файла лицензии отличается от "sip.lic", необходимо переименовать его в sip.lic и скопировать в рабочую директорию приложения SIPModule

Для проверки лицензии необходимо:

  • запустить утилиту SipModule-HID
  • нажать кнопку "LicInfo" и указать пусть к файлу sip.lic
  • в поле "Company" (организация, на которую лицензирована система) и "Expires" (срок действия лицензии) отобразится информация о лицензии:


Настройка

Приложение Оператор

Важно!

Приложение SIPModule должно быть установлено на каждое рабочее место оператора - одновременное подключение нескольких операторов к одному экземпляру SIPModule не реализовано.


Т.к. приложение SIPModule только предоставляет методы доступа (API) к SIP-серверу, все настройки производятся в приложении Оператор, которое в данном случае выступает в роли SIP-клиента.
 
Для настройки необходимо отредактировать конфигурационный файл оператора (Operator.ini для DeliveryRK7 или PD_Operator.ini для DeliveryRK6):

  • в секции [CallerID] включить параметр boUseCallID:
[CallerID] boUseCallID=1 ....
CODE
  • добавить секцию [CallSoftCaller] со следующими параметрами:
[CallSoftCaller] 
/*IP-адрес или хост телефонной станции (SIP-сервера)*/ 
stpbx_IP=sip.operator.ru 

/*порт подключения к АТС*/ 
inpbx_Port=5060 

/*адрес NAT-сервера, если используется*/ 
stpbx_NatIP= 

/*имя пользователя (виртуальный номер) для регистрации на АТС*/ 
stpbx_Login=123 

/*пароль для виртуального номера*/ 
stpbx_Pass=123456 

/*реальный номер, с которым работает оператор через гарнитуру или софтфон*/ 
stpbx_DefRefPhone=345 

/*IP-адрес компьютера, где запущен SIPModule*/ 
stsipM_IP=127.0.0.1 

/*Порт подключения к SIPModule*/ 
insipM_Port=4505
CODE

Виртуальный номер (stpbx_Login) используется приложением Оператор для регистрации на АТС - входящие звонки от клиентов должны перенаправляться на этот номер.
После того, как пользователь принимает входящий звонок в приложении Оператор, происходит переадресация звонка на собственный номер пользователя (stpbx_DefRefPhone) для возможности голосового общения с клиентом. В качестве телефона пользователя (оператора) может использоваться любое решение, совместимое с АТС - аппаратные телефоны, гарнитуры, программные решения (сфотфоны) и т.д.

Приложение SIPModule

Важно

Важно: Приложение SIPModule.exe выполняет только функции транспорта для подключения к АТС по SIP- протоколу и не взаимодействует с конечным оборудованием, таким как гарнитура или софтфон!

Важно

Приложение SIPModule должно быть установлено на каждое рабочее место оператора - одновременное подключение нескольких операторов к одному экземпляру SIPModule не реализовано.

Важно

Важно: Несмотря на возможность запуска нескольких копий SIPModule на одном ПК, работа в таком режиме не является регламентированной и может приводить к неоднозначным результатам.

SIPModule не требует доп. настройки - достаточно запустить приложение и оно готово к работе.
Запуск SIPModule возможен только в режиме desktop - в этом режиме нет графического интерфейса, приложение можно обнаружить только через диспетчер задач.
В Operator.iniдля DeliveryRK7 дополнительно можно прописать запуск приложения SIPModule при старте оператора:

[STARTPROGRAMS]
/*Запуск сторонних программ*/
...
stPrgN=C:\Delivery\Operator\SIPModule.exe
....
DELPHI

Кроме стандартного режиме запуска поддерживается запуск в отладочном режиме - для этого необходимо запустить SIPModule с ключом debug:

SIPModule.exe debug
DELPHI

В режиме отладки SIPModule запускается с графическим интерфейсом, рабочая область приложения разделена на две окна - в верхнем окне логируются команды API, в нижнем - команды SIP-протокола:

 
При необходимости, можно настроить приложение SIPModule на поддержку произвольного порта для входящих подключений (по умолчанию, используется порт 4505) - для этого запустите SIPModule с параметром в командной строке port=<номер порта>, например:

SIPModule.exe port=10125
DELPHI

Возможен запуск приложения с одновременным указанием обоих параметров  port и debug:

SIPModule.exe port=10125 debug
DELPHI

После запуска SIPModule с поддержкой произвольного порта необходимо также изменить значение порта в настройках приложения "Оператор":

[CallSoftCaller]
...

/*Порт подключения к SIPModule*/
insipM_Port=10125
CODE

Проверка подключения к SIPModule 


Для проверки подключения к SIPModule можно использовать утилиту командной строки telnet или любую другую программу, поддерживающую протокол telnet (например, putty)
 
В процессе проверки подключения рекомендуется запускать SIPModule в режиме отладки - в таком случае команды подключения будут отображаться в окне SIPModule.
 
Для подключения необходимо в командной строке Windows набрать команду:

telnet <IP-адрес><ПРОБЕЛ><Порт>
CODE

где

  • <IP-адрес> - IP-адрес хоста, где запущен SIPModule 
  • <Порт> - порт  SIPModule (по-умолчанию 4505)

Например:

telnet 127.0.0.1 4505
CODE

В случае успешного подключения в командной строке появится ответ от  SIPModule:

{"Event":"AppInfo","Name":"SIPModule","Version":"2.0.0.3"}
CODE
Примечание: По умолчанию Telnet не устанавливается вместе с Windows -  как включить см. справку http://windows.microsoft.com/ru-ru/windows/telnet-faq#

Поддерживаемые решения для SIP-телефонии

На данный момент проверены на совместимость с SIPModule следующие решения для SIP-телефонии: