Asterisk: обратный вызов с использованием AMI

Asterisk Manager Interface (AMI) – это программный интерфейс который позволяет внешним программам как управлять, так и контролировать систему Asterisk. AMI слушает соединения на TCP порту, по-умолчанию это 5038. Клиентская программа может соединяться с AMI, передавать команды в Asterisk, получать ответ о статусе выполнения команд.
В данном посте мы рассмотрим использование AMI на примере решения определенной задачи: настроить Asterisk на генерацию звонков по заданному url, в котором должны устанавливаться параметры звонка.

Настройка Asterisk AMI

Первое что необходимо сделать, это включить AMI и завести пользователя с помощью которого клиентская программа будет аутентифицироваться:

/etc/asterisk/manager.conf

[general] enabled = yes port = 5038 bindaddr = 0.0.0.0 

/etc/asterisk/manager.conf

[c2call] secret=FrUyHn6FSaX deny=0.0.0.0/0.0.0.0 permit=192.168.0.0/255.255.0.0 read=system,call,log,verbose,command,agent,user,config,command,dtmf,reporting,cdr,dialplan,originate write=system,call,log,verbose,command,agent,user,config,command,dtmf,reporting,cdr,dialplan,originate 

Для применения изменений выполним reload:

asterisk -rx "module reload manager" 

Теперь нам потребуется создать внутренний номер который, собственно, и будем соединять с вызываемым абонентом:

/etc/asterisk/sip.conf

[3200] deny=0.0.0.0/0.0.0.0 permit=192.168.0.0/255.255.0.0 secret=3200 dtmfmode=rfc2833 canreinvite=no context=OUT_IN1 host=dynamic type=friend nat=yes port=5060 qualify=yes callcounter=yes faxdetect=no 

После создания внутреннего номера, потребуется перечитать конфигурацию Asterisk:

asterisk -rx "sip reload" 

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

Скрипт обратного вызова

Теперь переходим к созданию скрипта на PHP:

callback.php

<?php  # --- define globals --- $strhost = "192.168.0.10"; $strport = "5038"; $timeout = "10"; $num=$_REQUEST['num']; $cid=$_REQUEST['cid']; $c=$_REQUEST['c']; $p=$_REQUEST['p'];  $errno=0 ; $errstr=0 ;  $sconn = fsockopen ($strhost, $strport, &$errno, &$errstr, $timeout) or die("Connection to $strhost:$strport failed");  if (!$sconn) { echo "$errstr ($errno)<br>\n"; }     else {    fputs ($sconn, "Action: login\r\n");   fputs ($sconn, "Username: c2call\r\n");   fputs ($sconn, "Secret: FrUyHn6FSaX\r\n");   fputs ($sconn, "Events: off\r\n\r\n");   usleep(500);    fputs ($sconn, "Action: Originate\r\n");   fputs ($sconn, "Channel: SIP/$cid\r\n");   fputs ($sconn, "Callerid: $cid\r\n");   fputs ($sconn, "Timeout: 15000\r\n");   fputs ($sconn, "Context: $c\r\n");   fputs ($sconn, "Exten: $num\r\n");   fputs ($sconn, "Priority: $p\r\n\r\n");   fputs ($sconn, "Async: yes\r\n\r\n" );   fputs ($sconn, "Action: Logoff\r\n\r\n");   usleep (500);    fclose ($sconn);    }   ?> 

Теперь можно проверить генерацию вызова, используя следующий URL:

http://domain.com/callback.php?p=1&c=OUT_EXT2&cid=3200&num=84951234567 

Результат мы видим в консоли:

*CLI>   == Manager 'c2call' logged on from 192.168.0.11         == Using SIP RTP CoS mark 5          -- Executing [84951234567@OUT_EXT2:1] Dial("SIP/3200-0000000a", "SIP/84951234567@TRK1") in new stack        == Manager 'c2call' logged off from 192.168.0.11        == Using SIP RTP CoS mark 5          -- Called SIP/84951234567@TRK1          -- SIP/TRK1-0000000b is ringing        == Spawn extension (OUT_EXT2, 84951234567, 1) exited non-zero on 'SIP/3200-0000000a' 

Приведу некоторые комментарии, которые, возможно, будут полезны практикующим:

\r\n — возврат каретки с переводом строки (Carriage Return + Line Feed (CR+LF)). Обычно передается в результате нажатия клавиши Enter и обозначает завершение передачи команды.

Events: off
В данном случае мы отключаем отправку событий на это соединение интерфейса AMI. В основном его значение всегда off

Channel: SIP/$cid
Имя канала которому адресован вызов. В нашем случае вызов сначала поступит абоненту SIP/3200, как только он возьмет трубку, вызов бедет перенаправлен на номер 84951234567.

Callerid: $cid
Идентификатор вызывающего абонента, который должен быть задан для исходящего канала.

Timeout: 15000
Указываем время ожидания ответа на звонок — 15 секунд

Async: yes
Асинхронное формирование вызовов позволяет создавать один или более вызовов, не ожидая немедленного ответа.