Инструкция по установке и настройке Битрикс24.Randerrandersoft.com/download/B24_manual_12092018.pdf · 2018-09-12 · запросы. В нашем

1

Инструкция по установке и настройке

Битрикс24.Rander

2

Оглавление Назначение Битрикс24.Rander ................................................................................................................................ 3

Общая схема устройства Битрикс24.Rander........................................................................................................... 3

Установка и настройка сервера Rander .................................................................................................................. 4

Установка и настройка Коннектора Битрикс24.Rander ......................................................................................... 5

Настройки доступа в Интернет ................................................................................................................................ 5

Настройка файла settings.ini .................................................................................................................................... 6

Настройка Битрикс24 ............................................................................................................................................... 8

Минимальные системные требования ................................................................................................................ 15

Запуск системной службы Коннектор Битрикс24.Rander ................................................................................... 16

3

Назначение Битрикс24.Rander

ПО Битрикс24.Rander предназначено для обеспечения взаимодействия учрежденческих АТС и Битрикс24

с помощью сервера Rander.

Основная задача Битиркс24.Rander - управлять телефонным аппаратом, подключенным к

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

по внешним и внутренним линиям учрежденческой АТС, не используя телефонию от Битрикс24.

Битиркс24.Rander обеспечивает выполнение следующих сценариев:

1. При получении входящего вызова на телефонный аппарат на экране рабочего места Битрикс24

открывается окно уведомления о входящем вызове и, в случае наличия контактных данных

вызывающего абонента в базе Битрикс24, в этом окне показываются имеющиеся контактные

данные и история звонков.

2. При нажатии кнопки позвонить в базе контактов или любом другом окне Битрикс24, содержащем

возможность выполнить телефонный звонок, АТС производит вызов абонента по указанному в

контакте номеру. В случае системного телефона он сам включится и начнет набирать номер в

громкоговорящем режиме. Если телефон аналоговый или DECT, то телефон получит

предварительный вызов от АТС, после ответа на который выполнится исходящий вызов. Эта

возможность может быть не доступна для SIP телефонов.

3. Абонент снимает трубку на телефоне и совершает исходящий вызов. На экране открывается окно

исходящего вызова. Данные об этом вызове заносятся в базу звонков Битрикс24.

Всегда, когда открыта карточка звонка, имеется возможность внести комментарий к данному звонку в

режиме онлайн или создать лид, сделку или контакт.

Обратите внимание, что Битрикс24 это облачный сервис, в связи с чем время реакции может

зависеть от многих параметров, в том числе от пропускной способности Вашей сети Интернет,

загруженности Битрикс24, задержкам передачи пакетов по сети и потери пакетов и т.д.

Общая схема устройства Битрикс24.Rander

Для функционирования Битиркс24.Rander необходима учрежденческая АТС, поддерживающая функции

CTI по протоколу TAPI.

Функцию CTI сервера выполняет серверное ПО Rander, которое обеспечивает управление всеми линиями

АТС и мониторинг их состояния.

Сервер Rander также имеет программный COM интерфейс для взаимодействия с любыми приложениями

Windows, поддерживающими COM технологию.

В качестве COM интерфейса выступает модуль RanCOM Plus, который выполнен в виде системной COM

библиотеки и позволяет принимать от сервера Rander информацию о событиях в АТС и передавать их

приложению и наоборот, принимать команды управления от приложения и передавать их на сервер

Rander для управления АТС.

Битиркс24.Rander состоит из двух частей:

• Коннектор Битиркс24.Rander, который обычно устанавливается на том же компьютере где

и сервер Rander и является приложением, взаимодействующим с Битрикс24 с одной

стороны и RanCOM с другой.

4

• Приложение Битрикс24.Rander, которое устанавливается в личном кабинете Битрикс24 из

Маркетплейс.

Для функционирования коннектора Битиркс24.Rander необходимы лицензии:

• Rander Server Plus - 1

• RanCOM Plus – 1

• RanCOM Plus Line – 1 на каждый телефон, которым будет управлять Битрикс24.

• Битрикс24.Rander не лицензируется.

Общая схема системы представлена на рисунке ниже.

Установка и настройка сервера Rander

Поскольку без сервера Rander система функционировать не может, прежде всего нужно установить ПО

Rander и убедиться в корректности его работы. Подробнее об этом в инструкции и в видео-роликах на

сайте http://randersoft.com/ru/man.shtml.

После того, как Rander установлен и все исправно функционирует, можно приступать к установке и

настройке Коннектора Битрикс24.Rander.

5

Установка и настройка Коннектора Битрикс24.Rander

Коннектор Битрикс24.Rander это часть ПО, которая устанавливается в сети пользователя. Коннектор

Битрикс24.Rander может устанавливаться на том же компьютере, где установлен сервер Rander или на

любом другом компьютере, имеющем возможность сетевого взаимодействия с сервером Rander и

доступа в Интернет (см. рисунок выше). На данном компьютере должна быть установлена ОС MS Windows

и он должен удовлетворять минимальным системным требованиям.

Дистрибутив Коннектора Битрикс24.Rander необходимо скачать и установить на целевом компьютере.

После успешной установки Коннектора Битрикс24.Rander необходимо выполнить некоторые настройки.

Настройки доступа в Интернет

Для того, чтобы взаимодействие Коннектора Битрикс24.Rander с облаком Битрикс24 было возможно,

необходимо обеспечить ему доступ в Интернет и доставку IP пакетов от Битрикс24 до коннектора

Битрикс24.Rander. Для этого необходимо организовать проброс портов на маршрутизаторе,

обеспечивающем соединение локальной сети с Интернет.

1. Назначаем коннектору уникальный номер порта, например 8182. Если коннектор размещен на

хосте 192.168.0.144, то полный адрес назначения будет http://192.168.0.144:8182

2. В маршрутизаторе создаем запись типа dstnat, которая позволит передавать все пакеты,

приходящие на порт 8182 внешнего статического IP адреса, на внутренний IP адрес коннектора с

тем же номером порта 8182. Пример настроек в роутере Микротик

В нашем примере 178.161.201.110 это внешний статический IP адрес нашего роутера, на который

Битрикс24 будет присылать свои IP пакеты.

6

192.168.0.144 это IP адрес хоста, на котором размещен коннектор.

Настройка файла settings.ini

Коннектор Битрикс24.Rander устанавливается в любую папку, из которой потом и будет запускаться.

Содержание папки представлено ниже.

Для корректной работы необходимо внести данные в файл конфигурации коннектора settings.ini.

Вводим URL коннектора Битрикс24.Rander в локальной сети только с использованием доменного имени.

Используем вместо IP адреса 192.168.0.144 доменное имя, например RanderConnect.ranat.ru.

7

Если хотим, чтобы все журналы сохранялись в файле лога вводим строку saveToLog=true, если нет, то

saveToLog=false.

Вводим URL портала Вашего Битрикс24, на который коннектор Битрикс24.Rander будет отправлять свои

запросы. В нашем случае это ranat.bitrix24.ru.

Далее вводим IP адрес сервера Rander. В нашем случае это 192.168.0.146.

Это справедливо в том случае, если Коннектор Битрикс24.Rander находится не на сервере Rander.

Если коннектор размещен на сервере Rander, то в качестве IP адреса сервера указываем адрес 127.0.0.1,

а вместо доменного имени можно указать просто знак *. В результате получаем следующий файл:

Обязательно обратите внимание на логин и пароль. У кого-то они могут отличаться от установленных по

умолчанию. Если указать их неправильно, то коннектор не сможет подключиться к серверу Rander.

Сохраняем файл settings.ini и запускаем файл коннектора RanderToBitrix24.exe от имени

администратора.

8

Откроется окно приложения, в котором будут показаны все линии, которыми может управлять коннектор.

Если мы видим такую картину, значит коннектор запустился корректно и теперь можно переходить к

установке приложения Битрикс24.Rander на портале Битрикс24.

Настройка Битрикс24

Чтобы установить приложение из Маркетплейс открываем окно Приложения и находим на портале

приложение Битрикс24.Rander

9

Нажимаем на иконку приложения, устанавливаем приложение на свой портал и заходим на страничку

приложения Битрикс24.Rander.

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

Для начала необходимо подключить приложение, для этого вводим IP адрес и номер порта нашего

коннектора Битрикс24.Rander.

В нашем случае это 178.161.201.110:8182. Вводим эти данные в окно «URL сервера Rander Connector:»

10

Нажимаем кнопку Подключить приложение. В случае успешного подключения портала к коннектору нас

попросят ввести код аутентификации

Для этого переходим в окно коннектора Битрикс24.Rander и смотрим сгенерированный коннектором код

Вводим полученный код

11

И нажимаем кнопку подключить приложение. Если нигде не ошиблись, то система успешно подключится

и выдаст сообщение об этом.

В окне коннектора Битрикс24.Rander получаем список всех доступных линий.

Теперь можно выполнить остальные настройки. Необходимо сообщить приложению Битрикс24.Rander с

какими номерами абонентов оно будет работать, для этого заходим в раздел Телефония\Пользователи

12

Необходимо каждому сотруднику, присвоить уникальный внутренний номер абонента. Далее нужно

перейти в Телефония\Настройки и указать, что для исходящих звонков используется наше приложение.

Таким образом для всех абонентов эта настройка будет работать. Если для кого-то нужны индивидульные

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

Как мы видели на предыдущем скриншоте у нас есть абоненты с номерами 103, 105, 108 и 114. Теперь

подключим их к нашему приложению. Для этого вновь переходим в окно приложения Битрикс24.Rander

и выбираем для наших абонентов соответствующие линии АТС.

13

Обязательно нажимаем кнопку Сохранить изменения.

Теперь номера абонентов в Битрикс24 поставлены в соответствие с линиями АТС. Далее переходим к

настройкам правил обработки и модификации номеров.

14

Эту справочную информацию можно увидеть если нажать на знак вопроса в верхнем правом углу.

Повторное нажатие закрывает справку.

Создадим несколько важных правил, без которых набор номера из базы Битрикс24 через АТС будет

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

сделаю правила для форматов 7342, 342 и 7

15

Осталось указать в каких случаях будут автоматически создаваться лиды. Для этого ставим галочки в

нужных местах.

И не забываем нажать кнопку Сохранить изменения.

Все, настройка завершена, можно приступать к работе.

Минимальные системные требования

Компьютер, на котором размещается Коннектор Битрикс24.Rander должен удовлетворять следующим

требованиям:

1. ОС Windows XP SP2, Server 2003 или выше

2. Доступ в сеть Интернет

3. Внешний адрес в сети Интернет доступный по HTTP(S)

4. Установлено ПО Rander 5.0

5. Установлено ПО .Net Framework 4.6.1

16

Запуск системной службы Коннектор Битрикс24.Rander

Коннектор Битрикс24.Rander после запуска может работать в виде консольного приложения. Это удобно

для отладки и контроля за процессами. После того, как все отлажено и система может перейти в режим

промышленной эксплуатации, можно запустить файл коннектора как системную службу. Для этого

заходим в окно коннектора и нажимаем Ввод для остановки консольного приложения. После чего

запускаем файл install_service.bat от имени Администратора

В результате будет создана системная служба Битрикс24.Rander, которой можно управлять стандартным

способом.

Если необходимо удалить службу, остановите службу Битрикс24.Rander и запустите о имени

администратора файл uninstall_service.bat. Системная служба будет удалена и далее запустите файл

RanderToBitrix24.exe и продолжайте работать в консольном приложении.

На этом все настройки завершены. Удачной работы!