Кастомизация входящей маршрутизации

Иногда входящие вызовы, поступающие с внешних номеров (городских и мобильных) необходимо направлять на общую очередь (группу номеров) только при условии выполнения/невыполнения соответствующих условий. Например, если на номер звонящего ранее были совершены вызовы с какого-либо добавочного (101), то входящий вызов должен поступить на добавочный 101, и, если этот добавочный не ответил/занят/недоступен – то на общую очередь.

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

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

Во входящих маршрутах для каждого из имеющихся номеров определим назначение для входящих вызовов (в примере — контекст custom-inbound)

Также, во входящих маршрутах указываем параметры записи разговоров.

В панели управления перейти Admin (Администрирование) -> Custom destinations (Пользовательский диалплан)

Модуль Custom destinations позволяет указать в админ-панели диалплан, добавленный в файле /etc/asterisk/extensions_custom.conf

Указываем пользовательский диалплан (контекст,экстеншен,приоритет) куда будут попадать входящие вызовы.

Добавляем две очереди напр. 500 (очередь с добавляемым скриптом агентом, который совершал исходящий звонок последним) и 600 (общая очередь).

Изменяем параметры очереди 500 – для пропуска агента если он занят или разговаривает устанавливаем опцию Skip Busy Agents (Пропускать занятых) в Yes + (ringinuse=no). Стратегия очереди в данном случае может быть любая т.к. в ней подразумевается максимум 1 агент. Если необходимо вызывать агентов очереди без учета переадресаций или настроек follow me -установить опцию Agent Restrictions в No Follow-Me or Call Forward.

Также, на вкладке Timing and Agent options, где настраиваются параметры пребывания вызова в очереди (Max Wait Time) и Agent Timeout (Таймаут агента) указываем время ожидания и таймаут агента (например 30 сек/30 сек).

На вкладке Capacity Options (Емкость очереди) указываем параметры Join Empty (Присоединяться к пустой) Leave empty (покидать пустую) в Ultra Strict (Очень строгий), чтобы во всех случаях, когда агент (ранее совершавший исходящие на номер звонящего) будет недоступен или не сможет принять вызов сразу вызов проходил далее (на общую очередь).

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

Про более подробный обзор функционала очередей см. статью «Обзор функционала очередей FreePBX 13».

В очереди необходимо указать Fail Over Destination (назначение по неответу или истечению срока пребывания в очереди) пользовательский диалплан custom-inbound-failover, который также необходимо добавить в модуле Custom Destinations

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

Указываем ее агентов (все внутренние)

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

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

В файл /etc/asterisk/extensions_custom.conf добавляем контексты custom-inbound и custom-inbound-failover. Если необходимо еще проигрывать приветствие и донабирать добавочных можно совершать предварительно переход в IVR – в примере ivr-1 Goto(ivr-1,s,1)

При переходе с помощью Goto в какую-либо очередь в диалплане также необходимо определить переменную __NODEST. Если такая переменная не определена будет происходить зацикливание в этой очереди (и появится избыточность записей в логах).

Содержимое /etc/asterisk/extensions_custom.conf

[custom-inbound]
exten => s,1,NoOp(If number was dialed earlier - to corresponding extension)
exten => s,n,AGI(check-inbound-call.php)
exten => s,n,NoOp(Go to IVR and queue 500)
exten => s,n,Goto(ivr-1,s,1)

[custom-inbound-failover]
exten => s,1,NoOp(No answer - remove members from queue 500 and go to common queue)
exten => s,n,AGI(remove-members-from-queue.sh,500)
exten => s,n,Set(__NODEST=600)
exten => s,n,Goto(from-queue,600,1)
;exten => s,n,Queue(600,Tt)

В директории /var/lib/asterisk/agi-bin/ создаем скрипты для проверки базы звонков и добавления оператора в очередь и для удаления агентов из кастомизированной очереди (при выходе из нее).

Скрипт check-inbound-call.php:

#!/usr/bin/php -q
<?php
set_time_limit(3);
require('phpagi.php');
//error_reporting(0);

$stdin = fopen('php://stdin', 'r');
$stdout = fopen('php://stdout', 'w');
$agi = new AGI();
$cid = $agi->request['agi_callerid'];
$link = mysqli_connect("127.0.0.1", "freepbxuser", "password", "asteriskcdrdb");
if(substr($cid,1)=='+'){
	$cid = substr($cid,3);
}
//$query = "SELECT cnum FROM `cdr` WHERE `dst` = '" . $cid . "' ORDER BY calldate DESC LIMIT 1";
$query = "SELECT cnum FROM `cdr` WHERE `dst` LIKE '%" . $cid . "' ORDER BY calldate DESC LIMIT 1";
if ($result = mysqli_query($link, $query)) {
    while ($row = mysqli_fetch_row($result)) {
	$agi->exec("NOOP", $row[0]);
	echo $row[0];
	$last_office_caller_to_cid = $row[0];
	$cmd = 'asterisk -rx \'queue add member SIP/' . $last_office_caller_to_cid  . ' to 500 penalty 0 as ' .  $last_office_caller_to_cid . '\'';
	exec($cmd);
	var_dump($cmd);
    }
    /* очищаем результирующий набор */
    mysqli_free_result($result);
}
mysqli_close($link);
fclose ($stdin);
fclose ($stdout);
exit(0);
?>

С помощью set_time_limit() можно ограничить время выполнения скрипта – если поиск будет производиться слишком долго произойдет прохождение входящего вызова далее.

Для подключения к базе использовать пользователя freepbxuser (пароль к нему можно посмотреть в /etc/freepbx.conf).

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

SELECT cnum FROM `cdr` WHERE `dst` = '" . $callerid . "' ORDER BY calldate DESC LIMIT 1

Но, если callerid при входящих могут приходить с различными префиксами, или ранее набранный номер был немного в другом формате – производить поиск по подстроке, а не сравнение полей целиком.

SELECT cnum FROM `cdr` WHERE `dst` LIKE '%" . $callerid . "' ORDER BY calldate DESC LIMIT 1

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

См. статью об Adminer.

Скрипт remove-members-from-queue.sh

#!/bin/sh
if [ "$*" == "" ]; then
  echo "parameters: $0 queue1 queue2 queue3 ..."
  exit
fi
for i in  $*
do
  CNTR=`/usr/sbin/asterisk -rx "queue show ${i}" | awk 'NR>=3{print $1}'`
  for j in ${CNTR}
  do
echo `/usr/sbin/asterisk -rx "queue remove member SIP/${j} from ${i}" > /dev/null 2>&1`
  done
done

Для тестирования совершим исходящий на какой-л. внешний номер, а потом позвоним с него на любой из имеющихся на атс внешних номеров.

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

Для включения отладки AGI в консоли Asterisk необходимо набрать.

CLI>agi set debug on

Если в базе будет запись, о том, что какой-либо добавочный совершал исходящие на номер звонящего – вызов пойдет на очередь 500 с этим динамическим агентом, а по неответу – на общую очередь.

Для проверки удаления из очереди для кастомизации входящих вызовов (500), еще раз позвоним и сбросим.

Агентов очереди можно посмотреть командой

asterisk -rx ‘queue show 500’

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