Курсы по использованию Asterisk

IP-телефония — технология будущего. Обучитесь работе с IP-АТС Asterisk для того чтобы внедрить и профессионально использовать при решении коммуникационных задач.

Работайте с Asterisk профессионально!

Многоуровневая защита IP-АТС Asterisk

Телефонные станции очень часто становятся объектами хакерских атак. Узнайте, каким образом необходимо строить многоуровневую защиту для Вашей IP-АТС.

Не оставьте хакерам шансов. Защитите свой Asterisk от атак.

Используйте Веб-Интерфейс для удобства настройки

Панель управление FreePBX позволяет легко и удобно управлять всей системой. Научитесь эффективно использовать FreePBX для решения своих задач.

Управление станцией и статистика в окне браузера.

Научитесь работать с Asterisk из консоли

Для понимания работы с Asterisk необходимо уметь настраивать его вручную с конфигурационными файлами и командной строкой CLI Asterisk.

Научитесь «тонкой» настройке Asterisk

Цель курсов - максимум практики.

Обучение нацелено на практическую работу с IP-оборудованием: платы потоков E1, VoIP-телефонные аппараты, голосовые шлюзы FXS и прочее.

Обучение на реальном оборудовании — залог успеха.

Click-call или звонок из web

База знаний Настройка Asterisk

В этой статье будет описан механизм реализации функции click-call, или как его еще принято называть в CRM-системах «вызов из карточки клиента».

Ресурсы

⦁ Настроенный веб сервер, php версии 5.6 и выше
⦁ Доступ к диалплану Asterisk
⦁ Доступ к AMI Asterisk


Задача: осуществить вызов номера клиента в один клик, с уведомлением если номер текущего оператора занят, при этом идентифицировать каждый звонок по карточкам клиентов.

Принципиальная схема работы

⦁ Заходим в нужную страницу (карточку)
⦁ Кликаем на записанном номере клиента
⦁ Алгоритм средствами AMI и PHP проверяет занятость оператора
⦁ Если оператор занят выводим оповещение и завершаем алгоритм
⦁ Если свободен вызываем оператора, до ответа в канал
⦁ Навешиваем созданному каналу UID карточки клиента
⦁ Вызываем клиента и по ответу объединяем каналы – состоится разговор
⦁ По завершении разговора, отлавливаем UID и записываем в дополнительное поле CDR-таблицы

Реализация


На стороне CRM


Набросаем простую тестовую страницу для демонстрации работы (все файлы можно будет найти в закрепленном архиве)
Её код имеет следующий вид:

<!DOCTYPE html>
<html>
<head>
<title>Clicl_to_call</title>
<link rel='shortcut icon' href='favicon.png' type='image/png'>
<link rel='stylesheet' type='text/css' href='style.css'>
</head>
<meta charset='utf-8'>
<body class='body'>
<form action='' method='post'>
Источник вызова (оператор)<input type='number' name='src' /><br />
Назначение вызова (клиент)<input type='number' name='dst' /><br />
<button type='submit' name='init_call' value='send'>Позвонить</button><br />
</form action='' method='post'>
</body>
</html>
<?php

require_once "settings.php";
require_once "core_function.php";

//echo "<pre>".print_r($_POST,true)."</pre>";

if(isset($_POST['init_call'])){
if (ami_is_busy($_POST['src'])){
ami_call($_POST['src'],$_POST['dst'],'-=#'.date("H:i:s").'#=-');
echo "<h1>Свободно!</h1>";
}
else{
echo "<h1>Занято!</h1>";
}
}

?>

Не смотря на смешанное содержимое файл следует сохранить с расширением *.php
В итоге должно получится следующее:

Тестовая страница

Поскольку страница тестовая, здесь мы будем указывать и номер оператора и номер абонента.


Подключаемые файлы разберем чуть позже.


Закомментированный фрагмент:

//echo "<pre>".print_r($_POST,true)."</pre>";

Позволяет отобразить переданные формой аргументы для проверки их корректности. Отладка в действии выглядит следующим образом:

Передача аргументов

Источник – 712, назначение 102, форма была отправлена успешно – что и требовалось. Далее присутствует обработчик нажатия, который вызывает функцию проверки занятости оператора и в зависимости от результата вызывает инициирует вызов, либо уведомляет о невозможности такого.


Остановимся подробнее на самих функциях проверки и вызова. Они содержатся в отдельном файле и имеют следующий код:

function ami_request($ingect){
$answer = '';
$socket = fsockopen(ami_host, ami_port, $ac_err_num, $ac_err_msg, 1);
if ($socket){
stream_set_timeout($socket, 1);
$action = "Action: login\r\n";
$action .= "Username: ".ami_user."\r\n";
$action .= "Secret: ".ami_pass."\r\n\r\n";
$action .= $ingect;
$action .= "Action: Logoff\r\n\r\n";

//echo str_replace("\r\n","<br />",$action);

fwrite($socket,$action);
sleep(1);
$answer = fread($socket,8192);
fclose($socket);
}
//echo str_replace("\r\n","<br />",$answer);
return $answer;
}

function ami_peer_status($exten){
$res=ami_request("Action: CoreShowChannels\r\n\r\n");
if(strpos($res,$exten)){
$st=strpos($res,'Local/');
$fn=strpos($res,'ChannelState')-2;
return substr($res,$st,$fn-$st);
}
else{
return '';
}
}

function ami_call($num_from, $num_to, $taskId){
$action = "Action: Originate\r\n";
$action .= "Channel: Local/$num_from@ext-local\r\n";
$action .= "Callerid: CRM\r\n";
$action .= "Timeout: 15000\r\n";
$action .= "Context: from-internal\r\n";
$action .= "Exten: $num_to\r\n";
$action .= "Priority: 1\r\n";
$action .= "Async: yes\r\n\r\n";
if($taskId != ''){
$channel = ami_peer_status($num_from);
$action .= "Action: Setvar\r\nChannel: $channel\r\nVariable: USERFIELD\r\nValue: $taskId\r\n\r\n";
}
$res = ami_request($action);
echo "<h2>".$taskId."</h2>";
return $res;
}

function ami_is_busy($exten){
$res = ami_peer_status($exten);
if($res != ''){
return false;
}else{
return true;
}
}

Опишем функции по порядку:


ami_request – выполняет обращение на сервер посредством AMI, передает на выполнение указанный в единственном аргументе ряд команд и возвращает результат выполнения.
ami_peer_status – обращается через функцию описанную выше на сервер и получает список активных каналов. В зависимости от наличия в нём внутреннего номера, переданного в качестве аргумента, возвращается пустое значение или имя канала.


ami_call – через AMI отправляет команду Originate для вызова и соединения двух номеров, а так же назначает дополнительную переменную каналу – которая будет отвечать за UID карточки клиента и записываться в CDR.


ami_is_busy – проверяет занятость оператора по номеру и возвращает булев тип значения.


Если раскрыть комментарии можно увидеть запрос и ответ AMI. Получится примерно следующее:

АМИ обращение

Смысл выделенных фрагментов:


При выполнении запроса на список каналов, авторизация пройдена успешно, запрос выполнен, в результате 0 активных каналов.

АМИ вызов

Выполняем вызов с 712го номера на 102, посредством логики АТС, добавляем каналу новую переменную, и устанавливаем ее равной текущему времени (для примера).


Демонстрация работы:

На стороне АТС


Звонок проходит. Оператор отвечает, идет вызов клиента, происходит разговор. Но это еще не всё. Требуется отловить новую переменную канала и записать в CDR, для этого дополним диалплан. Открываем ssh, находим в файле /etc/asterisk/extensions_additional.conf контекст


[macro-hangupcall]


И копируем файл /etc/asterisk/extensions_override_freepbx.conf всё, что касается экстеншена «s».


После чего добавляем в первый приоритет новую строчку:

exten => s,1,ExecIf($["${CDR(cnam)}"="CRM"]?Set(CDR(userfield)=${USERFIELD}))

Должно получится что-то похожее:

[macro-hangupcall]
include => macro-hangupcall-custom
exten => s,1,ExecIf($["${CDR(cnam)}"="CRM"]?Set(CDR(userfield)=${USERFIELD}))
exten => s,n,Set(CHANNEL(hangup_handler_wipe)=for-sox,s,1)
exten => s,n,ExecIf($["${CALLFILENAME}"!="" & "${CDR(recordingfile)}"=""]?Set(CDR(recordingfile)=${CALLFILENAME}.wav-mix.${MON_FMT})) //запись нового файла в CDR
exten => s,n(start),GotoIf($["${USE_CONFIRMATION}"="" | "${RINGGROUP_INDEX}"="" | "${CHANNEL}"!="${UNIQCHAN}"]?theend)
exten => s,n(delrgi),Noop(Deleting: RG/${RINGGROUP_INDEX}/${CHANNEL} ${DB_DELETE(RG/${RINGGROUP_INDEX}/${CHANNEL})})
exten => s,n(theend),ExecIf($["${ONETOUCH_RECFILE}"!="" & "${CDR(recordingfile)}"=""]?Set(CDR(recordingfile)=${ONETOUCH_RECFILE}))
exten => s,n,Hangup
exten => s,n,MacroExit()

Выходим, перечитываем диалплан и проверяем наличие нашей новой команды:

Диалплан

Тестируем. Производим вызов и запоминаем выведенное значение на странице.

Присвоение UID

Проверяем наличие в CDR

Проверка UID в CDR

Вот теперь звонок можно отследить и закрепить за определенной карточкой.

asterisk, тип, отладка, Call-файл, FreePBX, Channel, for, call, callerid