Динамические конференции на Asterisk 16 + FreePBX 14

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

В интернете есть несколько примеров реализации подобного рода задачи, но я решил реализовать по своему и так как мне нужно. Итак все ниже описанные действия производились на Asterisk 16 + FreePBX 14 + phpAGI.

— Техническое задание:

В активном разговоре нажать *7 — создание и перевод участников разговора в конференцию.
В конференции нажать *7 — после гудка набрать номер кого хотим пригласить в конференцию и нажимаем #.
Набрать внутренний номер с префиксом *7 (прим. *71100) — если конференция с набранным номером (прим. 1100) существует, то будет присоединение к ней, в противном случае будет создана новая конференция.

Создаем скрипт /var/lib/asterisk/agi-bin/conference.php со следующим содержанием:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
#!/usr/bin/php -q
<?php require('phpagi.php');
 
// ------------------------------------------------//
//      Dymanic Conf module by Jakonda© 2020       //
//      web - https://jakondo.ru                   //
// ------------------------------------------------//
 
// Подключение phpAGI / AGI_AsteriskManager
$agi = new AGI();
$asm = new AGI_AsteriskManager();
$asm->connect();
 
debug(".::: Starting scrypt (/var/lib/asterisk/agi-bin/cenference.php) :::.");
 
$action = $argv[1];
$confnum = $argv[2];
 
switch ($action) {
        case "NEW":
                newconf();
                break;
        case "ADD":
                inviteconf();
                break;
        case "MANUAL":
                manualconf();
                break;
default:
 
}
 
// Функция создания динамической конференции из активного разговора
function newconf()
{
        global $agi,$asm,$debug;
 
        $CL = $agi->get_variable('CHANNEL');
        $BP = $agi->get_variable('BRIDGEPEER');
        $CN = $agi->get_variable('DYNAMIC_WHO_ACTIVATED');
 
        $CL = $CL['data'];
        $BP = $BP['data'];
        $CN = $CN['data'];
 
        // Получение информации кто активировал DTMF код
        $CN = substr($CN, strpos($CN, "/") + 1, strpos($CN, "-") - 4);
 
        $asm->send_request('Setvar',array('Channel'=>"$CL",'Variable'=>"CONFNUM",'Value'=>"$CN"));
        $asm->send_request('Setvar',array('Channel'=>"$BP",'Variable'=>"CONFNUM",'Value'=>"$CN"));
 
        debug("Number [$CN] activated DTMF");
        debug("Source channel [$CL]");
        debug("Bridged channel [$BP]");
 
        // Проверяем если номер внутренний, то разрешаем создать динамическую
        // конференцию из текущего разговора
        if (strlen($CN) == 4) {
                debug("Allow");
        } else {
                debug("Deny");
                break;
        }
 
        // Перебрасываем собеседников в конференцию
        $asm->send_request('Redirect',array('Channel'=>"$CL",'ExtraChannel'=>"$BP",'Context'=>"dynamic-conference",'Exten'=>"CONF",'Priority'=>"1"));
}
 
// Функция добавления новых участник в динамически созданную активную конференцию
function inviteconf()
{
        global $agi,$asm,$confnum,$debug;
 
        // Ожидаем ввода номера для добавления в конференцию
        $result = $agi->get_data('beep', 4000, 11);
        $res = $result['result'];
 
        debug("Invite [$res] to dynamic conference [$confnum]");
 
        // Приглашаем набранный номер в конференцию
         if (strlen($res) == 4) {
                $asm->send_request('Originate',array('Channel'=>"SIP/$res",'Context'=>"dynamic-conference",'Exten'=>"CONF",'Priority'=>"1",'CallerID'=>"PBX Conference $confbum <$confnum>",'Variable'=>"CONFNUM=$confnum"));
        } else {
                $asm->send_request('Originate',array('Channel'=>"Local/$res@from-internal-additional",'Context'=>"dynamic-conference",'Exten'=>"CONF",'Priority'=>"1",'Variable'=>"CONFNUM=$confnum"));
        }
}
 
// Функция ручного управления. Создание динамической конференции и подключения к активной динамической конференции
function manualconf()
{
        global $agi,$asm,$debug;
 
        $CL = $agi->get_variable('CHANNEL');
        $EX = $agi->get_variable('EXTEN');
 
        $CL = $CL['data'];
        $EX = substr($EX['data'],2);
 
        debug("$CL");
        debug("$EX");
 
        $asm->send_request('Setvar',array('Channel'=>"$CL",'Variable'=>"CONFNUM",'Value'=>"$EX"));
        $asm->send_request('Redirect',array('Channel'=>"$CL",'Context'=>"dynamic-conference",'Exten'=>"CONF",'Priority'=>"1"));
}
 
// Функция вывода DEBUG информации в консоль
// -- полезно для отладки работы скрипта
function debug($string) {
        global $agi;
        $agi->verbose("$string");
}
 
?>

Выдаем права на чтение и запуск для asterisk:

1
2
chown asterisk:asterisk /var/lib/asterisk/agi-bin/conference.php
chmod 755 /var/lib/asterisk/agi-bin/conference.php

Прописываем динамическую функцию запуска скрипта, по нажатию комбинации *7 из активного разговора. В файл /etc/asterisk/features_applicationmap_custom.conf добавляем:

1
conference=>*7,self,AGI(/var/lib/asterisk/agi-bin/conference.php,NEW)

Объявляем прописанную динамическую функцию в глобальные переменные. В файл /etc/asterisk/globals_custom.conf добавляем:

1
DYNAMIC_FEATURES=conference

Модифицируем параметры конференции, добавим возможность приглашать новых участников, по нажатию комбинации *7 в активной конференции. В файл /etc/asterisk/confbridge_custom.conf добавляем:

1
2
3
4
5
6
7
8
9
[dynamic_user]
type = user
talk_detection_events=yes
dsp_drop_silence=yes
announce_only_user=no
 
[dynamic_menu]
type = menu
*7=dialplan_exec(dynamic-conference,INVITE,1)

Описываем работу динамических конференций в диалплане. В файл /etc/asterisk/extensions_custom.conf добавляем:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
[from-internal-custom]
include => dynamic-conference
 
 
[dynamic-conference]
; -----------------------------------------------------------------------------------------------------------------
; Динамические конференции. При активном разговоре, сотрудник может перевести разговор в конференцию, которая будет
; создана динамически(номер конференции будет присвоен такой же как и внутренний номер сотрудника). Сотрудник может
; добавить участников в созданную конференцию. Сотрудники могут подключиться к динамической конференции без 
; приглашения, а так же создать свою новую динамическую конференцию.
;
; -- Инструкция:
;  - В активном разговоре нажать *7 - создание и перевод участников разговора в конференцию
;  - В конференции нажать *7 - после гудка набрать номер кого хотим пригласить в конференцию и нажимаем #
;  - Набрать внутренний номер с префиксом *7 (прим. *71100) - если конференция с набранным номером (прим. 1100) 
;    существует, то будет присоединение к ней, в противном случае будет создана новая конференция.
; -----------------------------------------------------------------------------------------------------------------
;
exten => CONF,1,NoOp(Dynamic Conference)
exten => CONF,n,ConfBridge(${CONFNUM},,dynamic_user,dynamic_menu)
 
exten => INVITE,1,NoOp(Conference Invite ${CONFNUM})
exten => INVITE,n,AGI(/var/lib/asterisk/agi-bin/conference.php,ADD,${CONFNUM})
 
exten => _*7XXXX,1,NoOp(Create/Connect Dynamic Conference)
exten => _*7XXXX,n,AGI(/var/lib/asterisk/agi-bin/conference.php,MANUAL)

ИНФОРМАЦИЯ. Номерной план само собой может отличаться от моего (4-х значного), поэтом строку _*7XXXX адаптируйте под свой номерной план.

Перечитываем диалплан и можно проверять работу динамических конференций:

1
asterisk -rx 'dialplan reload'

Заметки системного администратора Windows Server

Поиск по этому блогу

Динамические конференции на Asterisk 16 + FreePBX 14