Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

You can test API methods on the interactive API browser page and without writing code
Some of the resources described on the page may not be available by default due to the type of application (see Creating and authorizing applications).

Queue configuration

Internal numbers of the queue type are used to implement the functionality of the call center. To configure a new queue is needed to create an extension number, specifying it as the type (parameter type) value queue. After that, it becomes possible to configure the queue and queue agents through the API-interface queue.

Queue agent events (login/logout) are tracked using the resource Queue Agent Events.

The sound files required to configure the queue are uploaded using the resource Sound Files.

Table of Contents

Description of Data Structures

Expand
titleExpand

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
titleDescription 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
titleParameters 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_

paramscalled

params 

string

no

 

additional

Additional parameters

name

string

No

no

 

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

agent_sound_id

long

no

0

Sound

Звук, проигрываемый вызывающему абоненту и агенту очереди при ответе этим агентом

The sound played to the caller and the queue agent when

answering

answered by

this

that agent

 

Expand
titleParameters 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

busy

agent_

delay_time

id

long

нетcall_timeout 

yes

0

Если агент при попытке вызова был занят, то в течение указанного в этом параметре времени в секундах ему не будут направляться вызовы

Identifier of the local agent

level 

long

нет

no

0

Время в секундах, в течение которого осуществляется вызов агента

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
languagejson
{
  "answered_members": 0,
  "trying_members": 0,
  "waiting_members": 0
}

где параметр where the parameter trying_members – это количество звонящих и ожидающих ответа агентов очереди.
Т.к. количество запросов лимитировано, рекомендуется запрашивать количество звонящих в очереди именно по событиям очереди, можно добавить события answer самих внутренних номеров (агентов очереди).

Примеры

В качестве примера создадим внутренний номер типа "очередь", настроим его, создадим локальных и внешних агентов и добавим их в очередь.

  1. Используя ресурс "

Внутренний номер", создадим внутренний номер типа "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
languagejson
{
  "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
}
  1. Настроим очередь следующим образом:

  • Главным звуком очереди должен являться звук с идентификатором 36;

  • Звуком анонса звук с идентификатором 35;

  • Анонс должен проигрываться через каждые 15 секунд;

  • Максимальное время ожидания в очереди – 1800 секунд;

  • Если было превышено максимальное время ожидания, переадресовывать вызывающего абонента на номер 333;

  • Стратегия обзвона агентов очереди – "Звонить всем";

  • Запись разговоров в очереди включена;

  • Агенты вышестоящего уровня должны начинать вызываться, если агенты нижестоящего уровня не отвечают в течение 15 секунд.

Expand
titleОтвет системы:
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
titleSystem response:
Code Block
languagejson
{
  "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
}
  1. Создадим локального агента очереди:

Ответ системы3. Create a local queue agent:

System response:

Code Block
languagejson
{
  "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
}
  1. Создадим внешнего агента очереди:

Ответ системы4. Create an external queue agent:


System response:

Code Block
languagejson
{
  "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
}
  1. Добавим локального агента в очередь с первой позицией и первым уровнем:

Ответ системы5. Add the local agent to the queue with the first position and the first level:

System response:

Code Block
languagejson
{
  "position": 1,
  "agent_id": 1,
  "level": 1
}
  1. Добавим внешнего агента в очередь с первой позицией и вторым уровнем:

Ответ системы:

code

6. Add an external agent to the queue with the first position and the second level:


System response:

Code Block
languagejson
{
  "position": 1,
  "agent_id": 9,
  "level": 2
}

Ресурсы раздела “Внутренний номер”

Конфигурация очереди

Expand
titlePUT /extension/{extension_id}/queue/

PUT /extension/{extension_id}/queue/

Обновить параметры очереди

Параметры URL

Имя

Тип

extension_id

string

Параметры 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
titleGET /extension/{extension_id}/queue/

GET /extension/{extension_id}/queue/

Получить параметры очереди

Параметры URL

Имя

Тип

extension_id

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
titleGET /extension/{extension_id}/queue/status/

GET /extension/{extension_id}/queue/status/

Получить статус очереди

Параметры URL

Имя

Тип

extension_id

string

Поля ответа

Имя

Тип

answered_members 

long

trying_members 

long

waiting_members

long

Конфигурация локального агента в очереди

Expand
titlePOST /extension/{extension_id}/queue/agents/local/

POST /extension/{extension_id}/queue/agents/local/

Добавить локального агента в очередь

Параметры URL

Имя

Тип

extension_id

string

Параметры JSON

Имя

Тип

Обязательный

agent_id

long

да

level

long

нет

position

long

нет

Поля ответа

Имя

Тип

agent_id

long

level

long

position

long

Expand
titleGET /extension/{extension_id}/queue/agents/local/

GET /extension/{extension_id}/queue/agents/local/

Получить список локальных агентов очереди

Параметры URL

Имя

Тип

extension_id

string

Поля ответа

Имя

Тип

agent_id

long

level

long

position

long

Expand
titlePUT /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
titleGET /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
titleDELETE /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
titlePOST /extension/{extension_id}/queue/agents/remote/

POST /extension/{extension_id}/queue/agents/remote/

Добавить внешнего агента в очередь

Параметры URL

Имя

Тип

extension_id

string

Параметры JSON

Имя

Тип

Обязательный

agent_id

long

да

level

long

нет

position

long

нет

Поля ответа

Имя

Тип

agent_id

long

level

long

position

long

Expand
titleGET /extension/{extension_id}/queue/agents/remote/

GET /extension/{extension_id}/queue/agents/remote/

Получить список внешних агентов в очереди

Параметры URL

Имя

Тип

extension_id

string

Поля ответа

Имя

Тип

agent_id

long

level

long

position

long

Expand
titlePUT /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
titleGET /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
titleDELETE /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
titlePOST /client/{client_id}/agent/local/

POST /client/{client_id}/agent/local/

Добавить локального агента клиента

Параметры URL

Имя

Тип

client_id

string

Параметры 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
titleGET /client/{client_id}/agent/local/

GET /client/{client_id}/agent/local/

Получить список локальных агентов клиента

Параметры URL

Имя

Тип

client_id

string

Параметры запроса

Имя

Тип

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
titlePUT /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
titleGET /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
titleDELETE /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
titlePOST /client/{client_id}/agent/remote/

POST /client/{client_id}/agent/remote/

Добавить внешнего агента

Параметры URL

Имя

Тип

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
titleGET /client/{client_id}/agent/remote/

GET /client/{client_id}/agent/remote/

Получить список внешних агентов клиента

Параметры URL

Имя

Тип

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
titlePUT /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
titleGET /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
titleDELETE /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