SmartQueue
Methods
GetSmartQueueDayHistory
Gets the metrics for the specified SmartQueue for the last 2 days. Refer to the SmartQueue reporting guide to learn more.
Parameters
application_id:
number
The application ID to search by
application_name:
string
The application name to search by. Can be used instead of the application_id parameter
from_date:
timestamp
OptionalThe from date in the selected timezone in 24-h format: YYYY-MM-DD HH:mm:ss. Default is the current time minus 1 day
group_by:
string
OptionalGroup the result by agent or queue. The agent grouping is allowed only for 1 queue and for the occupancy_rate, sum_agents_online_time, sum_agents_ready_time, sum_agents_dialing_time, sum_agents_in_service_time, sum_agents_afterservice_time, sum_agents_dnd_time, sum_agents_banned_time, min_handle_time, max_handle_time, average_handle_time, count_handled_calls, min_after_call_worktime, max_after_call_worktime, average_after_call_worktime report types. The queue grouping allowed for the calls_blocked_percentage, count_blocked_calls, average_abandonment_rate, count_abandonment_calls, service_level, occupancy_rate, min_time_in_queue, max_time_in_queue, average_time_in_queue, min_answer_speed, max_answer_speed, average_answer_speed, min_handle_time, max_handle_time, average_handle_time, count_handled_calls, min_after_call_worktime, max_after_call_worktime, average_after_call_worktime report types
interval:
string
OptionalDefaults on: 0-0-1 0:0:0Interval format: YYYY-MM-DD HH:mm:ss. Default is 1 day
max_waiting_sec:
number
OptionalMaximum waiting time. Required for the service_level report type
report_type:
stringlist
The report type. Possible values are: calls_blocked_percentage, count_blocked_calls, im_blocked_chats_percentage, im_count_blocked_chats, im_answered_chats_rate, average_abandonment_rate, count_abandonment_calls, service_level, im_service_level, occupancy_rate, im_agent_occupancy_rate, agent_utilization_rate, im_agent_utilization_rate, sum_agents_online_time, sum_agents_ready_time, sum_agents_dialing_time, sum_agents_in_service_time, sum_agents_in_service_incoming_time, sum_agents_in_service_outcoming_time, sum_agents_afterservice_time, sum_agents_dnd_time, sum_agents_custom_1_time, sum_agents_custom_2_time, sum_agents_custom_3_time, sum_agents_custom_4_time, sum_agents_custom_5_time, sum_agents_custom_6_time, sum_agents_custom_7_time, sum_agents_custom_8_time, sum_agents_custom_9_time, sum_agents_custom_10_time, sum_agents_banned_time, im_sum_agents_online_time, im_sum_agents_ready_time, im_sum_agents_in_service_time, im_sum_agents_dnd_time, im_sum_agents_custom_1_time, im_sum_agents_custom_2_time, im_sum_agents_custom_3_time, im_sum_agents_custom_4_time, im_sum_agents_custom_5_time, im_sum_agents_custom_6_time, im_sum_agents_custom_7_time, im_sum_agents_custom_8_time, im_sum_agents_custom_9_time, im_sum_agents_custom_10_time, im_sum_agents_banned_time, average_agents_idle_time, max_agents_idle_time, min_agents_idle_time, percentile_0_25_agents_idle_time, percentile_0_50_agents_idle_time, percentile_0_75_agents_idle_time, min_time_in_queue, max_time_in_queue, average_time_in_queue, min_answer_speed, max_answer_speed, average_answer_speed, im_min_answer_speed, im_max_answer_speed, im_average_answer_speed, min_handle_time, max_handle_time, average_handle_time, count_handled_calls, min_after_call_worktime, max_after_call_worktime, average_after_call_worktime, count_agent_unanswered_calls, im_count_agent_unanswered_chats, min_reaction_time, max_reaction_time, average_reaction_time, im_min_reaction_time, im_max_reaction_time, im_average_reaction_time, im_count_abandonment_chats, im_count_lost_chats, im_lost_chats_rate
sq_queue_id:
intlist
The SmartQueue ID list with a maximum of 5 values separated by semicolons (;). Can operate as filter for the calls_blocked_percentage, count_blocked_calls, average_abandonment_rate, count_abandonment_calls, service_level, occupancy_rate, min_time_in_queue, max_time_in_queue, average_time_in_queue, min_answer_speed, max_answer_speed, average_answer_speed, min_handle_time, max_handle_time, average_handle_time, count_handled_calls, min_after_call_worktime, max_after_call_worktime, average_after_call_worktime report types
sq_queue_name:
stringlist
OptionalThe SmartQueue name list separated by semicolons (;). Can be used instead of sq_queue_id
timezone:
string
OptionalDefaults on: UTCThe selected timezone or the 'auto' value (the account location)
to_date:
timestamp
OptionalThe to date in the selected timezone in 24-h format: YYYY-MM-DD HH:mm:ss. Default is the current time
user_id:
intlist
OptionalThe user ID list with a maximum of 5 values separated by semicolons (;). Use the 'all' value to select all users. Can operate as a filter for the occupancy_rate, sum_agents_online_time, sum_agents_ready_time, sum_agents_dialing_time, sum_agents_in_service_time, sum_agents_afterservice_time, sum_agents_dnd_time, sum_agents_banned_time, min_handle_time, max_handle_time, average_handle_time, count_handled_calls, min_after_call_worktime, max_after_call_worktime, average_after_call_worktime report types
user_name:
stringlist
OptionalThe user name list separated by semicolons (;). user_name can be used instead of user_id
Returns
result:
timezone:
string
The used timezone, e.g., 'Etc/GMT'
GetSmartQueueRealtimeMetrics
Gets the metrics for the specified SmartQueue for the last 30 minutes. Refer to the SmartQueue reporting guide to learn more.
Parameters
application_id:
number
The application ID to search by
application_name:
string
The application name to search by. Can be used instead of the application_id parameter
from_date:
timestamp
OptionalThe from date in the selected timezone in 24-h format: YYYY-MM-DD HH:mm:ss. Default is the current time minus 30 minutes
group_by:
string
OptionalGroup the result by agent or queue. The agent grouping is allowed for 1 queue and for the occupancy_rate, sum_agents_online_time, sum_agents_ready_time, sum_agents_dialing_time, sum_agents_in_service_time, sum_agents_afterservice_time, sum_agents_dnd_time, sum_agents_banned_time, min_handle_time, max_handle_time, average_handle_time, count_handled_calls, min_after_call_worktime, max_after_call_worktime, average_after_call_worktime report types. The queue grouping allowed for the calls_blocked_percentage, count_blocked_calls, average_abandonment_rate, count_abandonment_calls, service_level, occupancy_rate, min_time_in_queue, max_time_in_queue, average_time_in_queue, min_answer_speed, max_answer_speed, average_answer_speed, min_handle_time, max_handle_time, average_handle_time, count_handled_calls, min_after_call_worktime, max_after_call_worktime, average_after_call_worktime report types
interval:
string
OptionalDefaults on: 0-0-0 0:30:0Interval format: YYYY-MM-DD HH:mm:ss. Default is 30 minutes
max_waiting_sec:
number
OptionalMaximum waiting time. Required for the service_level report type
report_type:
stringlist
The report type. Possible values are: calls_blocked_percentage, count_blocked_calls, im_blocked_chats_percentage, im_count_blocked_chats, im_answered_chats_rate, average_abandonment_rate, count_abandonment_calls, service_level, im_service_level, occupancy_rate, im_agent_occupancy_rate, agent_utilization_rate, im_agent_utilization_rate, sum_agents_online_time, sum_agents_ready_time, sum_agents_dialing_time, sum_agents_in_service_time, sum_agents_in_service_incoming_time, sum_agents_in_service_outcoming_time, sum_agents_afterservice_time, sum_agents_dnd_time, sum_agents_custom_1_time, sum_agents_custom_2_time, sum_agents_custom_3_time, sum_agents_custom_4_time, sum_agents_custom_5_time, sum_agents_custom_6_time, sum_agents_custom_7_time, sum_agents_custom_8_time, sum_agents_custom_9_time, sum_agents_custom_10_time, sum_agents_banned_time, im_sum_agents_online_time, im_sum_agents_ready_time, im_sum_agents_in_service_time, im_sum_agents_dnd_time, im_sum_agents_custom_1_time, im_sum_agents_custom_2_time, im_sum_agents_custom_3_time, im_sum_agents_custom_4_time, im_sum_agents_custom_5_time, im_sum_agents_custom_6_time, im_sum_agents_custom_7_time, im_sum_agents_custom_8_time, im_sum_agents_custom_9_time, im_sum_agents_custom_10_time, im_sum_agents_banned_time, average_agents_idle_time, max_agents_idle_time, min_agents_idle_time, percentile_0_25_agents_idle_time, percentile_0_50_agents_idle_time, percentile_0_75_agents_idle_time, min_time_in_queue, max_time_in_queue, average_time_in_queue, min_answer_speed, max_answer_speed, average_answer_speed, im_min_answer_speed, im_max_answer_speed, im_average_answer_speed, min_handle_time, max_handle_time, average_handle_time, count_handled_calls, min_after_call_worktime, max_after_call_worktime, average_after_call_worktime, count_agent_unanswered_calls, im_count_agent_unanswered_chats, min_reaction_time, max_reaction_time, average_reaction_time, im_min_reaction_time, im_max_reaction_time, im_average_reaction_time, im_count_abandonment_chats, im_count_lost_chats, im_lost_chats_rate
sq_queue_id:
intlist
OptionalThe SmartQueue ID list with a maximum of 5 values separated by semicolons (;). Can operate as filter for the calls_blocked_percentage, count_blocked_calls, average_abandonment_rate, count_abandonment_calls, service_level, occupancy_rate, min_time_in_queue, max_time_in_queue, average_time_in_queue, min_answer_speed, max_answer_speed, average_answer_speed, min_handle_time, max_handle_time, average_handle_time, count_handled_calls, min_after_call_worktime, max_after_call_worktime, average_after_call_worktime report types
sq_queue_name:
stringlist
OptionalThe SmartQueue name list separated by semicolons (;). Can be used instead of sq_queue_id
timezone:
string
OptionalDefaults on: UTCThe selected timezone or the 'auto' value (the account location)
to_date:
timestamp
OptionalThe to date in the selected timezone in 24-h format: YYYY-MM-DD HH:mm:ss. Default is the current time
user_id:
intlist
OptionalThe user ID list with a maximum of 5 values separated by semicolons (;). Use the 'all' value to select all users. Can operate as a filter for the occupancy_rate, sum_agents_online_time, sum_agents_ready_time, sum_agents_dialing_time, sum_agents_in_service_time, sum_agents_afterservice_time, sum_agents_dnd_time, sum_agents_banned_time, min_handle_time, max_handle_time, average_handle_time, count_handled_calls, min_after_call_worktime, max_after_call_worktime, average_after_call_worktime report types
user_name:
stringlist
OptionalThe user name list separated by semicolons (;). user_name can be used instead of user_id
Returns
result:
timezone:
string
The used timezone, e.g., 'Etc/GMT'
GetSQState
Gets the current state of the specified SmartQueue.
Parameters
application_id:
number
The application ID to search by
application_name:
string
OptionalThe application name to search by. Can be used instead of the application_id parameter
sq_queue_id:
intlist
The SmartQueue ID list separated by semicolons (;). Use the 'all' value to select all SmartQueues
sq_queue_name:
stringlist
OptionalThe SmartQueue name list separated by semicolons (;). Can be used instead of sq_queue_id
timezone:
string
OptionalDefaults on: UTCThe selected timezone or the 'auto' value (the account location)
Returns
result:
RequestSmartQueueHistory
Gets history for the specified SmartQueue. Refer to the SmartQueue reporting guide to learn more.
Parameters
application_id:
number
The application ID to search by
application_name:
string
The application name to search by. Can be used instead of the application_id parameter
from_date:
timestamp
The from date in the selected timezone in 24-h format: YYYY-MM-DD HH:mm:ss. Default is the current time minus 1 day
group_by:
string
OptionalGroup the result by agent or queue. The agent grouping is allowed only for 1 queue and for the occupancy_rate, sum_agents_online_time, sum_agents_ready_time, sum_agents_dialing_time, sum_agents_in_service_time, sum_agents_afterservice_time, sum_agents_dnd_time, sum_agents_banned_time, min_handle_time, max_handle_time, average_handle_time, count_handled_calls, min_after_call_worktime, max_after_call_worktime, average_after_call_worktime report types. The queue grouping allowed for the calls_blocked_percentage, count_blocked_calls, average_abandonment_rate, count_abandonment_calls, service_level, occupancy_rate, min_time_in_queue, max_time_in_queue, average_time_in_queue, min_answer_speed, max_answer_speed, average_answer_speed, min_handle_time, max_handle_time, average_handle_time, count_handled_calls, min_after_call_worktime, max_after_call_worktime, average_after_call_worktime report types
interval:
string
OptionalDefaults on: 0-0-1 0:0:0Interval format: YYYY-MM-DD HH:mm:ss. Default is 1 day
max_waiting_sec:
number
OptionalMaximum waiting time. Required for the service_level report type
report_type:
stringlist
The report type. Possible values are: calls_blocked_percentage, count_blocked_calls, im_blocked_chats_percentage, im_count_blocked_chats, im_answered_chats_rate, average_abandonment_rate, count_abandonment_calls, service_level, im_service_level, occupancy_rate, im_agent_occupancy_rate, agent_utilization_rate, im_agent_utilization_rate, sum_agents_online_time, sum_agents_ready_time, sum_agents_dialing_time, sum_agents_in_service_time, sum_agents_in_service_incoming_time, sum_agents_in_service_outcoming_time, sum_agents_afterservice_time, sum_agents_dnd_time, sum_agents_custom_1_time, sum_agents_custom_2_time, sum_agents_custom_3_time, sum_agents_custom_4_time, sum_agents_custom_5_time, sum_agents_custom_6_time, sum_agents_custom_7_time, sum_agents_custom_8_time, sum_agents_custom_9_time, sum_agents_custom_10_time, sum_agents_banned_time, im_sum_agents_online_time, im_sum_agents_ready_time, im_sum_agents_in_service_time, im_sum_agents_dnd_time, im_sum_agents_custom_1_time, im_sum_agents_custom_2_time, im_sum_agents_custom_3_time, im_sum_agents_custom_4_time, im_sum_agents_custom_5_time, im_sum_agents_custom_6_time, im_sum_agents_custom_7_time, im_sum_agents_custom_8_time, im_sum_agents_custom_9_time, im_sum_agents_custom_10_time, im_sum_agents_banned_time, average_agents_idle_time, max_agents_idle_time, min_agents_idle_time, percentile_0_25_agents_idle_time, percentile_0_50_agents_idle_time, percentile_0_75_agents_idle_time, min_time_in_queue, max_time_in_queue, average_time_in_queue, min_answer_speed, max_answer_speed, average_answer_speed, im_min_answer_speed, im_max_answer_speed, im_average_answer_speed, min_handle_time, max_handle_time, average_handle_time, count_handled_calls, min_after_call_worktime, max_after_call_worktime, average_after_call_worktime, count_agent_unanswered_calls, im_count_agent_unanswered_chats, min_reaction_time, max_reaction_time, average_reaction_time, im_min_reaction_time, im_max_reaction_time, im_average_reaction_time, im_count_abandonment_chats, im_count_lost_chats, im_lost_chats_rate
sq_queue_id:
intlist
The SmartQueue ID list with a maximum of 5 values separated by semicolons (;). Can operate as filter for the calls_blocked_percentage, count_blocked_calls, average_abandonment_rate, count_abandonment_calls, service_level, occupancy_rate, min_time_in_queue, max_time_in_queue, average_time_in_queue, min_answer_speed, max_answer_speed, average_answer_speed, min_handle_time, max_handle_time, average_handle_time, count_handled_calls, min_after_call_worktime, max_after_call_worktime, average_after_call_worktime report types
sq_queue_name:
stringlist
OptionalThe SmartQueue name list separated by semicolons (;). Can be used instead of sq_queue_id
timezone:
string
OptionalDefaults on: UTCThe selected timezone or the 'auto' value (the account location)
to_date:
timestamp
The to date in the selected timezone in 24-h format: YYYY-MM-DD HH:mm:ss. Default is the current time
user_id:
intlist
OptionalThe user ID list with a maximum of 5 values separated by semicolons (;). Use the 'all' value to select all users. Can operate as a filter for the occupancy_rate, sum_agents_online_time, sum_agents_ready_time, sum_agents_dialing_time, sum_agents_in_service_time, sum_agents_afterservice_time, sum_agents_dnd_time, sum_agents_banned_time, min_handle_time, max_handle_time, average_handle_time, count_handled_calls, min_after_call_worktime, max_after_call_worktime, average_after_call_worktime report types
user_name:
stringlist
OptionalThe user name list separated by semicolons (;). Can be used instead of user_id
Returns
history_report_id:
number
History report ID
result:
number
1
SQ_AddQueue
Adds a new queue.
Parameters
application_id:
number
ID of the application to bind to
application_name:
string
OptionalName of the application to bind to. Can be used instead of application_id
call_agent_selection:
string
Agent selection strategy for calls. Accepts one of the following values: "MOST_QUALIFIED", "LEAST_QUALIFIED", "MAX_WAITING_TIME"
call_max_queue_size:
number
OptionalDefaults on: 1000Maximum size of the queue with CALL-type requests
call_max_waiting_time:
number
OptionalDefaults on: 120Maximum time in minutes that a CALL-type request can remain in the queue without being assigned to an agent
call_task_selection:
string
Call type requests prioritizing strategy. Accepts one of the SQTaskSelectionStrategies enum values
description:
string
OptionalComment, up to 200 characters
im_agent_selection:
string
OptionalAgent selection strategy for messages. Accepts one of the following values: "MOST_QUALIFIED", "LEAST_QUALIFIED", "MAX_WAITING_TIME". The default value is call_agent_selection
im_max_queue_size:
number
OptionalDefaults on: 1000Maximum size of the queue with IM-type requests
im_max_waiting_time:
number
OptionalDefaults on: 120Maximum time in minutes that an IM-type request can remain in the queue without being assigned to an agent
im_task_selection:
string
OptionalIM type requests prioritizing strategy. Accepts one of the SQTaskSelectionStrategies enum values. The default value is call_task_selection
priority:
number
OptionalDefaults on: 10The queue's priority from 1 to 100
sq_queue_name:
string
Unique SmartQueue name within the application, up to 100 characters
Returns
sq_queue_id:
number
ID of the added queue
SQ_AddSkill
Adds a new skill to the app.
Parameters
application_id:
number
ID of the application to bind to
application_name:
string
OptionalName of the application to bind to. Can be used instead of application_id
description:
string
OptionalComment, up to 200 characters
sq_skill_name:
string
Unique skill name within the application
Returns
result:
number
1
SQ_BindAgent
Binds agents to a queue.
Parameters
application_id:
number
ID of the application to search by
application_name:
string
OptionalName of the application to search by. Can be used instead of application_id
bind_mode:
string
OptionalDefaults on: add_queuesBinding mode. Accepts one of the SQAgentBindingModes enum values
sq_queue_id:
string
ID of the SmartQueue. Pass a list of values divided by ; or the "all" keyword
sq_queue_name:
string
OptionalName of the SmartQueue. Pass a list of names divided by ; or the "all" keyword
user_id:
intlist
List of user IDs separated by semicolons (;). Use 'all' to select all the users
user_name:
stringlist
OptionalList of user names separated by semicolons (;). Can be used instead of user_id
Returns
result:
number
1
SQ_BindSkill
Binds skills to agents.
Parameters
application_id:
number
ID of the application to search by
application_name:
string
OptionalName of the application to search by. Can be used instead of application_id
bind_mode:
string
OptionalDefaults on: add_queuesBinding mode. Accepts one of the SQSkillBindingModes enum values
sq_skills:
Object
Skills to be bound to agents in the json array format. The array should contain objects with the sq_skill_id/sq_skill_name and sq_skill_level keys where skill levels range from 1 to 5
user_id:
intlist
List of user IDs separated by semicolons (;). Use 'all' to select all the users
user_name:
stringlist
OptionalList of user names separated by semicolons (;). Can be used instead of user_id
Returns
result:
number
1
SQ_DeleteAgentCustomStatusMapping
Removes a mapping from the mapping table. If there is no such mapping, does nothing.
Parameters
application_id:
number
Application ID
sq_status_name:
string
OptionalStatus name
Returns
result:
number
1
SQ_DelQueue
Deletes a queue.
Parameters
application_id:
number
ID of the application to search by
application_name:
string
OptionalName of the application to search by. Can be used instead of application_id
sq_queue_id:
intlist
List of SmartQueue IDs separated by semicolons (;). Use 'all' to delete all the queues
sq_queue_name:
stringlist
OptionalList of SmartQueue names separated by semicolons (;). Can be used instead of sq_queue_id
Returns
result:
number
1
SQ_DelSkill
Deletes a skill and detaches it from agents.
Parameters
application_id:
number
ID of the application to search by
application_name:
string
OptionalName of the application to search by. Can be used instead of application_id
sq_skill_id:
intlist
List of skill IDs separated by semicolons (;). Use 'all' to delete all the skills
sq_skill_name:
stringlist
OptionalList of skill names separated by semicolons (;). Can be used instead of sq_skill_id
Returns
result:
number
1
SQ_GetAgentCustomStatusMapping
Returns the mapping list of SQ statuses and custom statuses. SQ statuses are returned whether or not they have mappings to custom statuses.
Parameters
application_id:
number
OptionalApplication ID
Returns
custom_status_name:
string
Custom status name
sq_status_name:
string
Status name
SQ_GetAgents
Gets agents.
Parameters
application_id:
number
ID of the application to search by
application_name:
string
OptionalName of the application to search by. Can be used instead of application_id
count:
number
OptionalDefaults on: 20Number of items to show in the output
excluded_sq_queue_id:
number
OptionalID of the SmartQueue to exclude
excluded_sq_queue_name:
string
OptionalName of the SmartQueue to exclude. Can be used instead of excluded_sq_queue_id
handle_calls:
boolean
Whether the agent can handle calls. When set to false, the agent is excluded from the CALL-request distribution
offset:
number
OptionalDefaults on: 0Number of items to skip in the output
sq_queue_id:
intlist
OptionalList of SmartQueue IDs separated by semicolons (;). Use 'all' to select all the queues
sq_queue_name:
stringlist
OptionalList of SmartQueue names separated by semicolons (;). Can be used instead of sq_queue_id
sq_skills:
Object
OptionalSkills to filter in the json array format. The array should contain objects with the sq_skill_id/sq_skill_name, min_sq_skill_level, and max_sq_skill_level keys where skill levels range from 1 to 5
sq_statuses:
Object
OptionalFilter statuses in the json array format. The array should contain objects with the sq_status_type and sq_status_name keys. Possible values for sq_status_type are 'CALL' and'IM'. Possible values for sq_status_name are 'OFFLINE', 'ONLINE', 'READY', 'IN_SERVICE', 'AFTER_SERVICE', 'DND'
user_id:
intlist
OptionalList of user IDs separated by semicolons (;)
user_name:
stringlist
OptionalList of user names separated by semicolons (;). Can be used instead of user_id
user_name_template:
string
OptionalSubstring of the user name to filter
with_sq_queues:
boolean
OptionalDefaults on: falseWhether to display agent queues
with_sq_skills:
boolean
OptionalDefaults on: falseWhether to display agent skills
with_sq_statuses:
boolean
OptionalDefaults on: falseWhether to display agent current statuses
Returns
result:
The found agent(s)
SQ_GetQueues
Gets the queue(s).
Parameters
application_id:
number
ID of the application to search by
application_name:
string
OptionalName of the application to search by. Can be used instead of application_id
count:
number
OptionalDefaults on: 20Number of items to show in the output
excluded_user_id:
number
OptionalID of the user that is not bound to the queue
excluded_user_name:
string
OptionalName of the user that is not bound to the queue. Can be used instead of excluded_user_id
offset:
number
OptionalDefaults on: 0Number of items to skip in the output
sq_queue_id:
intlist
OptionalList of SmartQueue IDs separated by semicolons (;)
sq_queue_name:
stringlist
OptionalList of SmartQueue names separated by semicolons (;). Can be used instead of sq_queue_id
sq_queue_name_template:
string
OptionalSubstring of the SmartQueue name to filter
user_id:
number
OptionalID of the user that is bound to the queue
user_name:
string
OptionalName of the user that is bound to the queue. Can be used instead of user_id
with_agentcount:
boolean
OptionalDefaults on: falseWhether to include the number of agents bound to the queue
Returns
result:
The found queue(s)
SQ_GetSkills
Gets the skill(s).
Parameters
application_id:
number
ID of the application to search by
application_name:
string
OptionalName of the application to search by. Can be used instead of application_id
count:
number
OptionalDefaults on: 20Number of items to show in the output
excluded_user_id:
number
OptionalID of the user that is not bound to the skill
excluded_user_name:
string
OptionalName of the user that is not bound to the skill. Can be used instead of excluded_user_id
offset:
number
OptionalDefaults on: 0Number of items to skip in the output
sq_skill_id:
intlist
OptionalList of skill IDs separated by semicolons (;)
sq_skill_name:
stringlist
OptionalList of skill names separated by semicolons (;). Can be used instead of sq_skill_id
sq_skill_name_template:
string
OptionalSubstring of the skill name to filter, case-insensitive
user_id:
intlist
OptionalList of user IDs separated by semicolons (;)
user_name:
stringlist
OptionalList of user names separated by semicolons (;). Can be used instead of user_id
Returns
result:
The found skill(s).
SQ_SetAgentCustomStatusMapping
Adds a status if there is no match for the given internal status and renames it if there is a match. It means that if the passed sq_status_name parameter is not in the mapping table, a new entry is created in there; if it is, the name field in its mapping is replaced with custom_status_name.
Parameters
application_id:
number
Application ID
custom_status_name:
string
Custom status name
sq_status_name:
string
Status name
Returns
result:
number
1
SQ_SetAgentInfo
Edits the agent settings.
Parameters
application_id:
number
ID of the application to search by
application_name:
string
OptionalName of the application to search by. Can be used instead of application_id
handle_calls:
boolean
Whether the agent can handle calls. When set to false, the agent is excluded from the CALL-request distribution
max_simultaneous_conversations:
number
OptionalDefaults on: 5Maximum number of chats that the user processes simultaneously
user_id:
intlist
List of user IDs separated by semicolons (;). Use 'all' to select all the users
user_name:
stringlist
OptionalList of user names separated by semicolons (;). Can be used instead of user_id
Returns
result:
number
1
SQ_SetQueueInfo
Edits an existing queue.
To call this method, make sure your service account has one of the following roles:
Parameters
application_id:
number
ID of the application to search by
application_name:
string
OptionalName of the application to search by. Can be used instead of application_id
call_agent_selection:
string
OptionalAgent selection strategy for calls. Accepts one of the following values: "MOST_QUALIFIED", "LEAST_QUALIFIED", "MAX_WAITING_TIME"
call_max_queue_size:
number
OptionalDefaults on: 1000Maximum size of the queue with CALL-type requests
call_max_waiting_time:
number
OptionalDefaults on: 120Maximum time in minutes that a CALL-type request can remain in the queue without being assigned to an agent
call_task_selection:
string
OptionalStrategy of prioritizing CALL-type requests for service. Accepts one of the following values: "MAX_PRIORITY", "MAX_WAITING_TIME"
description:
string
OptionalComment, up to 200 characters
im_agent_selection:
string
OptionalAgent selection strategy for messages. Accepts one of the following values: "MOST_QUALIFIED", "LEAST_QUALIFIED", "MAX_WAITING_TIME". The default value is call_agent_selection
im_max_queue_size:
number
OptionalDefaults on: 1000Maximum size of the queue with IM-type requests
im_max_waiting_time:
number
OptionalDefaults on: 120Maximum time in minutes that an IM-type request can remain in the queue without being assigned to an agent
im_task_selection:
string
OptionalStrategy of prioritizing IM-type requests for service. Accepts one of the following values: "MAX_PRIORITY", "MAX_WAITING_TIME". The default value is call_task_selection
new_sq_queue_name:
string
OptionalNew SmartQueue name within the application, up to 100 characters
priority:
number
OptionalDefaults on: 10The queue's priority from 1 to 100
sq_queue_id:
number
ID of the SmartQueue to search for
sq_queue_name:
string
OptionalName of the SmartQueue to search for. Can be used instead of sq_queue_id
Returns
result:
number
1
SQ_SetSkillInfo
Edits an existing skill.
Parameters
application_id:
number
ID of the application to search by
application_name:
string
OptionalName of the application to search by. Can be used instead of application_id
description:
string
OptionalComment, up to 200 characters
new_sq_skill_name:
string
OptionalNew unique skill name within the application
sq_skill_id:
number
ID of the skill
sq_skill_name:
string
OptionalName of the skill. Can be used instead of sq_skill_id
Returns
result:
number
1
SQ_UnbindAgent
Unbinds agents from queues.
Parameters
application_id:
number
ID of the application to search by
application_name:
string
OptionalName of the application to search by. Can be used instead of application_id
sq_queue_id:
intlist
List of SmartQueue IDs separated by semicolons (;). Use 'all' to select all the queues
sq_queue_name:
stringlist
OptionalList of SmartQueue names separated by semicolons (;). Can be used instead of sq_queue_id
user_id:
intlist
List of user IDs separated by semicolons (;). Use 'all' to select all the users
user_name:
stringlist
OptionalList of user names separated by semicolons (;). Can be used instead of user_id
Returns
result:
number
1
SQ_UnbindSkill
Unbinds skills from agents.
Parameters
application_id:
number
ID of the application to search by
application_name:
string
OptionalName of the application to search by. Can be used instead of application_id
sq_skill_id:
intlist
List of skill IDs separated by semicolons (;). Use 'all' to undbind all the skills
sq_skill_name:
stringlist
OptionalList of skill names separated by semicolons (;). Can be used instead of sq_skill_id
user_id:
intlist
List of user IDs separated by semicolons (;). Use 'all' to select all the users
user_name:
stringlist
OptionalList of user names separated by semicolons (;). Can be used instead of user_id
Returns
result:
number
1