Система статистики call центров на IP-АТС Asterisk (FreePBX)

Эта страница только для чтения. Вы можете посмотреть исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
**Системные требования.**

  * На сервере (здесь и далее примем, что “сервером” может быть как отдельный компьютер, \\ так и виртуальная машина, VPS/VDS и т .д.  Также отметим: docker-контейнер с локальной версией системы статистики может быть запущен как на том же сервере, что и АТС Asterisk, так и на отдельном сервере )должна быть установлена операционная система Linux семейства Debian не ниже 7.0 (Ubuntu 14.04  и выше), CentOS не ниже 6.5 или другие дистрибутивы с актуальной базой репозиториев.

  * IP АТС Asterisk должна быть версии не ниже 1.8. \\ На Asterisk должна быть настроена запись информации о разговорах в таблицы cel, cdr и queue_log, подробную информацию о необходимых настройках Asterisk вы найдете ниже в разделе "Настройки Asterisk".

  * Сервер БД MySQL не ниже версии 5.1.

  * Docker версии 1.7.1 и выше (версии ниже нужно проверять дополнительно). \\ Установка docker в различных ОС подробно расписана в официальной документации: \\ [[https://store.docker.com/editions/community/docker-ce-server-debian?tab=description|Debian]], [[https://store.docker.com/editions/community/docker-ce-server-ubuntu?tab=description|Ubuntu]], [[https://store.docker.com/editions/community/docker-ce-server-centos?tab=description|CentOS]].

**Настройки Asterisk.**
  - Инсталлируем необходимые пакеты (для примера в Debian/Ubuntu) <code bash>aptitude install unixodbc-dev libmyodbc</code>
  - Asterisk должен быть собран со следующими опциями {{::9d37fd2a5c08439f8a69fe81a398891c.png?400|}}{{::34d0b50241d3443d827afa222aede0f4.png?400|}}
  - Далее редактируем несколько конфиг-файлов:\\ **/etc/asterisk/res_odbc.conf** <code bash>[asterisk]
enabled => yes
dsn => MySQL-asterisk
username => asterisk_user
password => 232d2edxse3e</code> **/etc/asterisk/cdr_adaptive_odbc.conf** <code bash>[cdr_adaptive_connection]
connection=asterisk
table=cdr
alias start => calldate
# раскомментируй, если хочешь видеть реальный номер, накоторый пришел вызов, а не номер оператора очереди
#alias dst => does_not_exist
#alias realdst => dst</code> **/etc/odbc.ini** <code bash>[MySQL-asterisk]
Description = MySQL Asterisk database
;Trace = Off
;TraceFile = stderr
Driver = MySQL
Server = localhost
User = asterisk_user
Password = 232d2edxse3e
;Port = 3306
Socket = /var/run/mysqld/mysqld.sock
Database = asterisk
Charset = utf8</code> **/etc/odbcinst.ini** <code>[MySQL]
Description = MySQL driver
Driver = /usr/lib/x86_64-linux-gnu/odbc/libmyodbc.so
Setup = /usr/lib/x86_64-linux-gnu/odbc/libodbcmyS.so
CPTimeout =
CPReuse =</code> в конец **/etc/asterisk/cdr_mysql.conf** добавить <code bash>alias filename => filename</code>
  - Создадим БД и таблицу cdr в MySQL <code sql>mysql> create database asterisk;
mysql> use asterisk;
mysql> CREATE TABLE `cdr` ( `id` int(9) unsigned NOT NULL AUTO_INCREMENT,
                    `calldate` datetime NOT NULL DEFAULT '0000-00-00 00:00:00',
                    `clid` varchar(80) NOT NULL DEFAULT '',
                    `src` varchar(80) NOT NULL DEFAULT '',
                    `dst` varchar(80) NOT NULL DEFAULT '',
                    `dcontext` varchar(80) NOT NULL DEFAULT '',
                    `channel` varchar(80) NOT NULL DEFAULT '',
                    `dstchannel` varchar(80) NOT NULL DEFAULT '',
                    `lastapp` varchar(80) NOT NULL DEFAULT '',
                    `lastdata` varchar(80) NOT NULL DEFAULT '',
                    `duration` int(11) NOT NULL DEFAULT '0',
                    `billsec` int(11) NOT NULL DEFAULT '0',
                    `disposition` varchar(45) NOT NULL DEFAULT '',
                    `amaflags` int(11) NOT NULL DEFAULT '0',
                    `accountcode` varchar(20) NOT NULL DEFAULT '',
                    `uniqueid` varchar(32) NOT NULL DEFAULT '',
                    `userfield` varchar(255) NOT NULL DEFAULT '',
                    `filename` varchar(255) NOT NULL DEFAULT '',
                    PRIMARY KEY (`id`),
                    KEY `calldate` (`calldate`),
                    KEY `accountcode` (`accountcode`),
                    KEY `uniqueid` (`uniqueid`),
                    KEY `dst` (`dst`),
                    KEY `src` (`src`) ) ENGINE=InnoDB AUTO_INCREMENT=0 DEFAULT CHARSET=utf8;
mysql> grant all on asterisk.* to 'asterisk_user'@'localhost' identified by '232d2edxse3e';</code>
  - Таблицу cel <code sql>mysql>CREATE TABLE `cel` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `eventtype` varchar(30) NOT NULL,
  `eventtime` datetime NOT NULL,
  `cid_name` varchar(80) NOT NULL,
  `cid_num` varchar(80) NOT NULL,
  `cid_ani` varchar(80) NOT NULL,
  `cid_rdnis` varchar(80) NOT NULL,
  `cid_dnid` varchar(80) NOT NULL,
  `exten` varchar(80) NOT NULL,
  `context` varchar(80) NOT NULL,
  `channame` varchar(80) NOT NULL,
  `src` varchar(80) DEFAULT NULL,
  `dst` varchar(80) DEFAULT NULL,
  `channel` varchar(80) DEFAULT NULL,
  `dstchannel` varchar(80) DEFAULT NULL,
  `appname` varchar(80) NOT NULL,
  `appdata` varchar(80) NOT NULL,
  `amaflags` int(11) NOT NULL,
  `accountcode` varchar(20) NOT NULL,
  `uniqueid` varchar(32) NOT NULL,
  `linkedid` varchar(32) NOT NULL,
  `peer` varchar(80) NOT NULL,
  `userdeftype` varchar(255) NOT NULL,
  `eventextra` varchar(255) DEFAULT NULL,
  `userfield` varchar(255) DEFAULT NULL,
  PRIMARY KEY (`id`),
  KEY `uniqueid_index` (`uniqueid`),
  KEY `linkedid_index` (`linkedid`),
  KEY `eventtime` (`eventtime`),
  KEY `exten` (`exten`),
  KEY `eventtype` (`eventtype`)
) ENGINE=InnoDB AUTO_INCREMENT=0 DEFAULT CHARSET=utf8;</code>
  - Таблицу queue_log <code sql>mysql> CREATE TABLE IF NOT EXISTS `queue_log` (
id int(10) UNSIGNED NOT NULL AUTO_INCREMENT,
time timestamp NULL DEFAULT '0000-00-00 00:00:00',
callid varchar(32) NOT NULL default '',
queuename varchar(32) NOT NULL default '',
agent varchar(32) NOT NULL default '',
event varchar(32) NOT NULL default '',
data1 varchar(100) NOT NULL default '',
data2 varchar(100) NOT NULL default '',
data3 varchar(100) NOT NULL default '',
data4 varchar(100) NOT NULL default '',
data5 varchar(100) NOT NULL default '',
PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;
mysql> \q</code>
  - Внесем в **/etc/asterisk/extconfig.conf** внесем <code bash>queue_log => odbc,asterisk</code>
  - **cel.conf** выглядит так <code bash>[general]
enable=yes
apps=all
events=all
dateformat = %F %T
[manager]
[radius]</code>
  - Проверим все ли в порядке с подключением Asterisk к MySQL <code bash>*CLI> odbc show asterisk 
ODBC DSN Settings
-----------------
  Name:   asterisk
  DSN:    MySQL-asterisk
    Last connection attempt: 1970-01-01 07:00:00
  Pooled: No
  Connected: Yes</code>
  - И последним (далеко не в плане значимости) шагом будет настройка диалплана для записи разговоров. Ниже приведен пример макроса для синтаксиса AEL (**extensions.ael**) <code bash>globals {
    WAV=/var/calls; //Временный каталог с WAV
    MP3=/var/calls; //Куда выгружать mp3 файлы
    RECORDING=1; // Запись, 1 - включена.
};

macro recording (calling,called) {
        if ("${RECORDING}" = "1"){
              Set(fname=${UNIQUEID}-${STRFTIME(${EPOCH},,%Y-%m-%d-%H_%M)}-${calling}-${called});
	      Set(datedir=${STRFTIME(${EPOCH},,%Y/%m/%d)});
	      System(mkdir -p ${MP3}/${datedir});
	      System(mkdir -p ${WAV}/${datedir});
              Set(monopt=nice -n 19 /usr/bin/lame -b 32  --silent "${WAV}/${datedir}/${fname}.wav"  "${MP3}/${datedir}/${fname}.mp3" && rm -f "${WAV}/${fname}.wav" && chmod o+r "${MP3}/${datedir}/${fname}.mp3");
              Set(CDR(filename)=${fname}.mp3);
	      Set(CDR(recordingfile)=${fname}.wav);
              Set(CDR(realdst)=${called});
              MixMonitor(${WAV}/${datedir}/${fname}.wav,b,${monopt});

       };
};

_XXXXXX => {
&recording(${CALLERID(number)},${EXTEN});
Dial(SIP/83843${EXTEN}@multifon,180,tT);
HangUP();
} // end of _XXXXXX


</code> \\ В данном примере файлы записей разговоров попадают прямиков в **/var/calls**, где имеют следующую иерархию \\ <code bash>ls /var/calls/2016/ -l
total 24
drwxr-xr-x 19 asterisk asterisk 4096 May 31 10:10 05
drwxr-xr-x 30 asterisk asterisk 4096 Jun 30 10:02 06
drwxr-xr-x 31 asterisk asterisk 4096 Jul 31 10:18 07
drwxr-xr-x 31 asterisk asterisk 4096 Aug 31 09:00 08
drwxr-xr-x 26 asterisk asterisk 4096 Sep 26 09:51 09</code>
  - Если вам ближе стандартный синтаксис, обратите внимание на следующий макрос <code bash>[globals]
WAV=/records
MP3=/records/mp3
VISTEPRURECORDING=1
[macro-vistep.ru-record]
exten => s,1,NoOp(== START macro-vistep.ru-record ==)
same => s,n,Set(CallerID=${ARG1})
same => s,n,Set(CalleeID=${ARG2})
same => s,n,NoOp(CalleeID=${CalleeID}, CallerID=${CallerID})
same => s,n,NoOp(VISTEPRURECORDING = ${VISTEPRURECORDING})
same => s,n,GotoIf($["${VISTEPRURECORDING}" = "0"]?end)
same => s,n,Set(fname=${UNIQUEID}-${STRFTIME(${EPOCH},,%Y-%m-%d-%H_%M)}-${CallerID}-${CalleeID})
same => s,n,Set(datedir=${STRFTIME(${EPOCH},,%Y/%m/%d)})
same => s,n,System(mkdir -p ${MP3}/${datedir})
same => s,n,Set(monopt=nice -n 19 /usr/bin/lame -b 32 --silent "${WAV}/${fname}.wav"  ${MP3}/${datedir}/${fname}.mp3" && rm -f "${WAV}/${fname}.wav" && chmod o+r "${MP3}/${datedir}/${fname}.mp3")
same => s,n,Set(CDR(filename)=${fname}.mp3)
same => s,n,Set(CDR(realdst)=${called})
same => s,n,MixMonitor(${WAV}/${fname}.wav,b,${monopt})
same => s,n(end),MacroExit()

;пример использования
[from-internal-custom]
;include => from-internal
exten => _XX.,1, Macro(vistep.ru-record,${CALLERID(number)},${EXTEN})

[from-pstn-custom]
exten => _XX.,1, Macro(vistep.ru-record,${CALLERID(number)},${EXTEN})</code>


**Установка, настройка и запуск.**
  - Для начала нужно провести первичную подготовку MySQL-базы данных Asterisk. \\ Зайдите на сервер MySQL и создайте нового пользователя с полными правами, например вот так: \\ <code sql>GRANT ALL PRIVILEGES ON *.* TO 'vistepru'@'%' \
IDENTIFIED BY 'MySuperPassword111' WITH GRANT OPTION;
flush privileges;
quit</code>Этот шаг необходим для работы мастера настройки БД, речь о котором пойдет несколько позже. \\ Также проверьте, что MySQL слушает не только 127.0.0.1, но и IP-адрес, по которому к нему будет обращаться система статистики. \\ За это в настройках MySQL отвечает параметр **bind-address**, проще всего закомментировать эту строку в my.cnf, тогда mysql-сервер будет слушать на всех IP-адресах сервера.
  - Теперь зайдите на сервер, где предполагаете запускать docker-контейнер, по ssh. Скачайте архив контейнера по предоставленной ссылке, например (это пример, корректная ссылка высылается на почту после оплаты): <code bash>wget https://vistep.ru/stat.vistep.ru_local_1.0.3.tgz</code> Если в вашей системе нет wget, то воспользуйтесь вот этой командой: <code bash>curl -o stat.vistep.ru_local_1.0.3.tgz https://vistep.ru/stat.vistep.ru_local_1.0.3.tgz</code>
  -  Далее перейдите в папку с архивом контейнера  (здесь и далее это /root/) и загрузите его в docker <code bash>docker load -i stat.vistep.ru_local_1.0.3.tgz</code> Проверьте все ли в порядке, команда <code bash>docker images</code> должна вернуть нечто подобное \\ {{:screen_shot_2017-04-21_at_12.58.01.png|}}
  - Теперь нам необходимо настроить конфигурационный файл системы статистики. Он будет приложен к письму со ссылкой на ваш архив ПО, называется **config.php**. \\ Поместите его на сервер, где запускаете docker-контейнер, отредактируйте, внеся IP-адрес сервера БД и название БД. \\ Все остальные данные там уже присутствуют.
  - Следующим пунктом будет настройка возможности прослушивать и скачивать файлы разговоров в интерфейсе статистики. Как и было описано ранее, вы можете запустить docker-контейнер с ПО как на сервере с АТС, так и на отдельном сервере. Для запуска docker там же, где и Asterisk, вам нужно выполнить такую команду:<code bash>docker run --name=stat.vistep.ru_local_1.0.3 -p 80:80 -v /root/config.php:/var/www/html/app/config.php -v /ВАШ/ПУТЬ/К/ФАЙЛАМ:/var/www/html/public/user/УНИКАЛЬНЫЙ_КАТАЛОГ_ПОЛЬЗОВАТЕЛЯ/some/path/to/files/ --restart=always -d stat.vistep.ru_local_1.0.3 </code> В консоле должно отобразиться подобное:{{:screen_shot_2017-04-21_at_13.42.44.png|}} \\ где /ВАШ/ПУТЬ/К/ФАЙЛАМ - это путь к файлам записей разговоров на вашей АТС \\ Если же запуск осуществляется на отдельном сервере, то сначала  примонтируйте папку с файлами с сервера АТС на сервер с docker по NFS. Вот пример такой конфигурации: файл **/etc/exports** на сервере с Asterisk:<code bash>/records/mp3/ 192.168.0.0/255.255.255.0(rw,insecure,nohide,all_squash,anonuid=1001,anongid=1001,no_subtree_check)</code>а на сервере с docker, в **/etc/fstab** <code bas>ASTERISK_IP_ADDRESS:/records/mp3 /root/records nfs rsize=8192,wsize=8192 0 0</code> *здесь /records/mp3 - это путь к файлам записей на АТС \\ Затем выполните запуск уже знакомой командой <code bash>docker run --name=stat.vistep.ru_local_1.0.3 -p 80:80 -v /root/config.php:/var/www/html/app/config.php -v /root/records:/var/www/html/public/user/УНИКАЛЬНЫЙ_КАТАЛОГ_ПОЛЬЗОВАТЕЛЯ/some/path/to/files/ -d stat.vistep.ru_local_1.0.3</code>
  - Далее откройте web-браузер и перейдите по ссылке <code>http://DOCKER_DAEMON_IP_ADRESS/install.html</code> Вас встретит мастер настройки {{:screen_shot_2017-04-21_at_13.54.58.png|}}
  - Заполните все поля (на шаге номер 1 мы создали нужного пользователя) и нажмите кнопку Тест {{:screen_shot_2017-04-21_at_13.57.29.png|}}
  - При успешном прохождении теста на подключение к БД вы увидите {{::screen_shot_2017-04-21_at_14.00.33.png|}} \\ Если все так, жмите Настроить БД
  - Здесь мастер сообщит, что все прошло успешно и вы можете перейти по ссылке <code>http://DOCKER_DAEMON_IP_ADRESS</code> т.е. к авторизации в системе {{:screen_shot_2017-04-21_at_14.11.13.png|}}
  - Для входа используйте логин и пароль, которые прийдут вам в письме вместе со ссылкой на контейнер и конфиг-файлом

На этом настройка завершена, приятного пользования! \\ По любым вопросам/неполадкам/пр. пишите нам на <support@vistep.ru> или прямо из интерфейса, в меню Help Desk.
Система статистики call центров на IP-АТС Asterisk (FreePBX)

Инструменты пользователя

Инструменты сайта

Инструменты страницы
