Мобильные динамические агенты в очереди

В данной статье рассмотрим возможность добавления в очередь мобильных номеров в качестве динамических агентов.

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

Роль динамического агента позволяет присоединиться к очереди или выйти из неё в любое время, набрав сервисный код. Более подробно о функционале очередей можно прочитать в статье: Обзор функционала очередей FreePBX 13

Рассмотрим следующую ситуацию: необходимо принять вызов из очереди, находясь вдали от рабочего места. Использование софтфона или другого телефона не представляется возможным, да и нужна только входящая связь. Исходя из этого, задаём вопрос: можно ли с мобильного номера присоединиться к очереди.

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

Реализация+

Для начала разберёмся, почему при звонке с мобильного номера на АТС и донаборе сервисного кода не может попасть в очередь в качестве динамического агента, даже если он там прописан. Проблема состоит в следующем: при входе/выходе устройства в качестве динамического агента в очередь происходит проверка его текущего состояния. Asterisk может сделать это для заведённых на нём пиров, однако для мобильного номера проверять ему нечего. Следовательно, нам нужно отключить проверку состояния для мобильного номера.

В файле extensions_custom.conf (/etc/asterisk/) пропишем:

[app-queue-toggle-mob]
exten => s,1(start),Answer
exten => s,n,NoOp("app-queue-toggle-mobile")
exten => s,n,Wait(1)
exten => s,n,Macro(user-callerid,)
exten => s,n,Set(QUEUEUSER=${CALLERID(num)})
exten => s,n,Set(QUEUESTAT=LOGGEDOUT)
exten => s,n,Set(QUEUENO=8008)
exten => s,n,AGI(queue_devstate.agi,getqueues,${QUEUEUSER})
exten => s,n,GotoIf($["${QUEUESTAT}" = "LOGGEDOUT"]?activate)
exten => s,n,GotoIf($["${QUEUESTAT}" = "LOGGEDIN"]?deactivate:end)
exten => s,n(deactivate),Noop(Agent Logged out)
exten => s,n,Macro(toggle-del-agent-mob,)
exten => s,n(logout),Set(STATE=NOT_INUSE)
exten => s,n,Playback(agent-loggedoff)
exten => s,n,Macro(hangupcall,)
exten => s,n(activate),Noop(Agent Logged In)
exten => s,n,Macro(toggle-add-agent-mob,)
exten => s,n,GotoIf($["${QAGENT_UNAUTHORIZED}"="1"]?logout)
exten => s,n,Playback(agent-loginok)
exten => s,n,SayDigits(${QUEUEUSER})
exten => s,n,Macro(hangupcall,)

В контексте app-queue-toggle-mob происходит следующее: присваиваем в QUEUEUSER номер, который находится в CALLERID(num), а также в QUEUENO прописываем номер очереди, в которую должен попасть мобильный номер. QUEUESTAT при этом изначально содержит в себе LOGGEDOUT, так как первоначально данное состояние в очереди актуально для всех динамических агентов. Затем происходит сбор информации о том, есть ли агент QUEUEUSER в очереди в данный момент или нет. Если есть, то в какой очереди. За эту часть контекста отвечает скрипт queue_devstate.agi. Далее, на основе данной информации, в QUEUESTAT присваивается актуальный статус динамического агента и происходит вызов макросов для его удаления или добавления. Макрос для добавления в очередь изначально работает с хинтами, и его нужно переписать. Переписываем в этом же файле.

[macro-toggle-add-agent-mob]
exten => s,1,Macro(user-callerid,SKIPTTL,)
exten => s,n,Set(QUEUEUSER=${IF($[${LEN(${QUEUEUSER})}>0]?${QUEUEUSER}:${AMPUSER})})
exten => s,n,Set(QUEUEUSERCIDNAME=${DB(AMPUSER/${QUEUEUSER}/cidname)})
exten => s,n,GotoIf($["${DB(QPENALTY/${QUEUENO}/dynmemberonly)}" = "yes" & ${DB_EXISTS(QPENALTY/${QUEUENO}/agents/${QUEUEUSER})} != 1]?invalid)
exten => s,n,AddQueueMember(${QUEUENO},Local/${QUEUEUSER}@outbound-allroutes/n,${DB(QPENALTY/${QUEUENO}/agents/${QUEUEUSER})},,${QUEUEUSERCIDNAME})
exten => s,n,UserEvent(AgentLogin,Agent: ${QUEUEUSER})
exten => s,n,QueueLog(${QUEUENO},MANAGER,${IF($[${LEN(${QUEUEUSERCIDNAME})}>0]?${QUEUEUSERCIDNAME}:${QUEUEUSER})},ADDMEMBER,)
exten => s,n,MacroExit()
exten => s,n(invalid),Playback(pbx-invalid)
exten => s,n,Set(QAGENT_UNAUTHORIZED=1)
exten => s,n,MacroExit()

Также перепропишем макрос для удаления агента.

[macro-toggle-del-agent-mob]
exten => s,1,Macro(user-callerid,SKIPTTL,)
exten => s,n,Set(QUEUEUSER=${IF($[${LEN(${QUEUEUSER})}>0]?${QUEUEUSER}:${AMPUSER})})
exten => s,n,Set(QUEUEUSERCIDNAME=${DB(AMPUSER/${QUEUEUSER}/cidname)})
exten => s,n,RemoveQueueMember(${QUEUENO},Local/${QUEUEUSER}@outbound-allroutes/n)
exten => s,n,UserEvent(RefreshQueue)
exten => s,n,QueueLog(${QUEUENO},MANAGER,${IF($[${LEN(${QUEUEUSERCIDNAME})}>0]?${QUEUEUSERCIDNAME}:${QUEUEUSER})},REMOVEMEMBER,)
exten => s,n,MacroExit()

После того, как переписали контекст, перейдём на web-интерфейс в модуль Custom Destination (Admin-> Custom Destinations).

Подробнее о работе с данным модулем можно прочитать в статье: Использование Custom destinations (Специальное назначение) FreePBX

Здесь создадим новое назначение, которое будет ссылаться на контекст app—queue—toggle—mob.

Далее перейдём в IVR и в донабор впишем новую строчку с переходом на созданное назначение.

Подробнее о работе с IVR можно прочитать в статье: Настройка Интерактивного голосового меню (IVR)

В примере в донабор впишем кастомный сервисный код *4580.

Теперь проверим работу.

Позвоним с мобильного номера на внешний номер АТС. После того, как попали в IVR, донаберём сервисный код *4580.

В логе видим, что вызов пришёл с такого-то номера. После того, как был набран сервисный код, в консоли появился NOTICE о том, что агент зарегистрирован в очереди 8008. Также после этого в телефоне услышим сообщение о том, что агент с номером 79112223344 зарегистрирован добавлен в очередь.

Выйти из очереди можно также звонком на IVR и донабором *4580.

Статусы агента в очереди

Важно отметить, что для мобильных динамических агентов также можно отследить статусы в очереди, как и для обычных агентов очереди. После входа в очередь введём в Asterisk CLI команду:

queue show <номер очереди>

Агент отобразится в статусу Not in use.

Также можно ввести данную команду, когда в очередь пришёл вызов, и агент на него ответил. Статус будет In Call.

Задача реализована: мобильный агент добавляется и удаляется, вызовы из очереди на него приходят. На этом статья завершена.