Александр Мисюрин
24.09.2020
3847

Сервисные коды управления динамическими конференциями

В данной статье рассмотрим возможность управления конференциями с помощью сервисных кодов, для их реализации необходимо выполнить ряд действий: Создание своих сервисных кодов Написание скриптов php для работы с ami Написание кастомного диалплана направления в эти скрипты Опираться будем на эту статью. В частности просто допишем в скрипт обработчики различных действий: Mute/Unmute пользователя Выкинуть пользователя Запретить […]

Сервисные коды управления динамическими конференциями - VoxLink

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

  • Создание своих сервисных кодов
  • Написание скриптов php для работы с ami
  • Написание кастомного диалплана направления в эти скрипты

Опираться будем на эту статью. В частности просто допишем в скрипт обработчики различных действий:

  1. Mute/Unmute пользователя
  2. Выкинуть пользователя
  3. Запретить вход для пользователя
Тестирование проводилось на системе CentOs 6.9, Asterisk 13, FreePBX 13, PHP 5.6.40

В прошлой настройке добавляли пункт меню конференции, для приглашения нового участника. Добавим пункт для вывода тестовой информации:

Файл

/etc/asterisk/confbridge_custom.conf
[default_menu]
type = menu
*5=dialplan_exec(conference_sc,conference_add,1)
*6=dialplan_exec(conference_sc,conference_mute,1);вывод информации
Тестовая информация по каналу админа
Вывод тестовой информации по каналу админа
  1. Включение/отключение звука пользователей

Приступим к написанию обработчика звука:

$mark=$argv[1];
if ($mark == 4){
$muted = $argv[2];
$confnum = $argv[3];
$num = $argv[4];
if ($muted=='mute'){
	$actionmark='ConfbridgeMute';
} else $actionmark='ConfbridgeUnmute';
	$action = "Action: ConfbridgeList\r\n";
	$action .= "Conference: $confnum\r\n\r\n";
	$amistr=ami_request($action);
	$amiarr=str_to_arr($amistr);
	foreach ($amiarr as $value) {
		if (isset($value['Event']) && $value['Event']=='ConfbridgeList') {
			if (stristr($value['Channel'],$num)) {
				$channel=$value['Channel'];
				$action = "Action: $actionmark\r\n";
				$action .= "Conference: $confnum\r\n";
				$action .= "Channel: $channel\r\n\r\n";
				ami_request($action);
			}
		}
	}
}
Усложняется тем, что в Action необходимо отправить не просто номер, который хотим заглушить, а его канал, для этого необходимо получить список участников конференции и из него нужный канал.

Функция ami_request:

function ami_request($ingect){
  $answer=false;
  if ($socket = fsockopen(AMI_HOST, AMI_PORT, $ac_err_num, $ac_err_msg, 1)){
    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";
    fwrite($socket,$action);
    sleep(1);
    $answer = fread($socket,8291);
    fclose($socket);
  }
  return $answer;
}

Далее сервисный, который вел на вывод тестовой информации, разворачиваем на отправку в скрипт. Также добавляем еще один сервисный код, для снятия заглушки (с меткой unmute).

В контекст [conference_sc] добавляем:

exten => conference_mute,1,Read(MUTENUM,dial,11,i);
same => n,System(/usr/bin/php /opt/conference.php 4 mute ${CONFNUM} ${MUTENUM});

exten => conference_unmute,1,Read(MUTENUM,dial,11,i);
same => n,System(/usr/bin/php /opt/conference.php 4 unmute ${CONFNUM} ${MUTENUM});

В файл /etc/asterisk/confbridge_custom.conf

*7=dialplan_exec(conference_sc,conference_unmute,1)
Отключения звука пользователю
Отключаем звук пользователю
Включение звука пользователю
Включаем звук пользователю
Можно не добавлять новый сервисный код, а в первом добавить еще один запрос при вводе номера заглушить/включить звук.

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

2. Удаление пользователей из конференции

Новая часть кода:

if ($mark == 5){
$confnum = $argv[2];
$num = $argv[3];
	$action = "Action: ConfbridgeList\r\n";
	$action .= "Conference: $confnum\r\n\r\n";
	$amistr=ami_request($action);
	$amiarr=str_to_arr($amistr);
	foreach ($amiarr as $value) {
		if (isset($value['Event']) && $value['Event']=='ConfbridgeList') {
			if (stristr($value['Channel'],$num)) {
				$channel=$value['Channel'];
				$action = "Action: ConfbridgeKick\r\n";
				$action .= "Conference: $confnum\r\n";
				$action .= "Channel: $channel\r\n\r\n";
				ami_request($action);
			}
		}
	}	
}

В диалплане:

exten => conference_kick,1,Read(KICKNUM,dial,11,i);
same => n,System(/usr/bin/php /opt/conference.php 5 ${CONFNUM} ${KICKNUM});
Способ удаления пользователя из конференции
Удаление пользователя из конференции

3. Запрет на подключение

Далее реализуем запрет подключения в данную конференцию и его снятие, используем механизм с вводом 0/1 для запрета/разрешения соответственно.

При необходимости вместо этого, можно реализовать 2 сервисных кода.

Диалплан:

exten => conference_lock,1,Read(LOCKMARK,dial,1,i);
same => n,System(/usr/bin/php /opt/conference.php 6 ${LOCKMARK} ${CONFNUM});

Скрипт:

if ($mark == 6){
$lckconf=$argv[2];
$confnum = $argv[3];
if ($lckconf == 0) {
	$action = "Action: ConfbridgeLock\r\n";
} else $action = "Action: ConfbridgeUnlock\r\n";
$action .= "Conference: $confnum\r\n\r\n";
ami_request($action);
}
Наличие запрета    на подключение в конфигурацию
Запрет на подключение в конференцию
Возможность разрешения на подключение в конференцию
Разрешение на подключение в конференцию

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

Кейсы внедрения
Asterisk от VoxLink
Узнайте, какие крупные компании уже используют Asterisk в работе.
Скачать
Подписаться
Уведомить о
guest
0 комментариев
Межтекстовые Отзывы
Посмотреть все комментарии

Остались вопросы?

Я - Першин Артём, менеджер компании Voxlink. Хотите уточнить детали или готовы оставить заявку? Укажите номер телефона, я перезвоню в течение 3-х секунд.

VoIP оборудование


ближайшие курсы

10 доводов в пользу Asterisk

Распространяется бесплатно.

Asterisk – программное обеспечение с открытым исходным кодом, распространяется по лицензии GPL. Следовательно, установив один раз Asterisk вам не придется дополнительно платить за новых абонентов, подключение новых транков, расширение функционала и прочие лицензии. Это приближает стоимость владения станцией к нулю.

Безопасен в использовании.

Любое программное обеспечение может стать объектом интереса злоумышленников, в том числе телефонная станция. Однако, сам Asterisk, а также операционная система, на которой он работает, дают множество инструментов защиты от любых атак. При грамотной настройке безопасности у злоумышленников нет никаких шансов попасть на станцию.

Надежен в эксплуатации.

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

Гибкий в настройке.

Зачастую возможности Asterisk ограничивает только фантазия пользователя. Ни один конструктор шаблонов не сравнится с Asterisk по гибкости настройки. Это позволяет решать с помощью Asterisk любые бизнес задачи, даже те, в которых выбор в его пользу не кажется изначально очевидным.

Имеет огромный функционал.

Во многом именно Asterisk показал какой должна быть современная телефонная станция. За многие годы развития функциональность Asterisk расширилась, а все основные возможности по-прежнему доступны бесплатно сразу после установки.

Интегрируется с любыми системами.

То, что Asterisk не умеет сам, он позволяет реализовать за счет интеграции. Это могут быть интеграции с коммерческими телефонными станциями, CRM, ERP системами, биллингом, сервисами колл-трекинга, колл-бэка и модулями статистики и аналитики.

Позволяет телефонизировать офис за считанные часы.

В нашей практике были проекты, реализованные за один рабочий день. Это значит, что утром к нам обращался клиент, а уже через несколько часов он пользовался новой IP-АТС. Безусловно, такая скорость редкость, ведь АТС – инструмент зарабатывания денег для многих компаний и спешка во внедрении не уместна. Но в случае острой необходимости Asterisk готов к быстрому старту.

Отличная масштабируемость.

Очень утомительно постоянно возвращаться к одному и тому же вопросу. Такое часто бывает в случае некачественного исполнения работ или выбора заведомо неподходящего бизнес-решения. С Asterisk точно не будет такой проблемы! Телефонная станция, построенная на Asterisk может быть масштабируема до немыслимых размеров. Главное – правильно подобрать оборудование.

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

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

Снижает расходы на связь.

Связь между внутренними абонентами IP-АТС бесплатна всегда, независимо от их географического расположения. Также к Asterisk можно подключить любых операторов телефонии, в том числе GSM сим-карты и настроить маршрутизацию вызовов по наиболее выгодному тарифу. Всё это позволяет экономить с первых минут пользования станцией.