Протестировать методы API можно на странице интерактивного обозревателя и без написания кода
...
| Warning |
|---|
Мы обновили документацию, актуальная версия страницы доступна по ссылке: Очередь (/queue/) |
Добавочные номера типа очередь (queue) служат для реализации функциональности колл-центра.
...
Для очереди могут быть сконфигурированы следующие параметры:
| Параметр | Тип | Обязательный | Значение по умолчанию | Описание |
|---|
| strategy |
integerОсновной звук, который string | нет |
| "round-robin" | Стратегия обзвона агентов очереди. Подробно см. Стратегии очереди. | |||
| sound | integer | нет | null | Основной звук, который будут слышать звонящие в очередь, требуется указать id ресурса sound. |
| sound_type | string | нет | "ring" | Тип основного звука. Может принимать значения music или ring. Если установлен в значение ring, то звонящий слышит обычные гудки, |
| announce_sound | integer | нет | null | Звук, воспроизводящийся раз в определенный промежуток времени во время ожидания звонящим ответа. Частота воспроизведения настраивается параметром announce_frequency. |
| announce_frequency | integer | нет | null | Частота воспроизведения звука announce_sound в секундах. |
| position_announce_frequency | integer | нет | null | Частота анонса позиции звонящего в очереди по отношению к другим ожидающим ответа. Не используется, если не указано. Не может быть менее 1 секунды. |
| start_sound | integer | нет | null | Звук, проигрываемый звонящему при постановке его в очередь, звук проигрывается до начала вызова агентов. |
string| agent_announce_sound | integer | нет |
| null | Звук, который проиграется агенту очереди при ответе звонящему. | |||
| agent_report_wait_time | integer | нет | null | Агенту очереди при ответе звонящему будет сообщено время в секундах как долго звонящий ждал ответа |
| max_wait_time |
integerstring | нет |
| null | Максимальное время ожидания звонящего в очереди в секундах. По прошествии этого времени осуществляется выход из очереди. |
| max_wait_time_with_no_agent |
integerstring | нет | null | Максимальное время ожидания звонящего в очереди в секундах, если в ней нет ни одного доступного агента. По прошествии этого времени осуществляется выход из очереди. | |
| record_enabled | boolean | нет | false | Включение записи разговора в очереди. |
| exit_key | string | нет | null | Кнопка, при нажатии которой осуществляется выход из очереди. Может цифровой кнопкой, а также кнопками * и #. |
| exit_transfer_dst | string | нет | null | В случае, если звонящий |
| нажал кнопку из exit_key, его переадресует на данный номер |
| . | ||||
| timeout_transfer_dst | string | нет | null | В случае, если звонящий вышел по истечению max_wait_time, его переадресует на данный номер. |
| no_agent_timeout_transfer_dst | string | нет | null | В случае, если звонящий вышел по истечению max_wait_time_with_no_agent, его переадресует на данный номер. |
| tier_rules_apply |
booleanstring | нет |
| null | Требуется ли применение параметров tier_rule_wait_second и tier_rule_wait_multiply_level |
| tier_rule_wait_second |
integerstring | нет | null | Время в секундах с начала поступления вызова в очередь, по истечении которого начинают вызываться агенты следующего уровня. Если параметр tier_rule_wait_multiply_level установлен в true, то указанное время умножается на уровень агента в очереди. Если параметр tier_rule_wait_multiply_level установлен в false, то по истечении указанного времени агенты всех уровней выше минимального становятся доступны для вызова в соотвествии со стратегией очереди. | |
| tier_rule_wait_multiply_level | boolean | нет | false | Если параметр имеет значение true, время tier_rule_wait_second умножается на уровень агента. |
| exit_with_no_av_agents | boolean | нет | false | Если активна - вызов не попадет в очередь, если в очереди нет агентов |
| skip_busy_agents | boolean | нет | false | Очередь попытается не вызывать агентов занятых в разговоре не из этой очереди |
| vm_enabled | boolean | нет | false | Вкл\выкл голосовой почты в очереди |
| vm_greeting | | нет | null | Звук, который будет проигран перед включением голосовой почты |
| vm_mailto | string | нет | null | Адрес почтового ящика, куда будет направлено уведомление о голосовой почте |
| vm_attach_file | boolean | нет | false | Помимо уведомления будет направлена и сама запись голосовой почты |
| try_same_agent_time | integer | нет | null | Система попытается соединить конкретного звонящего с конкретным агентом, если этот агент ранее уже отвечал этому звонящему, если соединить не получится, либо звонящий ранее ни с кем не общался - вызов пойдет по стратегии обзвона очереди. Значение в секундах от 1 до 2592000 |
| agent_hangup_action | string | нет | null | Может быть либо 'transfer', либо 'quality_rate' |
agent_hangup_transfer_dst | string | нет | null | После окончания разговора, если первым положит трубку агент - вызов будет пеадресован на номер, указанный в agent_hangup_transfer_dst Работает только при agent_hangup_action='transfer' |
| quality_rate_sound | integer | нет | null | После окончания разговора, если первым положит трубку агент - звонящему в очередь проиграется звук, за которым последует ожидание оценки. Работает только при agent_hangup_action='quality_rate' |
| quality_rate_finish_sound | integer | нет | null | Звук, который будет проигран после выбранной оценки. Работает только при agent_hangup_action='quality_rate' |
| quality_rate_max | integer | нет | null | Максимальная оценка, которую можно будет указать. Работает только при agent_hangup_action='quality_rate' |
| append_to_cid_name_on_transfer | string | нет | null | При переадресации к имени звонящему будет добавлен признак переадресации из этой очереди |
Anchor Стратегии очереди Стратегии очереди
Стратегии очереди
При любой стратегии сначала вызываются агенты с наименьшим уровнем. Если агенты текущего уровня обзвона заняты, либо находятся в состоянии временной недоступности например, после не ответа или отклонения предыдущего вызова (см. конфигурацию агента), то вызываются агенты следующего уровня. Если параметр 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 | Вызывается агент с наибольшим временем ожидания c момента последнего разговора. |
| round-robin | Агенты вызываются согласно их позиции (параметр position при добавлении агента в очередь). |
| top-down | Агенты вызываются в порядке из позиций, начиная с первой. |
| agent-with-least-talk-time | Вызывается агент с наименьшим временем разговора. |
| agent-with-fewest-calls | Вызывается агент с наименьшим количеством звонков. |
| sequentially-by-agent-order | Агенты вызываются последовательно в порядке их уровней и позиций. Первым всегда вызывается агент с наименьшем уровнем и позицией. |
| random | Агенты вызываются в случайном порядке. |
...