Требования

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

• Операционная система: Linux x86/x64, Windows x86/x64.
• База данных: PostgreSQL 9.0+, SQL Server 2008 R2+, Oracle 11g+.
• iOS SDK: iOS 8.0+.
• Android SDK: Android 4.4+.
• Панель управления (web single-page application): IE 11+, Edge, Chrome 49+, Firefox 47+, Safari z10+.

Требования к серверам (до 500 активных клиентов одновременно):

• Сервер приложения: процессор с 2-4 физическими ядрами, 4Гб RAM, место на жестком диске зависит от объема присылаемых фотографий/файлов.
• Сервер базы данных: процессор с 2-4 физическими ядрами, 8Гб RAM.

Обзор поставки

IQChannels является серверным приложением, которое предоставляет публичный REST API для внешних клиентов (виджета на сайте и мобильных приложения), внутренний REST API для внутренних клиентов и веб-приложение панели управления и рабочего места оператора.

Архив поставки:

• bin — скомпилированные бинарные файлы приложения, скрипты управления приложением.
• config — конфигурационные файлы.
• migrations — файлы миграций для баз данных.
• static — статические файлы (JavaScript, CSS, картинки и т.д.)
• var/run, var/log, var/upload — папки для логов, pid-файлов (в Unix) и загружаемого пользовательского контента.

Установка приложения

1) Скачайте требуемый релиз со страницы Релизы.

2) Распакуйте архив.

$ unzip iqchannels-linux-2017.2.0.zip

3) Укажите настройки для базы данных в файле config/config.yaml

PostgreSQL:

db:
 type: postgres
 connect: port=5432 dbname=iqchannels user=iqchannels password=secret sslmode=disable
 max_idle: 4 # Max idle connections in a connection pool.
 max_open: 12 # Max open connections in a connection pool.

SQL Server:

db:
 type: mssql
 connect: port=1433;database=iqchannels;user id=sa;password=Secret22;encrypt=disable
 max_idle: 4 # Max idle connections in a connection pool.
 max_open: 12 # Max open connections in a connection pool.

Oracle:

Для поддержки Oracle нужно использовать либо образ для Docker, либо отдельную сборку с поддержкой Oracle и дополнительно установить в систему Oracle Instant Client.

db:
 type: oracle
 connect: iqchannels/secret@localhost:1521/xe
 max_idle: 4 # Max idle connections in a connection pool.
 max_open: 12 # Max open connections in a connection pool.

4) При необходимости, измените другие настройки сервера в файле config/config.yaml. Там есть настройки по умолчанию с комментариями.

5) Запустите скрипты миграции базы данных:

$ ./bin/iqchanneld migrate

6) Запустите демон приложения:

$ ./bin/iqchanneld.sh start

7) Для остановки, статуса, перезапуска демона используйте:

$ ./bin/iqchanneld.sh start|stop|status

8) Для просмотра логов приложения:

$ tail -f ./var/log/iqchanneld.log

Настройка приложения

После установки и запуска приложения будут доступны два веб-сервера:

• http://localhost:3001/ — виджет для сайта, публичное API.
• http://localhost:3002/ — панель управление, рабочее место оператора, внутреннее API.

1) Зайдите в панель управления и создайте организацию и администратора:

2) Добавьте в систему необходимых пользователей:

1. В верхнем меню перейдите в пункт Пользователи.
2. Создайте необходимых пользователей и системные роли.

3) Создайте проект:

1. В верхнем меню Проекты выберите Создать проект.
2. В открывшемся модальном окне введите информацию о проекте.
3. Перейдите на страницу проекта.

4) Создайте группы в проекте:

1. В левом меню проекта выберите пункт Пользователи.
2. Создайте необходимые группы в проекте с требуемыми полномочиями и добавьте в них пользователей. Например:
   1. Администраторы.
   2. Супервайзеры.
   3. Операторы.

5) Создайте тестовое подключение к CRM:

Для проверки виджета и SDK для мобильных создайте тестовое подключение к CRM, которое использует тестовые данные, зашитые в систему.

1. В левом меню проекта выберите Внешние системы.
2. Добавить подключение.
3. Заполните данные подключения в модальном окне, укажите тип Тестовые данные.

6) Создайте тестовый канал для чата:

1. В левом меню проекта выберите Каналы.
2. Создать канал.
3. В открывшемся модальном окне укажите:
   1. Тип канала: Внутренний чат.
   2. Название на английском: support (используется в API).
4. Создайте канал.

7) Настройте правила распределения обращений:

1. В левом меню проекта выберите Распределение.
2. Создать правило.
3. В открывшемся модальном окне укажите:
   1. Название: По умолчанию.
   2. Группа: Операторы.
4. Создайте правило.

8) Протестируйте, что все работает.

1. Перейдите на страницу тестового виджета: http://localhost:3001/widget/example.html
2. Напишите сообщение от имени любого пользователя.
3. Проверьте, что в системе появилось новое обращение.

9) Готово.