Description of Data Structures
Expand |
---|
|
The following parameters can be configured for the queue: Parameter | Type | Mandatory | Default value | Description |
---|
agent_announce_sound | long | no | 0 | Sound that will be played to the queue agent when answering to the caller | agent_hangup_action | string | no | | Can be either 'transfer' or 'quality_rate' | agent_hangup_transfer_dst | string | no | | After the end of the conversation, if the agent hangs up first, the call will be forwarded to the number specified in agent_hangup_transfer_dst. Only works when agent_hangup_action = 'transfer' | agent_report_wait_time | boolean | no | true | Queue agent when answering the caller, will be told the response time in seconds for the answer by the caller | announce_frequency | long | no | 0 | The sound frequency announce_sound in seconds | announce_sound | long | no | 0 | The sound played at a specified time interval at the time the caller is waiting for an answer. The playback frequency is set by the parameter announce_frequency | append_to_cid_name_on_transfer | string | no | | When forwarding to the name of the caller, a forwarding flag from this queue will be added | exit_key | string | no | | The button, when pressed exits the queue. Can be a digital button, as well as buttons * and # | exit_transfer_dst | string | no | | If the caller pressed the button from exit_key, he will be forwarded to this number | exit_with_no_av_agents | boolean | no | true | If this parameter is active, the call will not be queued if there are no agents in the queue | max_wait_time | long | no | 0 | The maximum time the caller waits in the queue are in seconds. After this time, the queue is exited | max_wait_time_with_no_agent | long | no | 0 | The maximum time the caller waits in the queue are in seconds. After this time, if there is no available agent in the queue, the queue is exited | no_agent_timeout_transfer_dst | string | no | | If the caller left after expires max_wait_time_with_no_agent, he will be forwarded to this number | position_announce_frequency | long | no | 0 | The frequency of announcement of the caller position in the queue in relation to others waiting for an answer. Not used, unless specified, cannot be less than 1 second | quality_rate_finish_sound | long | no | 0 | The sound that will be played after the selected rating. Works only if agent_hangup_action = 'quality_rate' | quality_rate_max | long | no | 0 | The maximum rating that can be specified. Works only if agent_hangup_action= 'quality_rate' | quality_rate_sound | long | no | 0 | If the queue agent hangs up first after the end of the conversation, a sound will be played to the caller, followed by waiting for the evaluation. Works only if agent_hangup_action= 'quality_rate' | record_enabled | boolean | no | true | Enables the conversation recording in the queue | skip_busy_agents | boolean | no | true | The queue will try not to call agents engaged in a conversation not from this queue | sound | long | no | 0 | The main sound that will be heard by callers in the queue. Needs to specify id of the resource sound | sound_type | string | no | music | The main type of the sound can be set to music or ring. If set to ring then the caller hears normal beeps, while the passed parameter sound is ignored, and the already set sound is reset to null. If the parameter is set to music then the sound specified in the sound parameter will be played | start_sound | long | no | 0 | The sound played to the caller when he is queued. Played until the agents are called | strategy | string | no | "round-robin" | The strategy for calling queue agents. For details, see Queue Strategies | tier_rule_wait_multiply_level | boolean | no | true | If the parameter is set to true, the time tier_rule_wait_second is multiplied by the agent level | tier_rule_wait_second | long | no | 0 | Time in seconds from the start of a call to the queue, after which the next level agents are called. If the parameter tier_rule_wait_multiply_levelis isset to true then the specified time is multiplied by the agent level in the queue. If the parameter tier_rule_wait_multiply_level isset to false, then after the time indicated agents at all levels above the minimum are available for the call in accordance with the line strategy | tier_rules_apply | boolean | no | true | Whether the use of parameters are required tier_rule_wait_second and tier_rule_wait_multiply_level | timeout_transfer_dst | string | no | | If the caller left after the max_wait_time, he will be forwarded to this number | try_same_agent_time | long | no | 0 | The system will try to connect a specific caller with a specific queue agent, if this agent has already answered to this caller before. If the connection fails or the caller has not communicated with anyone before, the call will follow the dialing queue strategy. The value is in seconds from 1 to 2592000 | vm_attach_file | boolean | no | true | In addition to the notification of the incoming voicemail, the voicemail recording itself will be sent | vm_enabled | boolean | no | true | Enable/disable the voicemail in the queue | vm_greeting | long | no | 0 | Звук, который будет проигран перед включением голосовой почты The sound that will be played before the voicemail is started | vm_mailto | string | no | | The mailbox address to which the voicemail notification will be sent |
|
Queue Strategies
At any strategy the agents with the lowest level are called first. If the agents of the current call level are busy or are in a state of temporary unavailability, for example, after no answer or rejection of the previous call (see the agent configuration), then agents of the next level are called. If the parameter tier_rules_apply valueis true, the next-level agents start to be called after the time specified by the parameter tier_rule_wait_second, the report begins when the current level agents start calling. If the parameter tier_rule_wait_multiply_level value is true, then the time tier_rule_wait_second is multiplied by the agent level.
Expand |
---|
title | Description of the queue strategies |
---|
|
Strategy | Description |
---|
ring-all | All available agents are called simultaneously. If the parameter tier_rules_apply is true, the agents with the lowest level are called first then after the time specified by the parameter tier_rule_wait_second, thenext level agents are called and so on | longest-idle-agent | The agent is called with the longest waiting time since the last call | round-robin | Agents are called according to their position (the position parameter when adding the agent to the queue) | top-down | Agents are called in the positions order starting from the first | agent-with-least-talk-time | The agent with the least talk time is called | agent-with-fewest-calls | The agent with the fewest calls is dialed | sequentially-by-agent-order | Agents are called sequentially in such order of their levels and positions. The agent with the lowest level and position is always called first. | random | Agents are called in a random order |
|
Queue Agents
The queue agents can be of two types: local, when the agent is an extension number of the telephone terminal type, and remote, when the specified external number is the queue agent. Both types of agents have the following configurable parameters:
Expand |
---|
title | Parameters of the queue agents |
---|
|
Parameter | Type | Mandatory | Default value | Description |
---|
busy_delay_time | long | no | 0 | If the agent was busy |
|
when trying to call, at a call attempt then no calls will be sent to it, during the time specified in this parameter in seconds | call_timeout | long | no | 0 | Time in seconds during which |
|
theagent the agent is called | extra_ |
|
paramscalledadditional Additional parameters | name | string |
|
Nono | | Queue agent name | no_answer_delay_time | long | no | 0 | If the agent did not answer the call, no calls will be sent to it during the time in seconds specified in this parameter |
|
in seconds | number | string | no | | Queue agent number | reject_delay_time | long | no | 0 | Time in seconds since the agent's last rejection of the call, during which no calls will be sent to it | status | object | no | |
|
Agent The agent status. Accepts one of the values: "logged_out", "available".In |
|
thestatus the status available theagent is available for calls, in |
|
thestatus the status logged_outno calls to the agent are not sent | wrap_up_time | long | no | 0 | Time in seconds since the last conversation of the agent during which no calls will be sent to it |
|
him Sound Звук, проигрываемый вызывающему абоненту и агенту очереди при ответе этим агентом The sound played to the caller and the queue agent when |
|
answering this
Expand |
---|
title | Parameters of the queue agents |
---|
|
Queue agent management
In order for an agent to receive calls from a queue, the agent must be added there. Adding the agent to the queue, removing it from there, as well as changing its level and position in the queue are carried out through the resources "local agent in the queue"and "external agent in the queue" for local and external agents, respectively.
When adding a local agent to the queue, the following parameters can be configured:
Parameter | Type | Mandatory | Default value | Description |
---|
busydelay_timeнетcall_timeout Если агент при попытке вызова был занят, то в течение указанного в этом параметре времени в секундах ему не будут направляться вызовы | Identifier of the local agent |
level | long |
нетВремя в секундах, в течение которого осуществляется вызов агента | extra_params | string | нет | | Дополнительные параметры |
name | string | нет | | Имя агента очереди |
no_answer_delay_time | long | нет | 0 | Если агент не ответил на вызов, то в течение указанного в этом параметре времени в секундах ему не будут направляться вызовы |
number | string | нет | | Номер агента очереди |
reject_delay_time | long | нет | 0 | Время в секундах с момента последнего отклонения вызова агентом, в течение которого ему не будут направляться вызовы |
status | object | нет | | Статус агента. Принимает одно из значений: "logged_out", "available". В статусе available агент доступен для вызовов, в статусе logged_out вызовы агенту не направляются |
wrap_up_time | long | нет | 0 | Время в секундах с момента последнего разговора агента, в течение которого ему не будут направляться вызовы |
agent_sound_id | long | нет | 0 | Звук, проигрываемый вызывающему абоненту и агенту очереди при ответе этим агентом |
Управление агентом в очереди
Для того, чтобы агент мог принимать вызовы из очереди, он должен быть туда добавлен. Добавление агента в очередь, его удаление оттуда, а также изменение его уровня и позиции в очереди осуществляются через ресурсы "локальный агент в очереди" и "внешний агент в очереди" для локальных и внешних агентов соответственно.
При добавлении локального агента в очередь возможно настроить следующие параметры:
Параметр | Тип | Обязательный | Значение по умолчанию | Описание |
---|
agent_id | long | да | 0 | Идентификатор локального агента |
level | long | нет | 0 | Уровень агента в очереди |
position | long | нет | 0 | Позиция агента в очереди |
При добавлении внешнего агента в очередь возможно настроить следующие параметры:
Параметр | Тип | Обязательный | Значение по умолчанию | Описание |
---|
agent_id | long | да | 0 | Идентификатор внешнего агента |
level | long | нет | 0 | Уровень агента в очереди |
position | long | нет | 0 | Позиция агента в очереди |
Значение счетчика звонящих в очереди (формируется на основании событий dial-in и hangup) можно получить с помощью ресурсаAgent level in queue |
position | long | no | 0 | Agent position in the queue |
When adding an external agent to the queue, the following parameters can be configured:
Parameter | Type | Mandatory | Default value | Description |
---|
agent_id | long | yes | 0 | Identifier of the external agent |
level | long | no | 0 | Agent level in queue |
position | long | no | 0 | Agent position in the queue |
The value of the counter of callers in the queue (generated based on dial-in and hangup events) can be obtained using the resource
GET /extension/{extension_id}/queue/status/Данный ресурс возвращает ответы вида
This resource returns the responses in the form:
Code Block |
---|
|
{
"answered_members": 0,
"trying_members": 0,
"waiting_members": 0
} |
где параметр where the parameter trying_members – это количество звонящих и ожидающих ответа агентов очереди.
Т.к. количество запросов лимитировано, рекомендуется запрашивать количество звонящих в очереди именно по событиям очереди, можно добавить события answer самих внутренних номеров (агентов очереди).
Примеры
В качестве примера создадим внутренний номер типа "очередь", настроим его, создадим локальных и внешних агентов и добавим их в очередь.
Используя ресурс "
Внутренний номер", создадим внутренний номер типа "queue":
Ответ системы:
Code Block |
---|
is the number of callers and waiting the queue agents' response. Because the number of requests is limited, it is recommended to request the number of callers in the queue exactly by the queue events. Is possible to add events answer of the extension numbers themselves (the queue agents).
Examples
As an example, let's create an internal number of the "queue" type, configure it, create local and external agents and add them to the queue.
1. Using the "resource Extension number", create an internal number of the "queue" type:
…
…
…
System response:
Code Block |
---|
|
{
"status": "active",
"domain": "sip.ringme.ru",
"create_date": "2020-03-16 12:11:13",
"name": "000*370",
"dial_rule_limit": null,
"extension_group_id": null,
"label": "тестоваяtest очередьqueue",
"caller_id_name": null,
"client_id": 12,
"extra_params": null,
"message_did": null,
"dial_rule_id": null,
"ani_rfc3325": false,
"type": "queue",
"id": 208,
"did_as_transfer_caller_id": null
} |
Настроим очередь следующим образом:
Главным звуком очереди должен являться звук с идентификатором 36;
Звуком анонса звук с идентификатором 35;
Анонс должен проигрываться через каждые 15 секунд;
Максимальное время ожидания в очереди – 1800 секунд;
Если было превышено максимальное время ожидания, переадресовывать вызывающего абонента на номер 333;
Стратегия обзвона агентов очереди – "Звонить всем";
Запись разговоров в очереди включена;
Агенты вышестоящего уровня должны начинать вызываться, если агенты нижестоящего уровня не отвечают в течение 15 секунд.
Expand |
---|
|
Code Block |
---|
2. Set up the queue as follows:
The main sound of the queue should be the sound with the ID 36;
The sound of the announcement is the sound with the identifier 35;
The announcement should be played every 15 seconds;
The maximum waiting time in the queue is 1800 seconds;
If the maximum waiting time has been exceeded forward the caller to the number 333;
Calling strategy of the queue agents - "Call everyone";
Recording of conversations in the queue is enabled;
Higher-level agents should start to be dialed if the lower-level agents do not respond within 15 seconds.
…
…
…
Expand |
---|
|
Code Block |
---|
| {
"announce_sound": 35,
"start_sound": "null",
"agent_hangup_transfer_dst": null,
"append_to_cid_name_on_transfer": null,
"agent_announce_sound": null,
"position_announce_frequency": 30,
"agent_hangup_action": null,
"tier_rule_wait_multiply_level": false,
"vm_mailto": null,
"no_agent_timeout_transfer_dst": "0005*103",
"agent_report_wait_time": false,
"vm_enabled": false,
"quality_rate_sound": null,
"strategy": "ring-all",
"try_same_agent_time": 259200,
"record_enabled": true,
"vm_attach_file": true,
"skip_busy_agents": true,
"sound_type": "music",
"tier_rules_apply": true,
"vm_greeting": null,
"quality_rate_finish_sound": null,
"announce_frequency": 15,
"exit_transfer_dst": null,
"tier_rule_wait_second": 5,
"sound": 36,
"exit_with_no_av_agents": true,
"quality_rate_max": null,
"timeout_transfer_dst": "333",
"max_wait_time": 1800,
"exit_key": null,
"max_wait_time_with_no_agent": null
} |
|
Создадим локального агента очереди:
Ответ системы3. Create a local queue agent:
…
…
System response:
Code Block |
---|
|
{
"status": "available",
"name": null,
"busy_delay_time": 10,
"no_answer_delay_time": 10,
"call_timeout": 30,
"wrap_up_time": 0,
"extension_id": 117,
"reject_delay_time": 10,
"extra_params": null,
"id": 1
} |
Создадим внешнего агента очереди:
Ответ системы4. Create an external queue agent:
…
…
System response:
Code Block |
---|
|
{
"busy_delay_time": 10,
"call_timeout": 30,
"extra_params": "string",
"id": 9,
"name": "string",
"no_answer_delay_time": 10,
"number": "89876543210",
"reject_delay_time": 10,
"status": "available",
"wrap_up_time": 0
} |
Добавим локального агента в очередь с первой позицией и первым уровнем:
Ответ системы5. Add the local agent to the queue with the first position and the first level:
…
…
System response:
Code Block |
---|
|
{
"position": 1,
"agent_id": 1,
"level": 1
} |
Добавим внешнего агента в очередь с первой позицией и вторым уровнем:
Ответ системы:
code6. Add an external agent to the queue with the first position and the second level:
…
…
System response:
Code Block |
---|
|
{
"position": 1,
"agent_id": 9,
"level": 2
} |
Ресурсы раздела “Внутренний номер”
Конфигурация очереди
Expand |
---|
title | PUT /extension/{extension_id}/queue/ |
---|
|
PUT /extension/{extension_id}/queue/ Обновить параметры очереди Параметры URL Параметры JSON Имя | Тип | Обязательный |
---|
agent_announce_sound | long | нет | agent_hangup_action | string | нет | agent_hangup_transfer_dst | string | нет | agent_report_wait_time | boolean | нет | announce_frequency | long | нет | announce_sound | long | нет | append_to_cid_name_on_transfer | string | нет | exit_key | string | нет | exit_transfer_dst | string | нет | exit_with_no_av_agents | boolean | нет | max_wait_time | long | нет | max_wait_time_with_no_agent | long | нет | no_agent_timeout_transfer_dst | string | нет | position_announce_frequency | long | нет | quality_rate_finish_sound | long | нет | quality_rate_max | long | нет | quality_rate_sound | long | нет | record_enabled | boolean | нет | skip_busy_agents | boolean | нет | sound | long | нет | sound_type | string | нет | start_sound | long | нет | strategy | string | нет | tier_rule_wait_multiply_level | boolean | нет | tier_rule_wait_second | long | нет | tier_rules_apply | boolean | нет | timeout_transfer_dst | string | нет | try_same_agent_time | long | нет | vm_attach_file | boolean | нет | vm_enabled | boolean | нет | vm_greeting | long | нет | vm_mailto | string | нет |
Поля ответа Имя | Тип |
---|
agent_announce_sound | long | agent_hangup_action | string | agent_hangup_transfer_dst | string | agent_report_wait_time | boolean | announce_frequency | long | announce_sound | long | append_to_cid_name_on_transfer | string | exit_key | string | exit_transfer_dst | string | exit_with_no_av_agents | boolean | max_wait_time | long | max_wait_time_with_no_agent | long | no_agent_timeout_transfer_dst | string | position_announce_frequency | long | quality_rate_finish_sound | long | quality_rate_max | long | quality_rate_sound | long | record_enabled | boolean | skip_busy_agents | boolean | sound | long | sound_type | string | start_sound | long | strategy | string | tier_rule_wait_multiply_level | boolean | tier_rule_wait_second | long | tier_rules_apply | boolean | timeout_transfer_dst | string | try_same_agent_time | long | vm_attach_file | boolean | vm_enabled | boolean | vm_greeting | long | vm_mailto | string |
|
Expand |
---|
title | GET /extension/{extension_id}/queue/ |
---|
|
GET /extension/{extension_id}/queue/ Получить параметры очереди Параметры URL Поля ответа Имя | Тип |
---|
agent_announce_sound | long | agent_hangup_action | string | agent_hangup_transfer_dst | string | agent_report_wait_time | boolean | announce_frequency | long | announce_sound | long | append_to_cid_name_on_transfer | string | exit_key | string | exit_transfer_dst | string | exit_with_no_av_agents | boolean | max_wait_time | long | max_wait_time_with_no_agent | long | no_agent_timeout_transfer_dst | string | position_announce_frequency | long | quality_rate_finish_sound | long | quality_rate_max | long | quality_rate_sound | long | record_enabled | boolean | skip_busy_agents | boolean | sound | long | sound_type | string | start_sound | long | strategy | string | tier_rule_wait_multiply_level | boolean | tier_rule_wait_second | long | tier_rules_apply | boolean | timeout_transfer_dst | string | try_same_agent_time | long | vm_attach_file | boolean | vm_enabled | boolean | vm_greeting | long | vm_mailto | string |
|
Expand |
---|
title | GET /extension/{extension_id}/queue/status/ |
---|
|
GET /extension/{extension_id}/queue/status/ Получить статус очереди Параметры URL Поля ответа Имя | Тип |
---|
answered_members | long | trying_members | long | waiting_members | long |
|
Конфигурация локального агента в очереди
Expand |
---|
title | POST /extension/{extension_id}/queue/agents/local/ |
---|
|
POST /extension/{extension_id}/queue/agents/local/ Добавить локального агента в очередь Параметры URL Параметры JSON Имя | Тип | Обязательный |
---|
agent_id | long | да | level | long | нет | position | long | нет |
Поля ответа Имя | Тип |
---|
agent_id | long | level | long | position | long |
|
Expand |
---|
title | GET /extension/{extension_id}/queue/agents/local/ |
---|
|
GET /extension/{extension_id}/queue/agents/local/ Получить список локальных агентов очереди Параметры URL Поля ответа Имя | Тип |
---|
agent_id | long | level | long | position | long |
|
Expand |
---|
title | PUT /extension/{extension_id}/queue/agents/local/{agent_id} |
---|
|
PUT /extension/{extension_id}/queue/agents/local/{agent_id} Обновить конфигурацию локального агента в очереди Параметры URL Имя | Тип |
---|
extension_id | string | agent_id | integer |
Параметры JSON Имя | Тип | Обязательный |
---|
position | long | нет | level | long | нет |
Поля ответа Имя | Тип |
---|
agent_id | long | level | long | position | long |
|
Expand |
---|
title | GET /extension/{extension_id}/queue/agents/local/{agent_id} |
---|
|
GET /extension/{extension_id}/queue/agents/local/{agent_id} Получить конфигурацию локального агента в очереди Параметры URL Имя | Тип |
---|
extension_id | string | agent_id | integer |
Поля ответа Имя | Тип |
---|
agent_id | long | level | long | position | long |
|
Expand |
---|
title | DELETE /extension/{extension_id}/queue/agents/local/{agent_id} |
---|
|
DELETE /extension/{extension_id}/queue/agents/local/{agent_id} Удалить локального агента из очереди Параметры URL Имя | Тип |
---|
extension_id | string | agent_id | integer |
|
Конфигурация внешнего агента в очереди
Expand |
---|
title | POST /extension/{extension_id}/queue/agents/remote/ |
---|
|
POST /extension/{extension_id}/queue/agents/remote/ Добавить внешнего агента в очередь Параметры URL Параметры JSON Имя | Тип | Обязательный |
---|
agent_id | long | да | level | long | нет | position | long | нет |
Поля ответа Имя | Тип |
---|
agent_id | long | level | long | position | long |
|
Expand |
---|
title | GET /extension/{extension_id}/queue/agents/remote/ |
---|
|
GET /extension/{extension_id}/queue/agents/remote/ Получить список внешних агентов в очереди Параметры URL Поля ответа Имя | Тип |
---|
agent_id | long | level | long | position | long |
|
Expand |
---|
title | PUT /extension/{extension_id}/queue/agents/remote/{agent_id} |
---|
|
PUT /extension/{extension_id}/queue/agents/remote/{agent_id} Обновить конфигурацию внешнего агента в очереди Параметры URL Имя | Тип |
---|
extension_id | string | agent_id | integer |
Параметры JSON Имя | Тип | Обязательный |
---|
position | long | нет | level | long | нет |
Поля ответа Имя | Тип |
---|
agent_id | long | level | long | position | long |
|
Expand |
---|
title | GET /extension/{extension_id}/queue/agents/remote/{agent_id} |
---|
|
GET /extension/{extension_id}/queue/agents/remote/{agent_id} Получить конфигурацию внешнего агента в очереди Параметры URL Имя | Тип |
---|
extension_id | string | agent_id | integer |
Поля ответа Имя | Тип |
---|
agent_id | long | level | long | position | long |
|
Expand |
---|
title | DELETE /extension/{extension_id}/queue/agents/remote/{agent_id} |
---|
|
DELETE /extension/{extension_id}/queue/agents/remote/{agent_id} Удалить внешнего агента из очереди Параметры URL Имя | Тип |
---|
extension_id | string | agent_id | integer |
|
Ресурсы раздела "Клиент"
Локальные агенты
Expand |
---|
title | POST /client/{client_id}/agent/local/ |
---|
|
POST /client/{client_id}/agent/local/ Добавить локального агента клиента Параметры URL Параметры JSON Имя | Тип | Обязательный |
---|
busy_delay_time | long | нет | call_timeout | long | нет | extension_id | long | да | extra_params | string | нет | name | string | да | no_answer_delay_time | long | нет | reject_delay_time | long | нет | status | string | нет | wrap_up_time | long | нет |
Поля ответа Имя | Тип |
---|
busy_delay_time | long | call_timeout | long | extension_id | long | extra_params | string | id | long | name | string | no_answer_delay_time | long | reject_delay_time | long | status | object | wrap_up_time | long |
|
Expand |
---|
title | GET /client/{client_id}/agent/local/ |
---|
|
GET /client/{client_id}/agent/local/ Получить список локальных агентов клиента Параметры URL Параметры запроса Имя | Тип |
---|
extension_id | array [integer] |
Поля ответа Имя | Тип |
---|
busy_delay_time | long | call_timeout | long | extension_id | long | extra_params | string | id | long | name | string | no_answer_delay_time | long | reject_delay_time | long | status | object | wrap_up_time | long |
|
Expand |
---|
title | PUT /client/{client_id}/agent/local/{agent_id} |
---|
|
PUT /client/{client_id}/agent/local/{agent_id} Обновить локального агента Параметры URL Имя | Тип |
---|
agent_id | integer | client_id | string |
Параметры JSON Имя | Тип | Обязательный |
---|
busy_delay_time | long | нет | call_timeout | long | нет | extra_params | string | нет | name | string | да | no_answer_delay_time | long | нет | reject_delay_time | long | нет | status | string | нет | wrap_up_time | long | нет |
Поля ответа Имя | Тип |
---|
busy_delay_time | long | call_timeout | long | extension_id | long | extra_params | string | id | long | name | string | no_answer_delay_time | long | reject_delay_time | long | status | object | wrap_up_time | long |
|
Expand |
---|
title | GET /client/{client_id}/agent/local/{agent_id} |
---|
|
GET /client/{client_id}/agent/local/{agent_id} Получить локального агента Параметры URL Имя | Тип |
---|
agent_id | integer | client_id | string |
Поля ответа Имя | Тип |
---|
busy_delay_time | long | call_timeout | long | extension_id | long | extra_params | string | id | long | name | string | no_answer_delay_time | long | reject_delay_time | long | status | object | wrap_up_time | long |
|
Expand |
---|
title | DELETE /client/{client_id}/agent/local/{agent_id} |
---|
|
DELETE /client/{client_id}/agent/local/{agent_id} Удалить локального агента. Если параметр remove_from_queues установлен в false, то при нахождении удаляемого агента хотя бы в одной очереди будет возвращена ошибка. Если параметр установлен в true (по умолчанию), то агент удалится также и из очередей. Параметры URL Имя | Тип |
---|
agent_id | integer | client_id | string |
Параметры запроса Имя | Тип |
---|
remove_from_queues | boolean |
|
Внешние агенты
Expand |
---|
title | POST /client/{client_id}/agent/remote/ |
---|
|
POST /client/{client_id}/agent/remote/ Добавить внешнего агента Параметры URL Параметры JSON Имя | Тип | Обязательный |
---|
busy_delay_time | long | нет | call_timeout | long | нет | extra_params | string | нет | name | string | да | no_answer_delay_time | long | нет | number | string | да | reject_delay_time | long | нет | status | string | нет | wrap_up_time | long | нет |
Поля ответа Имя | Тип |
---|
busy_delay_time | long | call_timeout | long | extra_params | string | id | long | name | string | no_answer_delay_time | long | number | string | reject_delay_time | long | status | object | wrap_up_time | long |
|
Expand |
---|
title | GET /client/{client_id}/agent/remote/ |
---|
|
GET /client/{client_id}/agent/remote/ Получить список внешних агентов клиента Параметры URL Поля ответа Имя | Тип |
---|
busy_delay_time | long | call_timeout | long | extra_params | string | id | long | name | string | no_answer_delay_time | long | number | string | reject_delay_time | long | status | object | wrap_up_time | long |
|
Expand |
---|
title | PUT /client/{client_id}/agent/remote/{agent_id} |
---|
|
PUT /client/{client_id}/agent/remote/{agent_id} Обновить внешнего агента Параметры URL Имя | Тип |
---|
agent_id | integer | client_id | string |
Параметры JSON Имя | Тип | Обязательный |
---|
busy_delay_time | long | нет | call_timeout | long | нет | extra_params | string | нет | name | string | нет | no_answer_delay_time | long | нет | number | string | нет | reject_delay_time | long | нет | status | string | нет | wrap_up_time | long | нет |
Поля ответа Имя | Тип |
---|
busy_delay_time | long | call_timeout | long | extra_params | string | id | long | name | string | no_answer_delay_time | long | number | string | reject_delay_time | long | status | object | wrap_up_time | long |
|
Expand |
---|
title | GET /client/{client_id}/agent/remote/{agent_id} |
---|
|
GET /client/{client_id}/agent/remote/{agent_id} Получить внешнего агента Параметры URL Имя | Тип |
---|
agent_id | integer | client_id | string |
Поля ответа Имя | Тип |
---|
busy_delay_time | long | call_timeout | long | extra_params | string | id | long | name | string | no_answer_delay_time | long | number | string | reject_delay_time | long | status | object | wrap_up_time | long |
|
Expand |
---|
title | DELETE /client/{client_id}/agent/remote/{agent_id} |
---|
|
DELETE /client/{client_id}/agent/remote/{agent_id} Удалить внешнего агента. Если параметр remove_from_queues установлен в false, то при нахождении удаляемого агента хотя бы в одной очереди будет возвращена ошибка. Если параметр установлен в true (по умолчанию), то агент удалится также и из очередей. Параметры URL Name | Type |
---|
agent_id | integer | client_id | string |
Параметры запроса Name | Type |
---|
remove_from_queues | boolean |
|