Реализация всплывающих окон по звонку в Slack

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

Ознакомится с функционалом отправки пропущенных звонков вы можете, ознакомившись с постом Отправка уведомлений о пропущенных вызовах в slack

Настройка уведомлений.

Для начала разберемся с всплывающими окнами. Загрузим десктопное приложение на slack в Windows, для этого воспользуемся приложением Microsoft Store.

После этого запускаем приложение и проходим аутентификацию и переходим в настройки профиля. Preferences à Notifications. В данном разделе выбираем, какие настройки оповещений использовать, мы будем использовать настройку «All new messages» (для всех новых сообщений). Пролистываем вниз, в графе Flash window when a notification is received выставляем значение «Always». В графе Deliver notifications via выбираем «Windows Action Center» и в графе When I’m not active on desktop выставляем «значение immediately, even if I’m active».

После всех настроек, сделаем тестовую отправку, например сообщения о пропущенном вызове. Можно выполнить curl запрос прям из консоли Linux, если нет желания выполнять проверочный звонок.  С первого раза сообщение не придёт, т.к. после первой отправки slack внесётся в реестр доверенных приложений для отправки уведомлений. Для того, чтобы убедится, что slack имеет право отправлять уведомления, перейдём в настройки Windows à Система à Уведомления и Действия  и там мы должны увидеть, что для slack разрешено отправлять уведомления.

Настройка отправки записей разговоров.

Для начала нам необходимо создать своего бота, через которого будет выполнятся отправка файлов. Для этого перейдем по ссылке https://api.slack.com/apps и нажмём кнопку Create new APP. Появится следующее сообщение.

После этого перейдем в раздел OAuth & Permissions. В данном разделе нам потребуется записать Bot User OAuth Access Token, который нам пригодится для отправки запроса.

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

После чего slack вас попросит утановить бота и добавить его в чат, делаем по аналогии как делали с incoming WebHook.

Теперь перейдем к настройке со стороны asterisk. Немного модернизируем наш контекст ext-queues и отправка уведомлений о пропущенных, а также отправку файлов, обернем в AGI скрипты. В директории /var/lib/asterisk/agi-bin/ создаем два файла fileslack.php (для отправки файлов) и missedslack.php (для отправки уведомлений о пропущенных). Текст скриптов далее.

fileslack.php
#!/usr/bin/php -q
<?php
require('phpagi.php');
$agi = new AGI(); //подключаем файл phpagi.php – 1 и 2 строки обязательны в любом скрипте
$record = $agi->request['agi_arg_1']; // путь до файла с именем
`/usr/bin/curl   https://slack.com/api/files.upload -F token=xoxb-ваш-токен -F channels=ID_Канала -F file=\@$record -F title=Звонок_из_очереди`;
?>
 
missedslack.php
#!/usr/bin/php -q
<?php
require('phpagi.php');
$agi = new AGI(); //подключаем файл phpagi.php – 1 и 2 строки обязательны в любом скрипте
$cid = $agi->request['agi_callerid']; // берем из AGI номер звонящего
$queue = $agi->request['agi_arg_2']; // номер очереди
`/usr/bin/curl -X POST --data-urlencode 'payload={"channel":"#asterisk","username":"Asterisk Allert","text":" <https://Ваш_адрес/callback.php?phone=$cid&agent=$queue|Перезвонить> \n  Пропущенный в очереди $queue пропущен от $cid","icon_emoji":":warning:"}' https://hooks.slack.com/services/ваш_API`;
?>

Теперь внесем правки в контекст ext-queues

[ext-queues]
exten => h,1,NoOp( ================== lost call in queues ================== )
same => n,ExecIf($["${FORWARD_CONTEXT}"!="from-internal"]?AGI(missedslack.php, ${CALLERID(num)}, ${NODEST})
same => n,ExecIf($["${FORWARD_CONTEXT}"="from-internal"]?AGI(fileslack.php, ${MIXMONITOR_FILENAME})
same => n,Macro(hangupcall,)

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

На этом настройка всплывающих окон и отправка файлов в slack, окончены.