...
Для конфигурации новой очереди необходимо создать добавочный, указав в качестве типа (параметр type) значение queue.
...
| Параметр | Тип | Обязательный | Значение по умолчанию | Описание |
|---|---|---|---|---|
| sound |
| нет | null | Основной звук, который будут слышать звонящие в очередь, требуется указать id ресурса sound. |
| sound-_type | string | нет | "ring" | Тип основного звука. Может принимать значения music или ring. Если установлен в значение ring, то звонящий слышит обычные гудки, |
| announce-_sound | integer | нет | null | Звук, воспроизводящийся раз в определенный промежуток времени во время ожидания звонящим ответа. Частота воспроизведения настраивается параметром announce-_frequency. |
| announce-_frequency | integer | нет | null | Частота воспроизведения звука announce-_sound в секундах. |
| start-_sound | integer | нет | null | Звук, проигрываемый звонящему при постановке его в очередь, звук проигрывается до начала вызова агентов. |
| strategy | string | нет | "round-robin" | Стратегия обзвона агентов очереди. Подробно см. *Очередь (/queue/). |
| max-_wait-_time | integer | нет | 3600 | Максимальное время ожидания звонящего в очереди в секундах. По прошествии этого времени осуществляется выход из очереди. |
| max-_wait-_time-_with-_no-_agent | integer | нет | null | Максимальное время ожидания звонящего в очереди в секундах, если в ней нет ни одного доступного агента. По прошествии этого времени осуществляется выход из очереди. |
| record-_enabled | boolean | нет | false | Включение записи разговора в очереди. |
| exit-_key | string | нет | null | Кнопка, при нажатии которой осуществляется выход из очереди. Может цифровой кнопкой, а также кнопками * и #. |
| exit-_transfer-_dst | string | нет | null | В случае, если звонящий вышел из очереди нажатием кнопки, его переадресует на данный номер. Параметр exit-_key должен иметь значение отличное от null. |
| timeout-_transfer-_dst | string | нет | В случае, если звонящий вышел по истечению max-_wait-_time, max-_wait-_time-_with-_no-_agent, его переадресует на данный номер. | |
| tier-_rules-_apply | boolean | нет | false | Требуется ли применение параметров tier-_rule-_wait-_second и tier-_rule-_wait-_multiply-_level |
| tier-_rule-_wait-_second | integer | нет | Время в секундах, по истечении которого начинают вызываться агенты следующего уровня. | |
| tier-_rule-_wait-_multiply-_level | boolean | нет | false | Если параметр имеет значение true, время tier-_rule-_wait-_second умножается на уровень агента. |
...
При любой стратегии сначала вызываются агенты с наименьшим уровнем. Если агенты текущего уровня обзвона заняты, либо находятся в состоянии временной недоступности например, после не ответа или отклонения предыдущего вызова (см. конфигурацию агента), то вызываются агенты следующего уровня. Если параметр tier-_rules-_apply имеет значение true, агенты следующего уровня начинают вызываться, через время, указанное параметром tier-_rule-_wait-_second, отчет начинается с началом вызова агентов текущего уровня.
Если параметр tier-_rule-_wait-_multiply-_level имеет значение true, то время tier-_rule-_wait-_second умножается на уровень агента.
| Стратегия | Описание |
|---|---|
| ring-all | Вызываются одновременно все доступные агенты. Если параметр tier-_rules-_apply имеет значение true, сначала вызываются агенты с наименьшим уровнем, затем, через время, указанное параметром tier-_rule-_wait-_second вызываться начинают агенты следующего уровня и так далее. |
| longest-idle-agent | Вызывается агент с наибольшим временем ожидания. |
| round-robin | Агенты вызываются согласно их позиции (параметр position при добавлении агента в очередь). |
| top-down | Агенты вызываются в порядке из позиций, начиная с первой. |
| agent-with-least-talk-time | Вызывается агент с наименьшим временем разговора. |
| agent-with-fewest-calls | Вызывается агент с наименьшим количеством звонков. |
| sequentially-by-agent-order | Агенты вызываются последовательно в порядке их уровней и позиций. Первым всегда вызывается агент с наименьшем уровнем и позицией. |
| random | Агенты вызываются в случайном порядке. |
...
| Параметр | Тип | Обязательный | Значение по умолчанию | Описание |
|---|---|---|---|---|
| status | string | нет | "available" | Статус агента. Принимает одно из значений: "logged_out", "available". В статусе available агент доступен для вызовов, в статусе logged_out вызовы агенту не направляются. |
| call_timeout | integer | нет | Системное значение | Время в секундах, в течение которого осуществляется вызов агента. |
| wrap-_up-_time | integer | нет | null | Время в секундах с момента последнего разговора агента, в течение которого ему не будут направляться вызовы. |
| no-_answer-_delay-_time | integer | нет | 10 | Если агент не ответил на вызов, то в течение указанного в этом параметре времени в секундах ему не будут направляться вызовы. |
| reject-_delay-_time | integer | нет | 10 | Время в секундах с момента последнего отклонения вызова агентом, в течение которого ему не будут направляться вызовы. |
| busy-_delay-_time | integer | нет | 10 | Если агент при попытке вызова был занят, то в течение указанного в этом параметре времени в секундах ему не будут направляться вызовы. |
...
метод | ресурс | данные | ответ |
|---|---|---|---|
PUT |
|
|
|
2. Создадим локального агента
метод | ресурс | данные | ответ |
|---|---|---|---|
POST |
|
|
|
3. Создадим внешнего агента
метод | ресурс | данные | ответ |
|---|---|---|---|
POST |
|
|
|
4. Добавим локального агента в очередь с первой позицией и первым уровнем.
...
Имя | Тип | Обязательный |
|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
start-_sound | integer | нет |
Поля ответа
Имя | Тип |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
start-_sound | integer |
GET /extension/{extension_id}/queue/
...
Поля ответа
Имя | Тип |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
start-_sound | integer |
Конфигурация локального агента в очереди
...
Имя | Тип | Обязательный |
|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Поля ответа
Имя | Тип |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
GET /client/{client_id}/agent/local/
...
Поля ответа
Имя | Тип |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
...
PUT /client/{client_id}/agent/local/{agent_id}
...
Имя | Тип | Обязательный |
|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Поля ответа
Имя | Тип |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
GET /client/{client_id}/agent/local/{agent_id}
...
Поля ответа
Имя | Тип |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
DELETE /client/{client_id}/agent/local/{agent_id}
...
Имя | Тип | Обязательный |
|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Поля ответа
Имя | Тип |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
GET /client/{client_id}/agent/remote/
...
Поля ответа
Имя | Тип |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
...
PUT /client/{client_id}/agent/remote/{agent_id}
...
Имя | Тип | Обязательный |
|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Поля ответа
Имя | Тип |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
GET /client/{client_id}/agent/remote/{agent_id}
...
Имя | Тип |
|---|---|
Имя | Тип |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
DELETE /client/{client_id}/agent/remote/{agent_id}
...