Практическое использование

1С-Рарус:Интеграция с телефонией (СофтФон),

редакция 3
в решениях
1С:CRM, редакция 2
 ВАЖНО!!!
Данная методичка предназначена для практической работы
пользователей при использовании решения 1С-Рарус:Интеграция
с телефонией (СофтФон), редакция 3.0 в решениях 1С:CRM,
редакция 2.0 не ниже релиза 2.0.9.
Получить дистрибутив решения 1С-Рарус:Интеграция с
телефонией(СофтФон), редакция 3.0 можно скачав его на сайте
компании-разработчика ССЫЛКА_НА_ДИСТРИБУТИВ
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯

В данной методичке описан порядок настройки решения

«1С-Рарус:Интеграция с телефонией(СофтФон), редакция 3.0» для
корректной работы в решениях «1С:CRM, редакция 2.0». Также в
методичке приведены рекомендации на наиболее часто
встречающиеся вопросы при работе с этими решениями (в том числе
технического характера).

__________________________________________________
ВАЖНО!!!
Данная методичка является дополнением к руководствам
пользователя для решений «1С-Рарус:Интеграция с
телефонией(СофтФон), редакция 3.0» и «1С:CRM, редакция 2.0»

2
 ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯

Оглавление
ОПИСАНИЕ ДИСТРИБУТИВА «1С-РАРУС:ИНТЕГРАЦИЯ С ТЕЛЕФОНИЕЙ
(СОФТФОН) 3» ................................................................................................. 4
РЕКОМЕНДАЦИИ ПО УСТАНОВКЕ И НАСТРОЙКЕ СЕРВЕРНОЙ ЧАСТИ «1С-
РАРУС:ИНТЕГРАЦИЯ С ТЕЛЕФОНИЕЙ(СОФТФОН) 3» ....................................... 5
Рекомендации по установке ...................................................................... 7
Рекомендации по настройке...................................................................... 9
Подключение модуля Infinity/Agat UX ..................................................... 11
ПАНЕЛЬ УПРАВЛЕНИЯ «1С-РАРУС:ИНТЕГРАЦИЯ С ТЕЛЕОФНИЕЙ(СОФТФОН)
3» .................................................................................................................... 13
ПОДКЛЮЧЕНИЕ СИСТЕМЫ ЗАПИСИ ТЕЛЕФОННЫХ ПЕРЕГОВОРОВ СПРУТ-7 .. 14
ОСОБЕННОСТИ РАБОТЫ В КОНФИГУРАЦИЯХ НА ПЛАТФОРМЕ
1С:ПРЕДПРИЯТИЕ 8 СОВМЕСТНО С «1С-РАРУС:ИНТЕГРАЦИЯ С
ТЕЛЕФОНИЕЙ(СОФТФОН) 3.0» ....................................................................... 19
НАИБОЛЕЕ ЧАСТО ВСТРЕЧАЮЩИЕСЯ ВОПРОСЫ И ОТВЕТЫ НА НИХ .............. 21

3
Описание дистрибутива «1С-
Рарус:Интеграция с телефонией
(СофтФон) 3»

«1С-Рарус:Интеграция с телефонией (СофтФон) 3» состоит из

следующих частей:
 сервер «1С-Рарус:Интеграция с телефонией (СофтФон) 3»
(установочный файл Setup.exe)

 Панель управления «1С-Рарус:Интеграция с телефонией

(СофтФон) 3» (установочный файл SetupClient.exe)

 шаблон конфигурации на платформе 1С:Предприятие 8,

содержащий функционал для работы с сервером «1С-
Рарус:Интеграция с телефонией (СофтФон) 3». В случае
использования с решениями «1С:CRM» версий СТАНДАРТ,
ПРОФ и КОРП все компоненты, необходимые для работы
решения уже встроены в конфигурацию «1С:CRM»

4
Рекомендации по установке и
настройке серверной части «1С-
Рарус:Интеграция с
телефонией(СофтФон) 3»
Сервер «1С-Рарус:Интеграция с телефонией (СофтФон) 3» состоит
из следующих программных частей, необходимость установки
которых указывается в процессе установке сервера «1С-
Рарус:Интеграция с телефонией (СофтФон) 3»:

Рисунок № 1 «Форма мастера установки решения»

 сервер «1С-Рарус:Интеграция с телефонией (СофтФон) 3»

– после установки запускается как служба, устанавливает
связь со службой «Телефония» ОС Windows. При помощи

5
 этой службы сервера взаимодействует с АТС,
подключенной к данному компьютеру через TAPI-драйвер;

 менеджер сервера – программа для настройки сервера «1С-

Рарус:Интеграция с телефонией (СофтФон) 3.0», может
также быть установлен отдельно на компьютере, на котором
не установлен сервер «1С-Рарус:Интеграция с телефонией
(СофтФон) 3.0» и подключаться к серверу «1С-
Рарус:Интеграция с телефонией (СофтФон) 3.0» по сети;

 модуль подключения к АТС Asteriks – после установки

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

 модуль подключения к АТС Агат или Инфинити – после

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

 Модуль записи разговоров Спрут-7 – после установки

запускается как служба, параметры подключения к серверу
Спрут-7 настраиваются в менеджере сервера.

Сервер «1С-Рарус:Интеграция с телефонией (СофтФон) 3.0»

устанавливается по умолчанию в следующие папки:

6
  в c:\Program Files\1С-Рарус\1С-Рарус Интеграция с
телефонией устанавливается сервер «1С-Рарус:Интеграция
с телефонией (СофтФон) 3.0» и его компоненты;
 в c:\Users\All Users\1C-Rarus SoftPhone файлы настроек и
прочие служебные файлы.

Рекомендации по установке

 Для установки сервера «1С-Рарус:Интеграция с телефонией

(СофтФон) 3.0» требуются права «Администратора» на
персональной станции на которой происходит установка.

 После установки сервер «1С-Рарус:Интеграция с телефонией

(СофтФон) 3.0» необходимо настроить его на работу с АТС, для
этого необходимо запустить менеджер сервера.

 Если при установке сервера «1С-Рарус:Интеграция с

телефонией (СофтФон) 3.0» были установлены модули
подключения к АТС, то на странице «Линии и модули АТС»
нужно заполнить настройки модулей подключения к АТС.

 В случае работы с АТС через TAPI-драйвер настройки

подключения к АТС производятся через интерфейс самого
драйвера или настройки TAPI-драйвера можно настроить через
панель управления («Телефон и модем» закладка
«Дополнительно»).

 После установки связи с АТС необходимо в группе «Настройка

телефонных линий» отметить те линии, звонки по которым

7
 будут обрабатываться сервером «1С-Рарус:Интеграция с
телефонией (СофтФон) 3.0». Выбранные линии в дальнейшем
будут доступны для выбора в списке линий, получаемых с
сервера «1С-Рарус:Интеграция с телефонией (СофтФон) 3.0» в
Панели управления.

 Зеленый цвет значка линии означает доступность для

управления сервером «1С-Рарус:Интеграция с телефонией
(СофтФон) 3.0», т.е. сервер «1С-Рарус:Интеграция с
телефонией (СофтФон) 3.0» сможет совершать звонки по
данной линии, и что данная линия в настоящее время
свободна (по ней не совершается звонок)

 Красный цвет значка линии также означает доступность для

управления сервером «1С-Рарус:Интеграция с телефонией
(СофтФон) 3.0», и что по данной линии в настоящее время
совершается звонок

 Серый цвет значка линии также означает, доступность

линии, и что в настоящее время к линии никто не подключен

 Отсутствие значка у линии означает, что линия не может

управляться сервером «1С-Рарус:Интеграция с телефонией
(СофтФон) 3.0».
 Если отсутствуют значки у всех линий и «1С-
Рарус:Интеграция с телефонией (СофтФон) 3.0» работает с
АТС по ее TAPI-драйверу - это значит, что TAPI-драйвер АТС не
позволяет управлять данными линиями и требуется обратиться в
службу техподдержки производителя АТС для решения данной
проблемы (проблема может заключаться в лицензии, прошивке
АТС, TAPI-драйвере, настройке АТС для возможности работы
через TAPI драйвер).

8
 Рекомендации по настройке

 На странице «Настройка сервера» необходимо заполнить поля в

группе «Префиксы АТС и внутренние настройки сервера».
Значения, заданные в полях префиксов, влияют на
формирование полного телефонного номера, который
передается сервером «1С-Рарус:Интеграция с телефонией
(СофтФон) 3.0» в АТС для совершения исходящего звонка.

 При использовании Панели управления, передаваемый в сервер

«1С-Рарус:Интеграция с телефонией (СофтФон) 3.0»
телефонный номер не должен содержать этих префиксов, так как
они автоматически добавляются сервером «1С-
Рарус:Интеграция с телефонией (СофтФон) 3.0».

 Значение поля «Максимальная длина внутренних номеров»

позволяет определить по номеру телефона является ли данный
звонок внутренним (т.е. звонком внутри АТС). В зависимости от
этого определяется необходимо ли добавлять к данному номеру
префиксы при звонке на него.
 Значение поля «Последние цифры телефонного номера»
устанавливает количество цифр справа в телефонном номере,
которые будут храниться в регистре поиска контактов по номеру
телефона. Рекомендуется устанавливать данное значение не
меньше 10, чтобы в регистре поиска не было повторяющихся
номеров.

 Сервер «1С-Рарус:Интеграция с телефонией (СофтФон) 3.0»

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

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

 Если к серверу «1С-Рарус:Интеграция с телефонией

(СофтФон) 3.0» никто не подключен, то самое первое
подключение использует бесплатную лицензию. Но если к
серверу «1С-Рарус:Интеграция с телефонией (СофтФон)
3.0» подключен хотя бы один клиент, то всегда используется
сначала платная лицензия. Даже при повторном
подключении клиента, который раньше был подключен под
бесплатной лицензией.

 В сумме же всех возможных подключений к серверу «1С-

Рарус:Интеграция с телефонией (СофтФон) 3.0» они
рассчитываются, как количество платных клиентских
лицензий + 1.

 Количество используемых платных клиентских лицензий можно

увидеть в менеджере сервера на странице «Лицензирование», а
подключенных клиентов на странице «Монитор»
 В случае сбоя в работе сервера «1С-Рарус:Интеграция с
телефонией (СофтФон) 3.0» необходимо перегрузить службу
«Телефония» Windows. В процессе ее перезагрузки будут
перезагружены:

 сервер «1С-Рарус:Интеграция с телефонией (СофтФон)

3.0»

 все подчиненные службы серверу «1С-Рарус:Интеграция с

телефонией (СофтФон) 3.0»

 все TAPI-драйвера АТС, если они были установлены.

10
 Подключение модуля Infinity/Agat
UX

Настройки для Infinity/Agat UX модуля включают:

 Тип АТС - возможные значения: «0» - IP Call-центр Infinity,
«1» - IP АТС «Агат UX».
 Параметры подключения к Infinity – параметры
подключения к АТС IP Call-центру Infinity или «Агат UX»;
строка формата сервер:порт, например, 127.0.0.1:10020.
 Файл настроек подключения к Агат UX – название файла
настроек, который должен быть расположен на компьютере,
где установлен модуль работы с Infinity/Agat UX. Данный
параметр нужно указывать при выборе типа АТС в значение
«1» (IP АТС «Агат UX»). Файл генерируется при первой
попытке подключения к АТС и в нем указаны настройки
необходимые для подключения к IP АТС Агат UX. Пример
настроек из файла показан ниже:
[devlist]
count = 1

[device-0]
name = 200
addr = 192.168.53.139
port = 8081
login = admin
password = admin
timeout = 10
disable = 0
codeclist = 711a; 711u; 729; 723a; 723m;

[general]
basertp = 9000

[debug]
mode = 2

11
 level = 10
filename = tspiux.log

Для подключения к АТС необходимо обязательно указать

следующие значения:
 addr - ip-адрес для подключения к IP АТС Агат UX
 port - порт подключения к IP АТС Агат UX
 login - логин администратора для подключения к IP АТС
Агат UX
 password - пароль администратора для подключения к IP
АТС Агат UX
Остальные настройки необходимо установить, как показано в
примере, для задания их значений по умолчанию. Более подробную
информацию о настройках можно получить на линии технической
поддержки IP АТС Агат UX.

Размещение файла для операционной системы Windows 7, это

путь C:\ProgramData\1C-Rarus SoftPhone, для операционной системы
Windows XP это путь C:\Documents and setings\All users\Aplication
data\1C-Rarus SoftPhone.

 Флаг AlwaysKeepConnection – необходимо указать значение

«0»
 Включить лог обмена с Infinity – возможные значения «0» -
не вести лог, «1» - вести лог обмена. Сам файл лога обмена
находится в папке …

Ограничение размера лога обмена с Infinity/Агат UX, Мб –

возможные значения: «0» без ограничений, иначе размер файла в
Мб. При достижении максимального размера к названию файлу
добавляется «_tmp» и дальнейший лог будет вестись в новом файле.

Важно! В случае, если файл настроек найти не получается (был

по каким-то причинам не создан) необходимо в форме настроек
модуля изменить параметр «Ограничение обмена лога обмена» на

12
любое другое значение от введенного и сохранить изменения. В
этом случае файл настроек будет создан снова автоматически.

Панель управления «1С-

Рарус:Интеграция с
телеофнией(СофтФон) 3»

 Панель управления «1С-Рарус:Интеграция с телефонией

(СофтФон) 3.0» является независимым приложением
Windows и устанавливается в те же каталоги, что и сервер
«1С-Рарус:Интеграция с телефонией (СофтФон) 3.0».
 При начале работы внешняя панель требует подключения к
серверу «1С-Рарус:Интеграция с телефонией (СофтФон)
3.0» для получения клиентской лицензии.
 Так как внешняя панель содержит в себе встроенный SIP-
клиент, она может подключаться не только к линиям тех
АТС, к которым подключен сервер «1С-Рарус:Интеграция с
телефонией (СофтФон) 3.0», но также и к SIP-линии любой
другой SIP-АТС, к которой может подключиться ее
встроенный SIP-клиент.

 Внешняя панель закрывается только из своего значка в

системной панели, а при нажатии кнопки «Закрыть» на
форме только сворачивается в системную панель. В
свернутом состоянии панель продолжает свою работу,
выводя информацию о звонках в виде баннера.

13
 Подключение системы записи
телефонных переговоров Спрут-7

 Установите систему записи телефонных переговоров Спрут-7 и

настройте работу с ней в АТС.

 Откройте на компьютере, на котором установлена система

Спрут-7 порт 25000.
 Запустите установку сервера «1С-Рарус:Интеграция с
телефонией (СофтФон) 3.0» и отметьте пункт «Модуль записи
разговоров Sprut».

Рисунок № 2 «Форма мастера установки решения»

14
 После установки откройте менеджер сервера «1С-
Рарус:Интеграция с телефонией (СофтФон) 3.0» и на странице
«Линии и модули АТС» в группе «Модули, подключенные к
серверу «1С-Рарус:Интеграция с телефонией (СофтФон) 3.0»
откройте настройки модуля «Sprut модуль» и заполните
параметры подключения к Спрут-7.

Рисунок № 3 «Форма модуля настройки СПРУТ7»

 Откройте конфигурацию «1С:CRM 2.0», выберите в

«Настройках системы» вкладку «СофтФон» и установите
флажки «Использовать запись переговоров» и «Использовать
систему Спрут-7».

15
 Рисунок № 4 «Форма настройки интеграции с 1С-Рарус:Софтфон»

 Перейдите на страницу «Префиксы, настройки» и в группе

«Правила записи телефонных переговоров» нажмите на ссылку
«Настроить правила записи телефонных переговоров».
 В форме регистра «Правила записи телефонных
переговоров» указать правила, согласно которым в 1С будет
фиксироваться факт записи телефонного разговора (для

16
 начала работы системы записи необходимо наличие хотя бы
одного правила).

Рисунок № 5 «Форма настройки правил записей разговоров»

 Также необходимо через форму списка пользователей для

каждого пользователя указать, записи телефонных переговоров
каких пользователей он может прослушивать.

17
 Рисунок № 6 «Форма настройки доступа к записям разговоров»

 При ответе на внешний входящий телефонный звонок в регистре

сведений «Записи телефонных переговоров» будет информация
о записи данного телефонного разговора.

Рисунок № 7 «Список записей разговоров в 1С»

 Записанный телефонный разговор можно будет прослушать или

из формы регистра, или из документа «Событие», при условии,
что он будет создан для данного телефонного разговора.

18
 Рисунок № 8 «Прослушивание записи разговора из События»

Особенности работы в
конфигурациях на платформе
1С:Предприятие 8 совместно с «1С-
Рарус:Интеграция с
телефонией(СофтФон) 3.0»
 Функционал по работе с сервером «1С-Рарус:Интеграция с
телефонией (СофтФон) 3.0» является частью конфигурации
«1С:CRM 2.0» и полностью содержится в ней.

 Также существует отдельная конфигурация, предназначенная

для встраивания в произвольные конфигурации на платформе
1С:Предприятие 8.2 в режиме управляемого приложения.
Данная конфигурация представляет собой часть конфигурации
«1С:CRM 2.0», с изменениями, предназначенными для
обеспечения возможности встраивания.

19
 В конфигурациях содержится кроме функционала работы с
Панелью управления «1С-Рарус:Интеграция с телефонией
(СофтФон) 3.0», также функционал для работы с еще одной
панелью – панелью «1С-Рарус:Интеграция с телефонией
(СофтФон) 3.0», которая представляет собой форму
разработанную на платформе 1С:Предприятие 8 и по
функционалу почти идентична Панели управления.

 Внутренняя панель «1С-Рарус:Интеграция с телефонией

(СофтФон) 3.0» может быть использована только при
работе 1С.

 Так как внешняя панель «1С-Рарус:Интеграция с

телефонией (СофтФон) 3.0» содержит все настройки в себе,
то почти все настройки в конфигурации на платформе
1С:Предприятие 8 относятся к настройкам внутренней
панели.
 Настройки в конфигурациях разделены на две группы:

 Общие настройки «1С-Рарус:Интеграция с телефонией

(СофтФон) 3.0»

 Настройки «1С-Рарус:Интеграция с телефонией

(СофтФон) 3.0» в персональных настройках пользователя

 Общие настройки «1С-Рарус:Интеграция с телефонией

(СофтФон) 3.0» определяют использование функционала «1С-
Рарус:СофтФон 2.0» в программе. Часть этих настроек
загружается с сервера «1С-Рарус:Интеграция с телефонией
(СофтФон) 3.0» при подключении к нему.

 Настройки «1С-Рарус:Интеграция с телефонией (СофтФон)

3.0» в персональных настройках пользователя определяют

20
 использование «1С-Рарус:Интеграция с телефонией
(СофтФон) 3.0» конкретным пользователем. В частности, с
какой панелью он работает, и если выбрана внутренняя панель,
то ее настройки и поведение панели при событиях «1С-
Рарус:Интеграция с телефонией (СофтФон) 3.0».

 В персональных настройках пользователя есть две настройки

«Создавать документ Событие при снятии трубки (входящий
звонок)» и «Создавать документ Событие при снятии трубки
(исходящий звонок)», которые отвечают за автоматическое
создание документа фиксирующего факт звонка.

 Документ автоматически создается только для внешних

звонков, а внешний или внутренний звонок определяется по
длине номера и значению настройки «Максимальная длина
внутренних номеров», установленному в настройках сервера
«1С-Рарус:Интеграция с телефонией (СофтФон) 3.0»
(длина номера внешнего звонка должна превышать значение
настройки).

Наиболее часто встречающиеся

вопросы и ответы на них

Вопрос:
Настроил БД в менеджере сервера «1С-Рарус:Интеграция с
телефонией (СофтФон) 3.0», как написано в инструкции. Менеджер
сервера «1С-Рарус:Интеграция с телефонией (СофтФон) 3.0»
подключается к базе данных, но в саму базу данных никакой
истории звонков не пишется. В чем может быть проблема?

Ответ:

21
При настройке способа авторизации MS SQL Server нужно
указывать логин и пароль (т.е. убрать
галочку "Авторизация Windows") либо давать учетной записи
"system", от которой работает служба сервера «1С-
Рарус:Интеграция с телефонией (СофтФон) 3.0» доступ к MS SQL
серверу, либо запускать службу сервера «1С-Рарус:Интеграция с
телефонией (СофтФон) 3.0» от конкретного пользователя.

Вопрос:
Создал правила записи телефонных переговоров (на скриншоте) и
после записи события все равно не получается прослушать, выдает
ту же самую ошибку "Ошибка копирования файла. Ни одна из
служб доступа к сети не смогла обработать заданный сетевой путь".

Ответ (общие правила):

Для прослушивания записей разговоров в конфигурациях,

использующих подсистему «1С-Рарус:Интеграция с телефонией
(СофтФон) 3.0» необходимо:
1) Чтобы внешние системы записи телефонных переговоров
(Спрут-7, CLON или Asteriks) были установлены и
настроены на работу с сервером «1С-Рарус:Интеграция с
телефонией (СофтФон) 3.0».
Настройки доступа к системе CLON указываются в
настройках подсистемы 1С-Рарус:СофтФон в
конфигурации.
2) В конфигурации должны быть созданы правила записи
телефонных разговоров. Привязка записи телефонных
разговоров из внешних систем к документам "Событие"
будет происходить автоматически при выполнении условий
правил записи.

22
 3) Должны быть указаны для каждого пользователя,
который будет прослушивать записи телефонных
переговоров, пользователи, записи разговоров которых он
может прослушивать (по умолчанию только свои).
4) При телефонном звонке должны создаваться документы
"Событие", через которые происходит привязка записи
телефонного разговора из внешних систем к телефонному
разговору, зафиксированному в программе. У пользователя
имеется возможность указать создание События
автоматически в настройках пользователя.

Ответ (с учетом особенностей работы с IP АТС Asteriks):

В настройках модуля подключения к АТС Астериск указывается

каталог, в котором расположены файлы записи разговоров, данный
каталог должен быть доступен для доступа с компьютера, на
котором установлен сервер «1С-Рарус:Интеграция с телефонией
(СофтФон) 3.0» на чтение.

На компьютере, на котором установлен Астериск, нужно

«расшарить» этот каталог. Для проверки, по настройкам модуля
Астериск "Каталог расположения файлов записи разговоров",
"Логин для доступа...", "Пароль для доступа..." должна быть
возможность зайти в этот каталог с помощью проводника
операционной системы Windows.

Вопрос:

Можно как-нибудь проверить, установилась ли связь «1С-

Рарус:Интеграция с телефонией (СофтФон) 3.0» с системой записи
разговоров Спрут-7?

Ответ:

23
Можно проверить, через утилиту Dashboard от компании Агат РТ.
Видео урок по настройке работы системы записи разговоров
СПРУТ-7 находится на сайте разработчика
http://www.agatrt.ru/support/technical_support/Videos/ (Правила
настройки IP-АТС «АГАТ UX» и системы записи «Спрут-7/UX»).

Но лучше проверить через 1С:Предприятие. В форме обработки

«СофтФон» есть функция "OnRecordInfo" в нее приходят
оповещения от сервера «1С-Рарус:Интеграция с телефонией
(СофтФон) 3.0» по записи разговоров. Если нет оповещений, значит
связь с сервером записи не работает. Проверить получение данных
от можно в режиме конфигуратора с точной останова в функции
"OnRecordInfo".

24