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

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

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

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

==== Настройки Asterisk ====
  - Создадим БД и таблицы в MySQL для нашей Asterisk\\ Для этого нужно войти в консоль MySQL и выполнить следующие запросы <code sql>CREATE DATABASE asteriskcdrdb;
USE asteriskcdrdb;

CREATE TABLE IF NOT EXISTS `cdr` ( 
`id` INT(11) 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 '',
`realsrc` VARCHAR(80) NOT NULL DEFAULT '',
`realdst` 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;


CREATE TABLE IF NOT EXISTS `cel` (
`id` INT(20) 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;

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;
</code>
  - Инсталлируем необходимые пакеты (для примера в Debian/Ubuntu) <code bash>aptitude install unixodbc-dev libmyodbc</code>
  - Asterisk должна быть собрана со следующими опциями {{::9d37fd2a5c08439f8a69fe81a398891c.png?400|}}{{::34d0b50241d3443d827afa222aede0f4.png?400|}}
  - Далее редактируем несколько конфиг-файлов:\\ **/etc/asterisk/res_odbc.conf** <code bash>[asteriskcdrdb]
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
</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 = asteriskcdrdb
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>
  - Внесем в **/etc/asterisk/extconfig.conf** <code bash>queue_log => odbc,asteriskcdrdb</code>
  - **cel.conf** выглядит так <code bash>[general]
enable=yes
apps=all
events=all
dateformat = %F %T
[manager]
[radius]</code>
  - **cel_odbc.conf** <code bash>[asteriskcdrdb]
connection=asteriskcdrdb
table=cel
loguniqueid=yes
charset=utf8</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(CUTTEDCHANNEL=${CUT(CHANNEL,,1)});
              Set(CUTTEDCHANNEL=${CUT(CUTTEDCHANNEL,/,2)});
              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(realdst)=${called});
              Set(CDR(realsrc)=${calling});
              ExecIf($["${calling}" = "${called}"]?Set(CDR(realsrc)=${CUTTEDCHANNEL}));
              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 => n,Set(CallerID=${ARG1})
 same => n,Set(CalleeID=${ARG2})
 same => n,Set(CUTTEDCHANNEL=${CUT(CHANNEL,,1)})
 same => n,Set(CUTTEDCHANNEL=${CUT(CUTTEDCHANNEL,/,2)})
 same => n,NoOp(CalleeID=${CalleeID}, CallerID=${CallerID})
 same => n,NoOp(VISTEPRURECORDING = ${VISTEPRURECORDING})
 same => n,GotoIf($["${VISTEPRURECORDING}" = "0"]?end)
 same => n,Set(fname=${UNIQUEID}-${STRFTIME(${EPOCH},,%Y-%m-%d-%H_%M)}-${CallerID}-${CalleeID})
 same => n,Set(datedir=${STRFTIME(${EPOCH},,%Y/%m/%d)})
 same => n,System(mkdir -p ${MP3}/${datedir})
 same => 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 => n,Set(CDR(filename)=${fname}.mp3)
 same => n,Set(CDR(realdst)=${CalleeID})
 same => n,Set(CDR(realsrc)=${CallerID})
 same => n,ExecIf($["${CallerID}" = "${CalleeID}"]?Set(CDR(realsrc)=${CUTTEDCHANNEL}))
 same => n,MixMonitor(${WAV}/${fname}.wav,b,${monopt})
 same => 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>
  - Или у вас внезапно lua <code lua>
WAV = "/opt/records/wav" -- Временный каталог с WAV
MP3="/opt/records/mp3" --Куда выгружать mp3 файлы
RECORDING=1 -- 1 - запись включена.

function recording(calling,called)
  if RECORDING == 1 then
    fname = channel.UNIQUEID:get() .. "-" .. channel.STRFTIME("${EPOCH},,%Y-%m-%d-%H_%M".."-"..calling.."-"..called):get()
    datedir = channel.STRFTIME("${EPOCH},,%Y/%m/%d"):get().."/"
    os.execute("mkdir -p " .. WAV.."/"..datedir)
    os.execute("mkdir -p " .. MP3.."/"..datedir)
    WAVfname = WAV..datedir..fname..".wav"
    MP3fname = MP3..datedir..fname..".mp3"
    channel.CDR("filename"):set(MP3fname)
    channel.CDR("realdst"):set(called)
    channel.CDR("realsrc"):set(calling)
    monopt = string.format("nice -n 19 /usr/bin/lame -b 32  --silent %s %s && rm -f %s && chown o+r %s",WAVfname,MP3fname,WAVfname,MP3fname)
    app.mixmonitor(WAVfname,b,monopt)
    return
  end;
end;

extensions = {
  ["local"] = {
    --локальные вызовы на номера XXX
    ["_XXX"] = function(context,extension)
                 app.answer()
                 recording(channel.CALLERID("num"):get(),extension)
                 app.dial("SIP/"..extension,300,"t")
                 app.hangup()
               end;
  };

}

</code>
  - С препарированием нашей АТС закончили! \\ Переходим к настройке синхронизации БД и файлов записей разговоров в облако ViStep.RU. Для этого воспользуйтесь инструкцией - https://wiki.vistep.ru/doku.php?id=cloud_daemon_sync 
  - Для входа в систему статистики используйте данные авторизации (Email-адрес/Пароль) из регистрационного письма.

На этом все настройки завершены. \\ Если вы все сделали правильно, то через какое-то время (зависит от размера БД) сможете воспользоваться всеми отчетами системы статистики ViStep.RU в своем личном кабинете. \\ Если у вас остались вопросы и/или есть предложения/замечания, пишите нам на <support@vistep.ru>.