Объединение нескольких Call Flow Control

В данной статье рассмотрим возможность объединения нескольких Call Flow Control (сокращённо CFC) одним сервисным кодом.

Модуль CFC позволяет управлять вызовами в зависимости от состояния, в котором находится. Он производит переключение с помощью набора сервисного кода между двумя режимами: Normal Flow (Green/BLF) и Override Flow (Red/BLF).

Коротко рассмотрим ситуацию, когда CFC может оказаться полезен: у компании ненормированный рабочий график, и, при уходе с работы, нужно перевести звонки на дежурного. В данном случае, не поможет использование Time Conditions (правил по времени), так как само время переключения изначально неизвестно. Здесь уместно будет использовать CFC, который позволяет с помощью сервисного кода менять направление входящих вызовов. При этом в одном состоянии могут находиться внутренние номера, очереди и т.д., а в другом – внутренний номер дежурного.

Для создания CFC необходимо во FreePBX перейти во вкладку: Applications -> Call Flow Control.

Постановка задачи

Бывают ситуации, когда несколько CFC необходимо переключить одновременно, и неудобно или нет времени поочерёдно набирать несколько сервисных кодов. В таком случае возникает следующий вопрос: можно ли перевести все CFC, набрав один сервисный код.

Задача: объединить в один сервисный код переключение состояний необходимых CFC.

Реализация

Сначала нужно создать необходимые CFC. Для этого во FreePBX перейдём в конфигурационный файл extensions_custom.conf и создадим контекст app-daynight-custom. Этот контекст будет отвечать за направление на CFC. В данном контексте пропишем следующее:

exten => 18,1,GotoIf($["${DB(DAYNIGHT/C${EXTEN})}" = "NIGHT"]?from-did-direct,00088,1:ext-queues,00900,1)
exten => 19,1,GotoIf($["${DB(DAYNIGHT/C${EXTEN})}" = "NIGHT"]? from-did-direct,0008,1:ivr-1,s,1)
exten => 20,1,GotoIf($["${DB(DAYNIGHT/C${EXTEN})}" = "NIGHT"]? from-did-direct,00088,1:from-did-direct,0008,1)
exten => 21,1,GotoIf($["${DB(DAYNIGHT/C${EXTEN})}" = "NIGHT"]? app-blackhole,hangup,1:from-did-direct,0009,1)

Теперь по порядку рассмотрим то, что прописали в контексте, на примере первого CFC. Обозначаем для CFC индекс. Далее проверяем в базе данных текущее состояние CFC. Если состояние «NIGHT», звонок пойдёт на кастомный номер 00088. Если состояние отличается от указанного, звонок пойдёт на очередь 00900.

Для направления маршрутизации на данный контекст, воспользуемся модулем Custom Destinations, входящим в состав FreePBX.

Подробнее о Custom Destinations можно узнать в этой статье: Использование Custom Destinations

Рассмотрим использование этого модуля относительно данной задачи. Создадим новый Custom Destinations. Укажем его имя и в поле Custom Destinations укажем наименование модуля назначения. Custom Destinations создаём на каждый CFC. Пример одного из таких показан на скриншоте ниже.

Переходим в Inbound Routes во FreePBX (Connectivity -> Inbound Routes), находим нужный нам маршрут. Заходим в его редактирование во вкладку General. Находим Set Destination и в нём ссылаемся на созданный Custom Destinations. Подробнее о добавлении и работе с входящими маршрутами можно почитать в статье: Маршрутизация входящих вызовов во FreePBX.

Далее в файле extensions_custom.conf создадим ещё один контекст: app-daynight-toggle-custom. Данный контекст будет отвечать за технологию переключения CFC с Normal Flow в Override Flow и обратно. Рассмотрим, что будет прописано в данном контексте:

exten => *2517811,1,Noop("Toggle custom from *2517811")
exten => *2517811,n,Set(CTOG=4)
exten => *2517811,n,Macro(user-callerid,)
exten => *2517811,n,Answer
exten => *2517811,n,Wait(1)
exten => *2517811,n,Set(INDEXES=18)

В примере используем сервисный код *2517811.

Вы можете использовать любой сервисный код, кроме зарезервированных АТС. Посмотреть текущие используемые сервисные коды можно на вкладке Admin -> Feature Codes.

Подробнее об использовании сервисных кодов можно почитать в статье: Сервисные коды Asterisk (https://voxlink.ru/kb/asterisk-configuration/servisnye-kody-Asterisk/)

Присвоим переменной CTOG общее количество созданных CFC, а переменной INDEXES – индекс CFC, с которого начинается переключение. CTOG будет изменяться от присвоенного ему значения до нуля, а INDEXES – до конечного индекса. Переходим на метку start_toggle.

В start_toggle переносим стандартный диалплан переключения CFC. Найти оригинал можно в файле extensions_additional.conf. Переносить начинаем со строчки, где есть переменная LOOPCNT и заканчиваем строчкой с Hangup().

Внесём в диалплан некоторые изменения. Вместо exten => s,n,… пропишем вызов нашего сервисного кода в каждой строчке exten => *2517811,n,… Далее добавим второй строчкой

exten => *2517811,n,Set(CTOG=$[${CTOG} - 1]) 

В конец файла, до Hangup(), добавим

exten => *2517811,n,Set(INDEXES=$[${INDEXES} + 1])
exten => *2517811,n,GotoIf($[${CTOG} != 0]?start_toggle)

Подробнее рассмотрим внесённые правки. Пропишем уменьшение CTOG на 1 и увеличение INDEXES на 1. Сравним CTOG с нулём.

Таким образом, в start_toggle получим цикл: пока CTOG не достигнет нуля, он будет постоянно уменьшаться, а INDEXES увеличиваться, тем самым постепенно переключая каждый CFC. Как только CTOG будет равен нулю, цикл завершится, и все CFC будут переключены.

В итоге start_toggle должен выглядеть следующим образом:

exten => *2517811,n(start_toggle),Set(LOOPCNT=${FIELDQTY(INDEXES,&)})
exten => *2517811,n,Set(CTOG=$[${CTOG} - 1])
exten => *2517811,n,Set(ITER=1)
exten => *2517811,n(begin1),Set(INDEX=${CUT(INDEXES,&,${ITER})})
exten => *2517811,n,Set(MODE=${DB(DAYNIGHT/C${INDEX})})
exten => *2517811,n,GotoIf($["${MODE}" != "NIGHT"]?end1)
exten => *2517811,n,Set(DAYNIGHTMODE=NIGHT)
exten => *2517811,n(end1),Set(ITER=$[${ITER} + 1])
exten => *2517811,n,GotoIf($[${ITER} <= ${LOOPCNT}]?begin1)
exten => *2517811,n,Set(LOOPCNT=${FIELDQTY(INDEXES,&)})
exten => *2517811,n,Set(ITER=1)
exten => *2517811,n(begin2),Set(INDEX=${CUT(INDEXES,&,${ITER})})
exten => *2517811,n,GotoIf($["${DAYNIGHTMODE}" = "NIGHT"]?day:night)
exten => *2517811,n(day),Set(DB(DAYNIGHT/C${INDEX})=DAY)
exten => *2517811,n,Set(DEVICE_STATE(Custom:DAYNIGHT${INDEX})=NOT_INUSE)
exten => *2517811,n(hook_day),Goto(end2)
exten => *2517811,n(night),Set(DB(DAYNIGHT/C${INDEX})=NIGHT)
exten => *2517811,n,Set(DEVICE_STATE(Custom:DAYNIGHT${INDEX})=INUSE)
exten => *2517811,n(hook_night),Goto(end2)
exten => *2517811,n(end2),Set(ITER=$[${ITER} + 1])
exten => *2517811,n,GotoIf($[${ITER} <= ${LOOPCNT}]?begin2)
exten => *2517811,n,Set(INDEXES=$[${INDEXES} + 1])
exten => *2517811,n,GotoIf($[${CTOG} != 0]?start_toggle)
exten => *2517811,n,Hangup()

Чтобы при наборе сервисного кода проигрывалось сообщение о переключении состояний CFC, необходимо в start_toggle прописать следующие строки:

exten => *2517811,n,Set(DAYREC=beep&silence/1&featurecode&digits/${INDEXES}&de-activated)
exten => *2517811,n,Set(NIGHTREC=beep&silence/1&featurecode&digits/${INDEXES}&activated)
exten => *2517811,n,ExecIf($["${DAYNIGHTMODE}" = "NIGHT"]?Playback(${DAYREC}):Playback(${NIGHTREC}))

Переменные DAYREC и NIGHTREC хранят в себе названия файлов, которые будут проигрываться при переключении соответствующих CFC. Соответственно в последней строчке, в зависимости от состояния, в которое происходит переключение, проигрывается сообщение об активации или деактивации соответствующего CFC. 

Далее сохраняем конфигурационный файл и в Asterisk обновляем конфигурацию диалплана для применения внесённых изменений.

Сделать это можно командой:

dialplan reload

которую необходимо выполнить в CLI Asterisk.

Об основных командах Asterisk можно почитать в статье: Справочник команд

Теперь можем позвонить на созданный сервисный код, и объединённые в нём CFC изменяет своё состояние.

Созданный сервисный код так же используется для переключения CFC в исходное состояние.

Рассмотрим несколько команд:

asterisk -rx ‘database show’ | grep DAYNIGHT – с помощью этой команды можно узнать состояние всех CFC. Выполняется в системной консоли.

database put DAYNIGHT C18 DAY/NIGHT – позволяет изменить состояние CFC, находясь в консоли Asterisk, с индексом C18. Соответственно нужно подставить индекс интересуемого CFC. Использование нежелательно, т.к. меняется состояние только одного CFC, и в дальнейшем, при наборе сервисного кода, состояния CFC не будут синхронизированы.

database get DAYNIGHT C18 – эта команда даёт возможность получить состояние CFC с индексом 18.

database del DAYNIGHT C18 – даёт возможность удалить CFC с соответствующим индексом из базы. Выполняется в консоли Asterisk.

Более подробно о работе с AstDB можно почитать в статье: Использование базы данных Asterisk (AstDB)

Подробнее рассмотрим то, что показано на скриншоте. Сначала введём первую команду и проверим состояния всех наших CFC. В нашем примере созданные CFC находятся в состоянии DAY. Затем откроем консоль Asterisk и введём в ней вторую команду с состоянием NIGHT, что переведёт CFC с индексом 18 в ночной режим. Команда должна выдать результат «Updated database successfully», т.е. после ввода данной команды в базу заносится новое значение для определённого индекса СFC. Проверить это мы можем, введя в консоли Asterisk третью команду. Она вернёт значение «DAY» или «NIGHT» в зависимости от состояния, в которое только что перевели CFC.

Если нужно удалить CFC с определённым индексом из базы, введём четвёртую команду. Должны получить в консоли следующий результат: «Database entry removed». Это будет означать, что база больше не хранит в себе CFC с данным индексом. Проверить можно командой database get DAYNIGHT C18 или asterisk -rx ‘database show’ | grep DAYNIGHT. На скриншоте сделали проверку двумя командами.

Команда database del DAYNIGHT C18 удаляет значение только из базы. При повторном наборе сервисного кода CFC с данным индексом снова будет активным. Для полного удаления CFC необходимо убрать соответствующую строку из диалплана.

На этом статью об объединении нескольких CFC под одним сервисным кодом можно считать законченной.