Реализация функционала Click2call из slack

В данной статье мы рассмотрим возможность реализации звонка по клику(click2call) из корпоративного мессенджера slack. Ранее мы уже проводили интеграцию с данным сервисом, чтобы информировать сотрудников о пропущенных звонках, об этом вы можете ознакомится, посетив пост Отправка уведомлений о пропущенных вызовах в slack

Настройка.

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

Диалплан для очереди.

[ext-queues]
exten => h,1,NoOp( ================== lost call in queues ================== )
same => n,ExecIf($["${FORWARD_CONTEXT}"!="from-internal"]?System(/usr/bin/curl -X POST --data-urlencode 'payload={"channel":"#asterisk","username":"Asterisk Allert","text":" <https://ВАШ_ВНЕШНИЙ_АДРЕС/callback.php?phone=${CALLERID(num)}&agent=${NODEST}|Перезвонить> \n  Пропущенный в очереди ${NODEST} пропущен от ${CALLERID(num)}","icon_emoji":":warning:"}' https://hooks.slack.com/services/ВАШ_ТОКЕН))
same => n,Macro(hangupcall,)

Давайте рассмотрим, что у нас поменялось. Мы добавили ссылку на вызов скрипта callback.php, который мы позднее создадим. В нём объявляем значения двух переменных:

FORWARD_CONTEXT — это переменная, которая отвечает за то, достиг ли вызов нужного контекста. При входящем звонке он будет from-internal, когда на вызов ответят.

Phone – номер клиента

Agent – номер очереди

Давайте проверим, отрабатывает ли наш диалплан.

Теперь перейдем в наш чат в slack и проверим, пришло ли уведомление.

Как видим на скриншоте, сообщение поступило, а также доступна ссылка для нажатия, чтобы осуществить click2call.

Проделаем аналогичные операции для IVR.

Диалплан для IVR.

[ivr-1]
exten => h,1,NoOp( ================== lost call in queues ================== )
same => n,ExecIf($["${FORWARD_CONTEXT}"!="from-internal"]?System(/usr/bin/curl -X POST --data-urlencode 'payload={"channel":"#asterisk","username":"Asterisk Allert","text":" <https://ferma.voxlink.ru:2243/callback.php?phone=${CALLERID(num)}&agent=400|Перезвонить> \n  Пропущенный в IVR-main, пропущен от ${CALLERID(num)}","icon_emoji":":warning:"}' https://hooks.slack.com/services/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))
same => n,Macro(hangupcall,)

Опять выполняем проверку и смотрим пришло ли сообщение в slack.

Теперь при помощи любого текстового редактора создадим файл callback.php в директории /var/www/html/.

Внесем туда следующее содержимое:

<?php
define('AMI_HOST', '127.0.0.1');
define('AMI_PORT', '5038');
define('AMI_USER', 'Логин AMI пользователя');
define('AMI_PASS', 'Пароль от AMI пользователя');
define('DEF_ROUT', 'Local/400@ext-queues');
extract($_REQUEST);
function actual($var){
    	return (isset($var) && $var!='' && preg_match('/^[0-9]+$/', $var, $matches, PREG_OFFSET_CAPTURE)) ? true : false;
}
 
if(actual($phone)){
    	$target = (actual($agent)) ? "Local/$agent@from-internal" : DEF_ROUT;
    	$msg  = "Action: Login\r\nUsername: ".AMI_USER."\r\nSecret: ".AMI_PASS."\r\n\r\n";
    	$msg .= "Action: Originate\r\nChannel: $target\r\nContext: outrt-1\r\nExten: $phone\r\nCallerid: Callback <$phone>\r\nTimeout: 30000\r\nPriority: 1\r\nAsync: yes\r\n\r\n";
    	$msg .= "Action: Logoff\r\n\r\n";
 
    	$socket = socket_create(AF_INET, SOCK_STREAM, SOL_TCP) or die("Error : can't create socket");
        socket_connect($socket,AMI_HOST,AMI_PORT) or die("Error : $errstr ($errno)");
    	socket_write($socket, $msg, strlen($msg)) or die("Error : can't write to socket");
    	sleep(1);
    	// echo socket_read($socket, 1024);
    	socket_close($socket);
    	echo '0';
}
echo "<script>window.close();</script>";
?>

Данный скрипт выполняет подключение к AMI и выполняет вызов, согласно нашим заданным переменным phone и agent. Т.е. вызов сперва поступит на внутренний номер или очередь, а после ответа вызов уйдёт до клиента . Обязательно сделайте так, чтобы в очереди был выставлен параметр Queue No Answer, чтобы вызов без ответа оператора не ушел до клиента.

Параметр ‘DEF_ROUT’ отвечает за то, что если у нас в поле agent пустое значение, то обратный звонок уйдет на маршрут по умолчанию.

Запрос echo «<script>window.close();</script>»; — означает, что после нажатия на кнопку Перезвонить, открывшееся окно автоматически закроется.

После того как мы добавили скрипт, можем выполнять click2call по ссылке в чате slack.

На этом настройка завершена.