Простая настройка очередей (queues) в Asterisk
Очередь — главный инструмент приёма входящих в 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"
Сценарий для теста:
- Позвоните с 101 на 1800 — должны зазвонить 102 или 103.
- Не отвечайте на первом телефоне: через 20 секунд вызов уйдёт ко второму.
- Займите оба телефона разговором и снова позвоните — звонящий услышит музыку и объявление позиции.
- Поставьте 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 и восстанавливается при старте.