Интеграция VoxDistro и системы аналитики IMOTIO

Интеграция актуальна для VoxDistro 16. Для других версий или других дистрибутивов могут потребоваться доработки.

Для интеграции необходимы:

•   php версии 5.6 и выше;
•   ведение на АТС записей разговоров в стерео-режиме.

Начиная с VoxDistro 16, в дистрибутиве у нас уже встроен перевод в стерео-режим при записи телефонных разговоров. Однако, если делается не на нашем дистрибутиве или же на VoxDistro моложе 16-ой версии, то перевод в стерео-режим можно сделать по данной статье.

В статье воспользуемся встроенным функционалом

Далее, пока находимся в Advanced Settings, выставим в Yes параметры Display Readonly Settings и Override Readonly Settings, чтобы была возможность установить скрипт для постобработки вызова.

Подготовка диалплана

В контексте, который указан в транках, прописываем переменную ${CALLTYPE}=INBOUND.

Переменная должна быть наследуемой.

А в extensions_override.conf в [sub-record-check] пропишем следующее:

exten => recordcheck,1,Noop(Starting recording check against ${ARG1})
; Custom variables ${CALLTYPE}
exten => recordcheck,n,ExecIf($[“${CALLTYPE}” != “INBOUND”]?Set(__CALLTYPE = “OUTBOUND”))
; Override end
exten => recordcheck,n,Goto(${ARG1})

Так, все входящие вызовы, попавшие в транк, будут считаться входящими, а все остальные вызовы на АТС – исходящими. Перейдём к написанию скрипта.

Написание скрипта

Он будет лежать в директории /var/www/html/imotio/. Назовём его functions.php.

Сразу определимся, что нам надо будет передавать в скрипт: номер звонящего, linkedid вызова, имя файла записи разговора, время начала звонка, время ответа на звонок, время завершения звонка и тип вызова.

<?php
	define('IMOTIO_TOKEN', 'b964c516-a4be-45c0-8e96-24f2d94d1a70');
	define('IMOTIO_URL', 'https://test.imot.io/api/');
	define('MYSQL_USER', 'freepbxuser');
	define('MYSQL_PASS', 'cb4a08d3705e5eb896eea6af10512305');
	$dsn = 'mysql:host=localhost; dbname=asteriskcdrdb';
	try {
		$dbh = new PDO($dsn, MYSQL_USER, MYSQL_PASS);
	} catch (PDOException $e) {
		die ('При подключении к базе данных возникла ошибка.' . $e->getMessage());
	}
	$callerid_num = $argv[1];
	$linkedid = $argv[2];
	$callfile_in = $argv[3] . '-in.wav';
	$callfile_out = $argv[3] . '-out.wav';
	$call_start = strtotime($argv[4]);
	$answer_start = strtotime($argv[5]);
	$call_end = strtotime($argv[6]);
	$filedir = $argv[7];
	$call_type = $argv[8];

	$ph_array = array(
		'lid' => $linkedid,
	);
	$dst_query = $dbh->prepare("SELECT `dst` FROM `cdr` WHERE `linkedid` =:lid LIMIT 1");
	$dst_query->execute($ph_array);
	while ($dst_result = $dst_query->fetch(PDO::FETCH_ASSOC)) {
		$dst = $dst_result["dst"];
	}
	$data = create_array_of_parameters($call_type, $callerid_num, $dst);
	$params = array(
		"direction"      => $data['type'],
		"operator_phone" => $data['operator'],
		"client_phone"   => $data['client'],
		"unique_id"      => $linkedid,
		"call_time"	     => $call_start,
		"answer_time"    => $answer_start,
		"end_time" 	     => $call_end,
		"operator_audio" => new cURLFile($filedir . $callfile_out, 'audio/ogg', $callfile_out),
		"client_audio"	 => new cURLFile($filedir . $callfile_in, 'audio/ogg', $callfile_in),
	);
	request_imotio($params);
	function create_array_of_parameters($call_type, $callerid_num, $dst) {
		if ($call_type == 'INBOUND') {
			$type = 'inbound';
			$client = $callerid_num;
			$operator = $dst;
		} else {
			$type = 'outbound';
			$client = $dst;
			$operator = $callerid_num;
		}
		return array('type' => $type, 'client' => $client, 'operator' => $operator);
	}
	function request_imotio ($params) {
		$ch = curl_init();
    	curl_setopt($ch, CURLOPT_HTTPHEADER, array('X-Auth-Token: ' . IMOTIO_TOKEN));
		curl_setopt($ch, CURLOPT_POST, true);
		curl_setopt($ch, CURLOPT_SAFE_UPLOAD, true);
		curl_setopt($ch, CURLOPT_POSTFIELDS, $params);
		curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
		curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
		curl_setopt($ch, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_1);
		curl_setopt($ch, CURLOPT_URL, IMOTIO_URL . 'process_call');
		curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
		$out = curl_exec($ch);
		curl_close($ch);
		$open = fopen('/tmp/result.txt', 'w') or die("не удалось открыть файл");
		fwrite($open, $out);
		fclose($open);
	}
?>

Рассмотрим, что написали:

Объявили наш IMOTIO_TOKEN, его можно взять в личном кабинете (Профиль -> Настройка профиля -> API-токены).

Также поддерживается авторизация по логину и паролю.

Далее, в IMOTIO_URL указываем статичную часть необходимого нам URL. Также константами объявляем логин и пароль для подключения к БД.

Подключаемся к базе asteriskcdrdb, присваиваем нужные значения переменным, в базе по linkedid находим dst-номер. Далее формируем массив данных, которые будут отправляться в IMOTIO. Переходим к функциям.

Функций 2:

• функция создания массива динамических параметров на основе типа звонка (create_array_of_parameters);
• функция передачи данных в IMOTIO (request_imotio).

Подробно рассмотрим каждую функцию.

Функция create_array_of_parameters

При вызове данной функции передаём в неё такие параметры:

• call_type – тип вызова (входящий или исходящий);
• callerid_num;
• dst.

Здесь делаем проверку на тип вызова. Если call_type = INBOUND, то в type прописываем inbound, в client присваиваем номер клиента, содержащийся в переменной callerid_num, а в operator — номер сотрудника (dst). Иначе прописываем в type outbound, в client – dst, а в operator – callerid_num соответственно.

После через return возвращаем необходимые параметры.

Функция request_imotio

При вызове данной функции передаём в неё уже готовый массив данных params. В нём содержатся все данные для отправки в IMOTIO.
В функции инициируем передачу данных методом POST через CURL. В качестве логирования в конце функции ведём запись в файл. Передача считается удачной, если приходит в ответ task_id – ID задачи на распознавание, call_id – ID звонка в базе IMOTIO.

Дополнение

В сервис через несколько uniqueid можно передать перевод вызова. Однако, у нас одна общая запись разговора, и с отображением могут быть проблемы. Если нужно смотреть, на кого был перевод, можно сделать следующее:

• В extensions_custom.conf в [from-transer-safe] для паттерна _. до Goto добавить наследуемую переменную ${TRANSFERNUM}=${EXTEN};
• Передать TRANSFERNUM ещё одной переменной в скрипт;
• Добавить в operator (для наглядности можно использовать конструкцию типа operator -> transfer. Далее по диалогу можно будет отличить, состоялся перевод или нет, как общались с клиентом.