Управление вызовами из внешнего приложения

Как заставить астериск выполнить вызов из другой программы? Есть несколько способов, их подробное описание можно прочитать на сайте asterisk.ru в этой статье.

Ниже будет рассмотрен способ с помощью call-файлов.

Нужно поместить текстовый файл с расширением .call, содержащий параметры вызова, в папку /var/spool/asterisk/outgoing. Следует сначала создать файл в другой папке, а затем переместить его в папку /var/spool/asterisk/outgoing, чтобы астериск не прочитал не до конца записанный файл (в момент его записи).

Например, можно создавать файлы в папке /var/spool/asterisk/myfolder, а затем перемещать их:

mv /var/spool/asterisk/myfolder/*.call /var/spool/asterisk/outgoing/

После обработки файла .call (после завершения вызова или выполнения заданного кол-ва попыток) астериск его удалит. Поэтому у пользователя, под которым работает астериск, должны быть права на изменение call-файла.

Примеры call-файлов

Пример 1: call-файл для вызова с локального абонента на внешнего:

# Вызов с локального SIP-абонента 1002 на номер 1501
# Сначала астериск звонит на 1002
# В CallerID указать идентификатор и номер, который будет высвечиваться у абонентов
# Указать номер, на который абоненты могут перезвонить, увидев пропущенный вызов,
# например, номер кол-центра. С номера, указанного в CallerID, должны быть разрешены
# вызовы в контексте, указанном в параметре Context

Channel: PJSIP/1002
CallerID: Call from call-center <1009>
MaxRetries: 2
RetryTime: 60
WaitTime: 30

# Когда 1002 поднял трубку, астериск звонит на 1501
# Выполнение исходящего вызовова происходит в контексте [phones]

Context: phones
Extension: 1501
Priority: 1

Пример 2: call-файл для вызова с внешнего абонента на внешнего:

# Вызов с внешнего номера 89XXXXXXXXX на номер 89YYYYYYYYY
# Сначала астериск звонит на 89XXXXXXXXX

Channel: PJSIP/89XXXXXXXXX@somepbx
CallerID: Call from call-center <1009>
MaxRetries: 1
RetryTime: 60
WaitTime: 30

# Когда 89XXXXXXXXX поднял трубку, астериск звонит на 89YYYYYYYYY
# Выполнение исходящего вызовова происходит в контексте [phones]

Context: phones
Extension: 89YYYYYYYYY
Priority: 1

Выполнение вызова из браузера

Можно заставить астериск выполнить вызов с одного номера на другой с помощью браузера. Для этого понадобится файл html — страница с формой для введения телефонных номеров, которые нужно соединить, и файл php — скрипт, который создаст call-файл с указанными номерами и переместит его в папку outgoing. На сервере должны быть установлены веб-сервер и PHP (как это сделать, можно прочитать здесь).

Html-файл нужно разместить в папке, в которой лежат все файлы сайта.

Пример html-файла:

<html>
  <head>
    <title>Звонок из браузера</title>
  </head>
  <body>
    <form action="call.php" method="post">
      <p><label>Ваш номер:<br><input name="anum"></label></p>
      <p><label>Кому позвонить:<br><input name="bnum"></label></p>
      <p><input type="submit" value="Позвонить"></p>
    </form>
  </body>
</html>

В этом примере при нажатии на кнопку «Позвонить» управление передаётся файлу call.php, в параметрах anum и bnum передаются номера соответственно первого и второго абонента. Файл call.php должен находиться в той же папке, что и вызывающий его файл (либо нужно указать путь, где он находится).

Пример php-файла, обрабатывающего запрос:

<html>
  <head>
    <title>Звонок из браузера</title>
  </head>
  <body>

<?php

$dir = '/var/spool/asterisk/myfolder/';
$dir2 = '/var/spool/asterisk/outgoing/';
$fn = "php" . date('His') . ".call";

$anum = $_POST['anum'];
$bnum = $_POST['bnum'];
echo "    <p>Астериск выполнит вызов с номера $anum на номер $bnum.</p>\n";

$text  = "Channel: PJSIP/$anum\n";
$text .= "CallerID: Call from call-center <1009>\n";
$text .= "Context: phones\n";
$text .= "Extension: $bnum\n";
$text .= "Priority: 1";

$file = fopen($dir . $fn, 'w'); 
fwrite($file, $text . "\n");
fclose($file);

$cmd = "mv $dir$fn $dir2$fn";
shell_exec($cmd);

?>

    <input type="button" onclick="history.back();" value="Назад"/>
  </body>
</html>

Нужно правильно настроить права доступа к папкам и файлам, с которыми будут работать астериск и php-скрипт: php-скрипт должен иметь возможность создавать и перемещать call-файлы, а астериск — читать и удалять их.

Php-сервер работает с файлами под пользователем www-data, а астериск — под пользователем asteriskpbx. Нужно создать новую группу, добавить в неё обоих пользователей, указать новую группу для нужных папок и разрешить изменение файлов в этих папках пользователям, входящим в группу.

Создать группу callfiles и добавить в неё обоих пользователей:

sudo groupadd callfiles
sudo usermod -aG callfiles asteriskpbx
sudo usermod -aG callfiles www-data

Проверить (посмотреть, в какие группы входят пользователи asteriskpbx и www-data):

id -Gn asteriskpbx
id -Gn www-data

Пользователь начинает входить в новую группу только после его перелогирования. Если речь идёт о пользователях, под которыми работают различные сервисы, то нужно перезагрузить сервер:

sudo reboot

Изменить группу на callfiles у папок outgoing и myfolder:

chgrp -R callfiles /var/spool/asterisk/myfolder/
chgrp -R callfiles /var/spool/asterisk/outgoing/

Добавить для группы callfiles права на запись в папки outgoing и myfolder:

sudo chmod -R 2775 /var/spool/asterisk/myfolder/
sudo chmod -R 0775 /var/spool/asterisk/outgoing/

Для папки myfolder цифра 2 в значении параметра означает, что все новые файлы, создаваемые в этой папке, будут наследовать группу от папки (т.е. callfiles) (то же самое делает команда chmod g+s)

В результате создаваемые php-скриптом call-файлы будут принадлежать не к первичной группе владельца файла (www-data), а к группе callfiles, а также иметь разрешение на изменение для пользователей, входящих в группу (это пользователи www-data и asteriskpbx). Поэтому и php-сервер, и астериск смогут изменять, перемещать или удалять эти файлы. Php-сервер сможет создать call-файл и переместить его в папку outgoing, а астериск — обработать call-файл (т.е. выполнить телефонные вызовы) и затем удалить.