Shkerka.ruзаметки админа
Asterisk и IP-АТС

Простая настройка очередей (queues) в Asterisk

Опубликовано: Обновлено: 4 мин чтенияАвтор: Редакция Shkerka.ru

Очередь — главный инструмент приёма входящих в Asterisk: звонки не теряются, пока операторы заняты, а распределение настраивается стратегией. Собираем стенд из трёх SIP-абонентов, чтобы разобраться в queues.conf и проверить разные режимы.

Как устроена очередь

Модуль app_queue ставит входящий вызов в очередь и по очереди предлагает его участникам (операторам) по выбранной стратегии. Пока все заняты, звонящий слушает музыку и, при желании, объявления о своей позиции. Вся настройка сводится к двум местам:

  • queues.conf — описание очередей и их участников;
  • extensions.conf — как вызов попадает в очередь и как операторы входят и выходят из неё.

Для стенда возьмём трёх абонентов PJSIP: 101 звонит в очередь, 102 и 103 — операторы. Как создать абонентов, описано в статье о базовой настройке Asterisk.

Шаг 1. Очередь в queues.conf

[general]
persistentmembers=yes
shared_lastcall=yes

[support]
strategy=rrmemory
timeout=20
retry=5
wrapuptime=10
maxlen=20
ringinuse=no
joinempty=yes
leavewhenempty=no
musicclass=default
announce-frequency=60
announce-holdtime=yes
announce-position=yes
member => PJSIP/102,0,Operator 102
member => PJSIP/103,0,Operator 103

Основные параметры:

Параметр Что делает
strategy Как выбирается оператор (таблица ниже)
timeout Сколько секунд звонит телефон оператора, прежде чем вызов перейдёт к следующему
retry Пауза перед новым кругом обзвона
wrapuptime Отдых оператора после разговора, в секундах
maxlen Максимум ожидающих; 0 — без ограничения
ringinuse Звонить ли оператору, который уже разговаривает
joinempty, leavewhenempty Можно ли попасть в очередь и оставаться в ней, если операторов нет
announce-* Объявления позиции и времени ожидания

Синтаксис участника: member => интерфейс,penalty,имя,state_interface,ringinuse. Penalty — приоритет: чем больше число, тем позже оператор получит вызов. Операторы с penalty 0 получают звонки первыми, с penalty 5 — только когда все «нулевые» заняты.

ringinuse=no корректно работает, только если Asterisk знает состояние телефона. Для PJSIP это обеспечивается автоматически, а при звонках через Local-каналы указывайте state_interface.

Стратегии распределения

Стратегия Как выбирается оператор
ringall Звонят все свободные, пока кто-то не ответит
leastrecent Тот, кто дольше всех не разговаривал
fewestcalls Тот, кто принял меньше всего вызовов
random Случайный
rrmemory По кругу, начиная со следующего за последним ответившим
rrordered Как rrmemory, но сохраняет порядок из конфигурации
linear Всегда по порядку списка, начиная с первого
wrandom Случайный с учётом penalty

Шаг 2. Вызов в очередь

[from-provider]
exten => 4951234567,1,Answer()
 same => n,Set(CHANNEL(language)=ru)
 same => n,Queue(support,t,,,300)
 same => n,VoiceMail(100@default,u)
 same => n,Hangup()

[office]
exten => 1800,1,Goto(from-provider,4951234567,1)

Пятый параметр Queue — время ожидания в очереди, здесь 300 секунд. Если за пять минут никто не ответил, вызов продолжит выполнение диалплана и попадёт в голосовую почту. Опция t разрешает оператору переводить вызов.

Внутренний номер 1800 нужен для тестов: абонент 101 звонит на него и попадает в ту же очередь, что и звонки из города.

Шаг 3. Динамические операторы

Статический список в queues.conf неудобен, если операторы меняются по сменам. Динамических участников добавляют и убирают служебными кодами прямо с телефона:

[office]
; вход в очередь
exten => *45,1,AddQueueMember(support,PJSIP/${CHANNEL(endpoint)})
 same => n,Playback(agent-loginok)
 same => n,Hangup()
; выход из очереди
exten => *46,1,RemoveQueueMember(support,PJSIP/${CHANNEL(endpoint)})
 same => n,Playback(agent-loggedoff)
 same => n,Hangup()
; пауза и снятие с паузы
exten => *47,1,PauseQueueMember(support,PJSIP/${CHANNEL(endpoint)})
 same => n,Playback(beep)
 same => n,Hangup()
exten => *48,1,UnpauseQueueMember(support,PJSIP/${CHANNEL(endpoint)})
 same => n,Playback(beep)
 same => n,Hangup()

${CHANNEL(endpoint)} возвращает имя PJSIP-абонента, с которого звонят. Это надёжнее, чем CALLERID(num), который можно изменить в настройках телефона. Если используете динамических участников, уберите строки member => из queues.conf, чтобы не путаться.

Агенты: что изменилось

В старых конфигурациях можно встретить agents.conf и участников вида Agent/1001. Канал chan_agent удалён в Asterisk 12, на смену пришёл модуль app_agent_pool: агент входит приложением AgentLogin(), а очередь вызывает его через Local-канал с AgentRequest(). Эта схема нужна, когда оператор садится за любой свободный телефон и логинится своим номером агента. Для офиса с закреплёнными рабочими местами динамических участников достаточно.

Проверка

asterisk -rx "module reload app_queue.so"
asterisk -rx "dialplan reload"
asterisk -rx "queue show support"

queue show покажет стратегию, участников, их состояние (Not in use, In use, Paused) и число принятых вызовов. Добавить или убрать участника можно и из консоли:

asterisk -rx "queue add member PJSIP/104 to support"
asterisk -rx "queue remove member PJSIP/104 from support"

Сценарий для теста:

  1. Позвоните с 101 на 1800 — должны зазвонить 102 или 103.
  2. Не отвечайте на первом телефоне: через 20 секунд вызов уйдёт ко второму.
  3. Займите оба телефона разговором и снова позвоните — звонящий услышит музыку и объявление позиции.
  4. Поставьте 102 на паузу кодом *47 и проверьте, что звонки идут только на 103.

Статистика

Каждое событие очереди записывается в /var/log/asterisk/queue_log: вход, ответ, отказ, время ожидания и разговора. По этому файлу считают пропущенные вызовы и нагрузку на операторов; его же читают внешние системы отчётов. При необходимости queue_log можно писать в базу данных через Realtime.

Другие рецепты обработки входящих — в разделе Asterisk.

Частые вопросы

Какую стратегию очереди выбрать?

Для небольшого отдела продаж — ringall: звонят все свободные операторы, отвечает самый быстрый. Для равномерной нагрузки — rrmemory или leastrecent. Если операторы неравноценны, используйте penalty.

Нужен ли agents.conf для очередей?

Нет. Старый канал Agent/ из chan_agent удалён в Asterisk 12, а современный app_agent_pool нужен лишь для схемы с логином агента с любого телефона. Обычно достаточно динамических участников через AddQueueMember.

Как оператору временно выйти из очереди?

Поставить себя на паузу: PauseQueueMember по служебному коду, например *47. Звонки к нему перестанут поступать, но он останется участником очереди и вернётся одной командой UnpauseQueueMember.

Сохранятся ли динамические операторы после перезапуска?

Да, если в секции general файла queues.conf стоит persistentmembers=yes. Список участников хранится в AstDB и восстанавливается при старте.