Александр Мисюрин
06.11.2019
585

Редактирование состава ринг группы по звонку

В некоторых схемах маршрутизации используются ринг группы asterisk, добавление и удаление операторов в которые происходит через веб-интерфейс FreePBX, однако иногда нужно дать доступ какому либо пользователю редактировать одну из созданных ринг групп. Однако стандартный функционал FreePBX позволяет ограничивать пользователей доступом к модулям, что в данной ситуации не подходит. Рассмотрим вариант реализации редактирования состава ринг групп […]

Редактирование состава ринг группы по звонку

В некоторых схемах маршрутизации используются ринг группы asterisk, добавление и удаление операторов в которые происходит через веб-интерфейс FreePBX, однако иногда нужно дать доступ какому либо пользователю редактировать одну из созданных ринг групп. Однако стандартный функционал FreePBX позволяет ограничивать пользователей доступом к модулям, что в данной ситуации не подходит. Рассмотрим вариант реализации редактирования состава ринг групп звонком, на какой либо сервисный код или номер.

Все настройки проводились на системе: CentOS 6.9, Asterisk 13.21.0, FreePBX 13 PHP PHP 5.6.

В диалплане, который доступен для выбранного внутреннего номера, указываем нужный exten (номер или сервисный код, в данном примере будет код), который отправит нас на выполнение скрипта обработки. Рассмотрим два варианта:

  1. Добавление/удаление номеров в ринг группу списком, с заменой всего списка операторов,
  2. Добавление/удаление номеров в ринг группу посредством голосового меню.

Первый способ предполагает указание в качестве exten списка номеров, начинающихся с номера ринг группы и разделенных «*», например:

exten => _700*XXX.,1,Set(nums=${EXTEN:4});Назначаем список номеров
same => n,Set(numr=${EXTEN:0:3});Назначаем номер группы
same => n,Set(nums=${REPLACE(nums,*,-)});Меняем * на -, поскольку в базе список разделен именно так
same => n,NoOp(Группа:${numr}==Список номеров:${nums});выводим для проверки
Вывод списка номеров и номера группы
Вывод списка номеров и номера группы

Номер группы и список, таким образом, получили, теперь следует отправить их в скрипт для обработки, а именно, для записи в базу и применения конфигурации. Также до запуска скрипта необходимо добавить голосовое меню на запрос необходимого действия (удаление или запись в группу).

Диалплан отправки в скрипт:

[from-internal-custom]
exten => _700*.,1,Set(nums=${EXTEN:4})
same => n,Set(numr=${EXTEN:0:3})
same => n,Set(nums=${REPLACE(nums,*,-)})
same => n,NoOp(Группа:${numr}==Список номеров:${nums})
same => n,Read(mark,ru/custom/mark,10)
same => n,Goto(operator_change,${mark},1)
[operator_change]
exten => _[12],1,System(/usr/bin/php -f /var/lib/asterisk/agi-bin/change_rgroups.php ${numr} ${nums} ${EXTEN})
Cкрипт необходим, поскольку для перечитывания конфигураций может потребоваться довольно долгое время.
function bd_bridge($db,$q){
                $link = @mysqli_connect('localhost','user','password',$db) or die("Error: ".@mysqli_connect_error($link));
                $rs = @mysqli_query($link, $q) or die("Error: ".@mysqli_error($link));
                if($rs){
                        return $rs;
                        @mysqli_free_result($rs);
                }
                else{
                }
                mysqli_close($link);
        }

Для проверки скрипт будем писать последовательно, первая часть – добавление, самое простое, поскольку список номеров из диалплана уже в нужном формате, поэтому просто выводим его и номер группы.

Чтобы не создавать несколько скриптов для каждой задачи, укажем метку, по которой будем ориентироваться. Например, отправлять в скрипт третьим аргументом метку 1 или 2.
if ("$argv[3]" == "1") {
	echo "update ringgroups set grplist='".$argv[2]."' where grpnum='".$argv[1]."';";
	}
Вывод запроса добавления в группу
Вывод запроса добавления в группу

Чтобы добавить в базу, указываем:

$result = bd_bridge('asterisk',"update ringgroups set grplist='".$argv[2]."' where grpnum='".$argv[1]."';");

И проверяем добавление, если все прошло успешно, список в соответствующей таблице обновится.

Обновление в базе
Обновление в базе

Для применения конфигураций, необходимо запустить reload FreePBX:

if ("$argv[3]" == "1") {
	$result = bd_bridge('asterisk',"update ringgroups set grplist='".$argv[2]."' where grpnum='".$argv[1]."';");
	$apply=`/var/lib/asterisk/bin/module_admin reload`;
}
Проверка добавления в группу
Проверка добавления в группу

Для удаления из группы необходимо получаемую строку из диалплана и текущую запись из базы переводить в массив и получать их разность, которую затем добавлять в базу.

Для наглядности выводим все шаги:

if ("$argv[3]" == "2") {
	$result = bd_bridge('asterisk',"select grpnum, grplist from ringgroups where grpnum='".$argv[1]."';");
	$row = mysqli_fetch_array($result); 
	$arraynow = explode ("-",$row[1]);
	$arraydo = explode ("-",$argv[2]);
		echo "Массив сейчас в группе: \n";
		print_r($arraynow);
		echo "Массив из диалплана: \n";
		print_r($arraydo);
		echo "Массив разницы: \n";
		$result = array_diff($arraynow, $arraydo);
		print_r($result);
		$string="";
		foreach ($result as $value) {
			$string.=$value."-";
		}
		$result = bd_bridge('asterisk',"update ringgroups set grplist='".substr($string,0,-1)."' where grpnum='".$argv[1]."';");
		$apply=`/var/lib/asterisk/bin/module_admin reload`;
}
Сравнивать обязательно массив из базы с массивом из диалплана, чтобы в базу не записались случайно введенные лишние номера.
Проверка удаления
Проверка удаления

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

Контекст вызова редактирования группы и контекст запуска скрипта изменяются на следующие:

[from-internal-custom]
exten => *700,1,Set(numr=${EXTEN:1:3})
same => n,NoOp(Группа:${numr})
same => n,Read(mark,ru/custom/mark,10)
same => n,Goto(operator_change_dtmf,${mark},1)

[operator_change_dtmf]
exten => _[12],1,Read(nums,ru/custom/mark,50)
same => n,Set(nums=${REPLACE(nums,*,-)})
same => n,NoOp(Список номеров:${nums})
same => n,System(/usr/bin/php -f /var/lib/asterisk/agi-bin/change_rgroups.php ${numr} ${nums} ${EXTEN})
Поскольку в конце выполнения в скрипт отправится такой же набор данных как и в первом случае, изменять его не требуется.

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

Вывод списка операторов
Вывод списка операторов
Подписаться
Уведомить о
guest
0 комментариев
Межтекстовые Отзывы
Посмотреть все комментарии

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

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

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

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

ближайшие Вебинары

ONLINE

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 сим-карты и настроить маршрутизацию вызовов по наиболее выгодному тарифу. Всё это позволяет экономить с первых минут пользования станцией.