Требования к системе
1. Требования к телефонии Asterisk
Требования можно проверить автоматически, с помощью нашего скрипта itgrix_checker\
Скачиваем скрипт проверки
curl -OJLk "https://itgrix.ru/download/itgrix_checker"
Запускаем скрипт
bash itgrix_checker
Настройка производится с аккаунта пользователя со следующими правами:
Просмотр и редактирование конфигурационных файлов Asterisk;
Установка дополнительного ПО на сервере, настройка его работы в качестве сервиса.
1. Asterisk 13.0 и выше
asterisk -V
Ответ: Asterisk 13, FreePBX 14 и аналоги Подойдет как Asterisk, так и FreePBX, Elastix, Issabel...
2. В Asterisk включен и настроен AMI
asterisk -rx 'manager show settings'
Ответ:
Manager (AMI): Yes
3. Важно! В Asterisk включено логирование звонков в таблицу CEL, которая находится в MySQL. Список необходимых ивентов:
CHAN_START CHAN_END ANSWER LINKEDID_END
BLINDTRANSFER ATTENDEDTRANSFER
PICKUP
1. Проверяем статус работы CEL:
asterisk -rx 'cel show status'
Ответ:
CEL Logging: Enabled
CEL Tracking Event: CHAN_START
CEL Tracking Event: CHAN_END
CEL Tracking Event: ANSWER
CEL Tracking Event: BLINDTRANSFER
CEL Tracking Event: ATTENDEDTRANSFER
CEL Tracking Event: LINKEDID_END
CEL Tracking Event: PICKUP
...
CEL Event Subscriber: ODBC CEL backend
2. Проверяем информацию о последних событиях:
mysql
use asteriskcdrdb;
select id, eventtype, eventtime, cid_num, exten, uniqueid, linkedid, channame from cel order by id desc limit 10;
Таблица должна быть не пустая, в ней должны отображаться события звонка.
Логин/Пароль для подключения к mysql обычно можно найти в /etc/asterisk/res_odbc_additional.conf
4. Включена запись разговоров и в CDR есть информация об имени файла записи
select recordingfile from cdr order by calldate desc limit 10;
Если через АТС были звонки, то в ответе должны быть последние 10 названий файлов записей.
5. Для работы кастомизатора необходим PHP 5.3 и выше
php -v
Пример вывода:
PHP 5.6.40 (cli) (built: Jan 22 2019 23:51:52)
5.1. Необходим пакет php-json (обязательно, без него никакие кастомизации работать не будут)
php -r 'var_dump(function_exists("json_decode"));'
Ожидаемый вывод:
bool(true)
php -r 'echo curl_version()["version"];'
Пример вывода:
7.47.0
6. Для конвертации записей в mp3 рекомендуется установить Lame
Проверить версию:
lame -v
Пример вывода:
LAME 64bits version 3.100 (http://lame.sf.net)
2. Требования к CRM-системам
Битрикс24
Настройка портала производится пользователем, обладающим административными правами.
С 9.12.24 для РФ и РБ использовать приложения на облачном и коробочном портале Битрикс24 возможно только при включенном триале либо оплаченной подписке на Маркетплейс
Коробочная версия
Для коробочной версии 1С-Битрикс24 должны быть установлены и иметь актуальную версию следующие модули: - Главный модуль Битрикс24 версии 16.5.11 и выше; - Модуль “REST API (rest)”; - Модуль “Телефония”; - Модуль “CRM”; - Модуль “Push&Pull”.
Коробочный портал должен иметь актуальную действующую лицензию. В демо режиме и с истекшей лицензией указанные модули не работают.
Облачная версия
Активная платная лицензия на Битрикс24 любого тарифа.
amoCRM / Kommo
Особых требований к конфигурации amoCRM и Kommo нет.
3. Требования к сети
На сервере с модулем (обычно это сервер Asterisk), нужно разрешить исходящие запросы к:
Вашему порталу Битрикс24 (облачному или локальному) по протоколу https или http;
Серверу авторизации Битрикс24 https://oauth.bitrix.info (не важно, облачный у вас Битрикс24 или коробочный!);
Серверу лицензирования модуля https://lk.bx24asterisk.ru;
Серверу приложения https://iw.bx24asterisk.ru.
Для реализации полного функционала (click-to-call и прослушивание записей) из Битрикс24 должен быть доступ на сервер с модулем (проброшен порт 8077 и 8078).
Для прослушивания разговоров - должен быть доступ на сервер с модулем с использованием протокола HTTPS: проброшен порт 8078 и установлены корректные ssl сертификаты.
Битрикс24: если используется загрузка файлов записей напрямую на портал - настройка порта 8078 не требуется.
amoCRM: для прослушивания записей настройка порта 8078 обязательна.
Это связано с запретом браузерами смешанного содержимого.
amoCRM / Kommo
В настройках виджета Itgrix, в поле 'Внешний адрес модуля для запросов Click-to-Call', адрес должен быть указан с протоколом https.
Начиная с версии модуля интеграции 3.0.0, для показа и скрытия карточки звонка необходимо настроить и обеспечить возможность подключения пользователей к модулю интеграции по протоколу WSS. Адрес для подключения имеет вид wss://<Asterisk IP>:8078/crm/cardws. Его можно настроить в виджете приложения в интерфейсе amoCRM. Необходимые условия для корректной работы:
адрес доступен с компьютера пользователя, это может быть адрес в локальной сети, адрес доступный через VPN или (не рекомендуется) внешний адрес;
настройки всех узлов маршрута между пользователем и адресом сокета карточки разрешают устанавливать соединение по протоколу WSS, это может потребовать дополнительной настройки имеющегося сервера Nginx или другого прокси-сервера;
на сервере где установлен модуль интеграции настроен валидный SSL-сертификат, который успешно верифицируется браузером пользователя, и этот сертификат указан в интерфейсе настройки модуля интеграции
http://<Asterisk IP>:8077/config/module;сервер на котором установлен модуль интеграции и промежуточные узлы маршрута настроены для одновременной поддержки необходимого количества соединений, по одному на браузер с открытым интерфейсом amoCRM.
Без этой настройки основной функционал приложения будет работать, но не будет отображаться карточка звонка.
4. Минимальные системные требования
Процессор от 2 ядер.
ОЗУ от 2 ГБ.
От 500 МБ свободного места на жестком диске (Коннектор + бэкап + лог).
5. Требования к операционной системе сервера
В системе должна быть установлена библиотека OpenSSL версии 1.0.2k и выше.
Для проверки версии, в консоли вводим команду:
openssl version
Для проверки введите в командной строке # uname -a.
Хорошо проходит установка модуля на операционных системах:
CentOS 7 и выше.
Debian 7 и выше.
На CentOS 6 по умолчанию установлена библиотека OpenSSL версии 1.0.1e, Itgrix будет работать только с обновленной версией OpenSSL 1.0.2k и выше.
Мучительно проходит установка на FreeBSD.
НЕ удалось провести интеграцию на операционных системах:
CentOS 5
Debian 6
Gentoo
Если вы используете другую операционную систему, то для установки модуля необходимо, чтобы в репозиториях ОС были пакеты: unixODBC, mysql-connector-odbc, mysql-server. Если они уже установлены в ОС, то это сильно упростит установку модуля.
Last updated
