...
Installation Instructions
- Download the JAR file.
- Unpack the JAR file to your local computer.
Setting General Configuration
Open the folder with the unpacked app. Open the file etc/config.xml.
Edit the general configuration of the app:
Parameter | Description | Example | ||
---|---|---|---|---|
support.context | Asterisk context which is used for work of call center operators. | support-team | ||
support.group | Jira user group which includes operators of the call center. | call-operators | ||
support.group.leads | Jira user group which includes managers of the call center operators. | cc-managers | ||
support.sipproperty | User property which contains the SIP number of the call operator. | sipnumber | ||
support.project.key | Jira project key which will be used for tracking incoming calls from customers. | SUP | ||
user.for.search.name | Login of the system user which will be used for looking up for issues. | callcenterRobot | ||
callcenter.support.fieldname | Name of the custom field which stores the phone number of the customer. | Phone Number | ||
client.summary | Name of the custom field which stores the name of the customer. | Customer | ||
client.fields | Name of the optional custom fields which store additional information about the customer.
| City, Region, Country | ||
Общие настройки
callcenter.support.fieldname - название поля, содержащего номер телефона клиента, например Номер телефона
client.summary - название поля в заявке, содержащего название клиента, например, Клиент
client.fields - названия полей клиента, которые будут отображаться в диалоге разговора, например, Город, Регион, Страна
not.copied.fields - названия полей из заявки, которые не будут скопированы во вновь создаваемую заявку, например, Дата и время, Продолжительность звонка (разделитель - запятая)
Важно
Поля должны быть одного из стандартных типов, либо nFeed
client.additional.number.fields - названия полей из заявки, в которых могут быть дополнительные номера клиента, например, Номер для связи (разделитель - запятая)
Важно
Поля должны быть типа "Номер телефона"
operators.refresh.timeout.minutes - интервал в минутах, с которым будет синхронизироваться список операторов и членов группы support.group, например, 1
missed.calls.refresh.timeout.minutes - интервал в минутах, с которым будет выполняться проверка на наличие "новых" пропущенных звонков в БД, например, 1
missed.calls.period.days - период в днях, за который выбираются пропущенные звонки из БД, например, 3
last.calls.limit - максимальное количество звонков, отображаемое в профиле оператора, например, 100
phone.number.length - возможные варианты длины номера телефона, например, 4, 7, 10, 11. Вводятся конкретные варианты длины, диапазоны значений не предусмотрены
Перед установкой плагина, необходимо распаковать полученный jar-файл архиватором и заполнить настройки в файлах etc/config.xml и etc/connection-config.xml
Все настройки плагина разделены на 2 категории.
Первая категория - сетевые настройки, необходимы для подключения к серверу Asterisk`a, поднятия собственного websocket-сервера, а также доступа в базу данных, для получения списка пропущенных звонков - хранятся в jar-архиве в файле /conf/connection.xml
Вторая категория - общие настройки, указывается проект саппорта, проект, для хранения клиентов, группа пользователей, являющихся операторам коллцентра, названия полей и т. д. - хранятся в jar-архиве в файле /conf/general.xml
Сетевые настройки
asterisk.host - адрес сервера, на котором запущен Asterisk, например, starline-demo.stiltsoft.com
asterisk.port - номер порта, на котором работает Asterisk, стандартное значение 5038
asterisk.login - логин пользователя, для доступа к сервуру Asterisk`a по протоколу AMI, например, jira
asterisk.password - пароль пользователя, для доступа к сервуру Asterisk`a по протоколу AMI, например, jirasecret
asterisk.dial.prefix - префикс, для корректного совершения исходящих вызовов
Важно!
Для корректной работы, у пользователя должны быть права на выполнение комманд originate и core show channels
Полезователь также должен получать события ExtensionStatusEvent и CoreShowChannelEvent
websockets.port - порт, для отправки сообщений плагина по протоколу WebSockets, например, 6090
missed.calls.host - адрес сервера с базой пропущенных звонков, starline-demo.stiltsoft.com
missed.calls.port - номер порта, на котором работает mysql сервер, стандартное значение 3306
missed.calls.dbname - название базы данных, в которой хранятся пропущенные звонки, например, bigdb
missed.calls.login - имя пользователя, для доступа в базу данных с пропущенными звонками, например, bigdb
missed.calls.password - пароль пользователя, для доступа в базу данных с пропущенными звонками, например, bigdb
cert.file.path - путь до файла сертификата (X.509 certificate chain file in PEM format), например, D:\Downloads\server.crt
key.file.path - путь до файла приватного ключа (PKCS#8 private key file in PEM format), например, D:\Downloads\server.pem
key.password - пароль от ключа, например, changeit
voice.box.link - шаблон адреса, по которому находятся файлы с записями голосового ящика, вместо %s будет подставлено имя файла, например, http://pbx.ultrastar.ru:8000/%s.wav
Затем, необходимо в JIRA создать проект с ключом, указанными в support.project.key, пользователя с именем заданным в user.for.search.name, кастомное поле типа "Номер телефона" с названием, заданным в callcenter.support.fieldname, поле с названием, заданным в client.summary, а также поля с названиями, перечисленными в client.fields
После этого, запаковать плагин и установить в JIRA стандартным способом.
Существует возможность, хранить часть настроек плагина отдельно. Для этого, файл connection-config.xml можно сохранить под именем callcenter-plugin-connection.xml в папке %jira_home%\webapp\WEB-INF\classes . В этом случае, при установке плагина настройки буду прочитаны из этого файла, т. е. при изменении настроек подключения не нужно будет перепаковывать плагин, а лишь внести изменения в callcenter-plugin-connection.xml по адресу %jira_home%\webapp\WEB-INF\classes и переустановить плагин