/genesys-tasks-quality | Type: Application | PCID required: Yes
Tools
genesys_tasks_quality_delete_conversation_evaluation
Delete an evaluation Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | conversationId |
evaluationId | string | Yes | — | evaluationId |
expand | string | No | — | evaluatorId, evaluationForm |
genesys_tasks_quality_delete_forms_evaluation
Delete an evaluation form. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
formId | string | Yes | — | Form ID |
genesys_tasks_quality_delete_forms_survey
Delete a survey form. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
formId | string | Yes | — | Form ID |
genesys_tasks_quality_delete_program_agentscoringrule
Delete an Agent Scoring Rule Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
programId | string | Yes | — | Program ID from Speech and Text Analytics |
ruleId | string | Yes | — | Agent Scoring Rule ID |
genesys_tasks_quality_delete_taskmanagement_workitem
Delete a workitem Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workitemId | string | Yes | — | Workitem ID |
genesys_tasks_quality_delete_workbin
Delete a workbin Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workbinId | string | Yes | — | Workbin ID |
genesys_tasks_quality_delete_workitem
Delete a workitem Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workitemId | string | Yes | — | Workitem ID |
genesys_tasks_quality_delete_worktype
Delete a worktype Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
worktypeId | string | Yes | — | Worktype id |
genesys_tasks_quality_delete_worktype_status
Delete a status Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
worktypeId | string | Yes | — | Worktype id |
statusId | string | Yes | — | Status id |
genesys_tasks_quality_get_agents_activity
Gets a list of Agent Activities Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
pageSize | integer | No | — | The total page size requested |
pageNumber | integer | No | — | The page number requested |
sortBy | string | No | — | variable name requested to sort by |
expand | any[] | No | — | variable name requested by expand list |
nextPage | string | No | — | next page token |
previousPage | string | No | — | Previous page token |
startTime | string | No | — | Start time of agent activity based on assigned date. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
endTime | string | No | — | End time of agent activity based on assigned date. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
agentUserId | any[] | No | — | user id of agent requested |
evaluatorUserId | string | No | — | user id of the evaluator |
name | string | No | — | name |
group | string | No | — | group id |
agentTeamId | string | No | — | team id of agents requested |
formContextId | string | No | — | shared id between form versions |
userState | string | No | — | ‘Legacy’ fetches active and inactive users when evaluatorUserId or no user filters are supplied; otherwise fetches active users. ‘Any’ fetches users of ‘active’, ‘inactive’ and ‘deleted’ states. |
genesys_tasks_quality_get_conversation_evaluation
Get an evaluation Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | conversationId |
evaluationId | string | Yes | — | evaluationId |
expand | string | No | — | agent, assignee, evaluator, evaluationForm |
genesys_tasks_quality_get_conversation_surveys
Get the surveys for a conversation Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | conversationId |
genesys_tasks_quality_get_conversations_audits_query_transaction_id
Get status of audit query execution Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
transactionId | string | Yes | — | Transaction ID |
genesys_tasks_quality_get_conversations_audits_query_transaction_id_results
Get results of audit query Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
transactionId | string | Yes | — | Transaction ID |
cursor | string | No | — | Indicates where to resume query results (not required for first page) |
pageSize | integer | No | — | Page size |
expand | any[] | No | — | Which fields, if any, to expand |
genesys_tasks_quality_get_evaluations_query
Queries Evaluations and returns a paged list Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
pageSize | integer | No | — | The total page size requested |
pageNumber | integer | No | — | The page number requested |
expand | any[] | No | — | variable name requested by expand list |
previousPage | string | No | — | Previous page token |
conversationId | string | No | — | conversationId specified |
agentUserId | string | No | — | user id of the agent |
agentTeamId | string | No | — | team id of the agent |
evaluatorUserId | string | No | — | evaluator user id |
assigneeUserId | string | No | — | assignee user id |
queueId | string | No | — | queue id |
startTime | string | No | — | start time of the evaluation query |
endTime | string | No | — | end time of the evaluation query |
formContextId | string | No | — | shared id between form versions |
evaluationState | any[] | No | — | evaluationState |
isReleased | boolean | No | — | the evaluation has been released |
agentHasRead | boolean | No | — | agent has the evaluation |
expandAnswerTotalScores | boolean | No | — | get the total scores for evaluations. NOTE: The answers will only be populated if this parameter is set to true in the request. |
maximum | integer | No | — | the maximum number of results to return |
sortOrder | string | No | — | NOTE: Does not work when conversationId is supplied. |
includeDeletedUsers | boolean | No | — | Allow returning an agent or evaluator user with a ‘delete’ status. Defaults to false. |
genesys_tasks_quality_get_evaluators_activity
Get an evaluator activity. To ensure optimal performance and prevent timeouts when processing large datasets, startTime and endTime fields are highly recommended for all requests. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
pageSize | integer | No | — | The total page size requested |
pageNumber | integer | No | — | The page number requested |
sortBy | string | No | — | variable name requested to sort by |
expand | any[] | No | — | variable name requested by expand list |
nextPage | string | No | — | next page token |
previousPage | string | No | — | Previous page token |
startTime | string | No | — | The start time specified. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
endTime | string | No | — | The end time specified. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
name | string | No | — | Evaluator name |
permission | any[] | No | — | permission strings |
group | string | No | — | group id |
agentTeamId | string | No | — | team id of agents to be considered |
genesys_tasks_quality_get_forms_evaluation
Get an evaluation form Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
formId | string | Yes | — | Form ID |
genesys_tasks_quality_get_forms_evaluation_versions
Gets all the revisions for a specific evaluation. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
formId | string | Yes | — | Form ID |
pageSize | integer | No | — | Page size |
pageNumber | integer | No | — | Page number |
sortOrder | string | No | — | Sort order |
genesys_tasks_quality_get_forms_evaluations
Get the list of evaluation forms Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
pageSize | integer | No | — | The total page size requested |
pageNumber | integer | No | — | The page number requested |
sortBy | string | No | — | variable name requested to sort by |
nextPage | string | No | — | next page token |
previousPage | string | No | — | Previous page token |
expand | string | No | — | If ‘expand=publishHistory’, then each unpublished evaluation form includes a listing of its published versions |
name | string | No | — | Name |
sortOrder | string | No | — | Order to sort results, either asc or desc |
genesys_tasks_quality_get_forms_survey
Get a survey form Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
formId | string | Yes | — | Form ID |
genesys_tasks_quality_get_forms_surveys
Get the list of survey forms. If you set “expand=publishHistory”, then you will be able to get published versions for each corresponding survey form. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
pageSize | integer | No | — | The total page size requested |
pageNumber | integer | No | — | The page number requested |
sortBy | string | No | — | variable name requested to sort by |
nextPage | string | No | — | next page token |
previousPage | string | No | — | Previous page token |
expand | string | No | — | If ‘expand=publishHistory’, then each unpublished evaluation form includes a listing of its published versions |
name | string | No | — | Name |
sortOrder | string | No | — | Order to sort results, either asc or desc |
genesys_tasks_quality_get_program_agentscoringrule
Get an Agent Scoring Rule Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
programId | string | Yes | — | Program ID from Speech and Text Analytics |
ruleId | string | Yes | — | Agent Scoring Rule ID |
genesys_tasks_quality_get_program_agentscoringrules
Get Agent Scoring Rules for a program Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
programId | string | Yes | — | Program ID from Speech and Text Analytics |
genesys_tasks_quality_get_quality_conversation_evaluation
Get an evaluation Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | conversationId |
evaluationId | string | Yes | — | evaluationId |
expand | string | No | — | agent, assignee, evaluator, evaluationForm |
genesys_tasks_quality_get_quality_evaluations_query
Queries Evaluations and returns a paged list Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
pageSize | integer | No | — | The total page size requested |
pageNumber | integer | No | — | The page number requested |
expand | any[] | No | — | variable name requested by expand list |
previousPage | string | No | — | Previous page token |
conversationId | string | No | — | conversationId specified |
agentUserId | string | No | — | user id of the agent |
agentTeamId | string | No | — | team id of the agent |
evaluatorUserId | string | No | — | evaluator user id |
assigneeUserId | string | No | — | assignee user id |
queueId | string | No | — | queue id |
startTime | string | No | — | start time of the evaluation query |
endTime | string | No | — | end time of the evaluation query |
formContextId | string | No | — | shared id between form versions |
evaluationState | any[] | No | — | evaluationState |
isReleased | boolean | No | — | the evaluation has been released |
agentHasRead | boolean | No | — | agent has the evaluation |
expandAnswerTotalScores | boolean | No | — | get the total scores for evaluations. NOTE: The answers will only be populated if this parameter is set to true in the request. |
maximum | integer | No | — | the maximum number of results to return |
sortOrder | string | No | — | NOTE: Does not work when conversationId is supplied. |
includeDeletedUsers | boolean | No | — | Allow returning an agent or evaluator user with a ‘delete’ status. Defaults to false. |
genesys_tasks_quality_get_survey
Get a survey for a conversation Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
surveyId | string | Yes | — | surveyId |
genesys_tasks_quality_get_surveys_scorable
Get a survey as an end-customer, for the purposes of scoring it. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
customerSurveyUrl | string | Yes | — | customerSurveyUrl |
genesys_tasks_quality_get_taskmanagement_workbin
Get a workbin Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workbinId | string | Yes | — | Workbin ID |
genesys_tasks_quality_get_taskmanagement_workitem
Get a workitem Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workitemId | string | Yes | — | Workitem ID |
expands | any[] | No | — | Which fields to expand. Comma separated if more than one. |
genesys_tasks_quality_get_taskmanagement_worktype
Get a worktype Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
worktypeId | string | Yes | — | Worktype id |
expands | any[] | No | — | Which fields, if any, to expand. |
genesys_tasks_quality_get_taskmanagement_worktype_statuses
Get list of statuses for this worktype. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
worktypeId | string | Yes | — | Worktype id |
genesys_tasks_quality_get_workbin
Get a workbin Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workbinId | string | Yes | — | Workbin ID |
genesys_tasks_quality_get_workbin_history
Get a listing of a workbin’s attribute change history Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workbinId | string | Yes | — | Workbin ID |
after | string | No | — | The cursor that points to the end of the set of entities that has been returned. |
pageSize | integer | No | — | Limit the number of entities to return. It is not guaranteed that the requested number of entities will be filled in a single request. If an after key is returned as part of the response it is possible that more entities that match the filter criteria exist. Maximum of 200. |
sortOrder | string | No | — | Ascending or descending sort order |
genesys_tasks_quality_get_workbin_version
Get a version of a workbin Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workbinId | string | Yes | — | Workbin ID |
entityVersion | integer | Yes | — | Workbin version |
genesys_tasks_quality_get_workbin_versions
Get all versions of a workbin Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workbinId | string | Yes | — | Workbin ID |
after | string | No | — | The cursor that points to the end of the set of entities that has been returned. |
pageSize | integer | No | — | Limit the number of entities to return. It is not guaranteed that the requested number of entities will be filled in a single request. If an after key is returned as part of the response it is possible that more entities that match the filter criteria exist. Maximum of 200. |
sortOrder | string | No | — | Ascending or descending sort order |
genesys_tasks_quality_get_workitem
Get a workitem Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workitemId | string | Yes | — | Workitem ID |
expands | any[] | No | — | Which fields to expand. Comma separated if more than one. |
genesys_tasks_quality_get_workitem_history
Get a listing of a workitem’s attribute change history Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workitemId | string | Yes | — | Workitem ID |
after | string | No | — | The cursor that points to the end of the set of entities that has been returned. |
pageSize | integer | No | — | Limit the number of entities to return. It is not guaranteed that the requested number of entities will be filled in a single request. If an after key is returned as part of the response it is possible that more entities that match the filter criteria exist. Maximum of 200. |
sortOrder | string | No | — | Ascending or descending sort order |
genesys_tasks_quality_get_workitem_user_wrapups
Get all wrapup codes added for the given user for a workitem. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workitemId | string | Yes | — | The ID of the Workitem. |
userId | string | Yes | — | The ID of the user |
expands | string | No | — | Which fields, if any, to expand. |
after | string | No | — | The cursor that points to the end of the set of entities that has been returned. |
pageSize | integer | No | — | Limit the number of entities to return. It is not guaranteed that the requested number of entities will be filled in a single request. If an after key is returned as part of the response it is possible that more entities that match the filter criteria exist. Maximum of 50. |
sortOrder | string | No | — | Ascending or descending sort order |
genesys_tasks_quality_get_workitem_version
Get a version of a workitem Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workitemId | string | Yes | — | Workitem ID |
entityVersion | integer | Yes | — | Workitem version |
genesys_tasks_quality_get_workitem_versions
Get all versions of a workitem Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workitemId | string | Yes | — | Workitem ID |
after | string | No | — | The cursor that points to the end of the set of entities that has been returned. |
pageSize | integer | No | — | Limit the number of entities to return. It is not guaranteed that the requested number of entities will be filled in a single request. If an after key is returned as part of the response it is possible that more entities that match the filter criteria exist. Maximum of 200. |
sortOrder | string | No | — | Ascending or descending sort order |
genesys_tasks_quality_get_workitem_wrapups
Get all wrapup codes added for all users for a workitem. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workitemId | string | Yes | — | The ID of the Workitem. |
expands | string | No | — | Which fields, if any, to expand. |
after | string | No | — | The cursor that points to the end of the set of entities that has been returned. |
pageSize | integer | No | — | Limit the number of entities to return. It is not guaranteed that the requested number of entities will be filled in a single request. If an after key is returned as part of the response it is possible that more entities that match the filter criteria exist. Maximum of 50. |
sortOrder | string | No | — | Ascending or descending sort order |
genesys_tasks_quality_get_worktype
Get a worktype Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
worktypeId | string | Yes | — | Worktype id |
expands | any[] | No | — | Which fields, if any, to expand. |
genesys_tasks_quality_get_worktype_history
Get a listing of a worktype’s attribute change history Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
worktypeId | string | Yes | — | Worktype id |
after | string | No | — | The cursor that points to the end of the set of entities that has been returned. |
pageSize | integer | No | — | Limit the number of entities to return. It is not guaranteed that the requested number of entities will be filled in a single request. If an after key is returned as part of the response it is possible that more entities that match the filter criteria exist. Maximum of 200. |
sortOrder | string | No | — | Ascending or descending sort order |
fields | any[] | No | — | Comma-separated list of fields. The response will contain only versions created as a result of changes to these fields. |
genesys_tasks_quality_get_worktype_status
Get a status Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
worktypeId | string | Yes | — | Worktype id |
statusId | string | Yes | — | Status id |
genesys_tasks_quality_get_worktype_statuses
Get list of statuses for this worktype. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
worktypeId | string | Yes | — | Worktype id |
genesys_tasks_quality_get_worktype_version
Get a version of a worktype Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
worktypeId | string | Yes | — | Worktype id |
entityVersion | integer | Yes | — | Worktype version |
genesys_tasks_quality_get_worktype_versions
Get all versions of a worktype Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
worktypeId | string | Yes | — | Worktype id |
after | string | No | — | The cursor that points to the end of the set of entities that has been returned. |
pageSize | integer | No | — | Limit the number of entities to return. It is not guaranteed that the requested number of entities will be filled in a single request. If an after key is returned as part of the response it is possible that more entities that match the filter criteria exist. Maximum of 200. |
sortOrder | string | No | — | Ascending or descending sort order |
genesys_tasks_quality_patch_forms_survey
Disable a particular version of a survey form and invalidates any invitations that have already been sent to customers using this version of the form. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
formId | string | Yes | — | Form ID |
contextId | string | Yes | — | Unique Id for all versions of this form |
disabled | boolean | No | — | Is this form disabled |
footer | string | No | — | Markdown text for the bottom of the form. |
header | string | No | — | Markdown text for the top of the form. |
id | string | No | — | The globally unique identifier for the object. |
language | string | Yes | — | Language for survey viewer localization. Currently localized languages: da, de, en-US, es, fi, fr, it, ja, ko, nl, no, pl, pt-BR, sv, th, tr, zh-CH, zh-TW |
modifiedDate | string | No | — | Last modified date. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
name | string | Yes | — | The survey form name |
published | boolean | No | — | Is this form published |
publishedVersions | object | No | — | publishedVersions |
questionGroups | any[] | No | — | A list of question groups |
selfUri | string | No | — | The URI for this object |
genesys_tasks_quality_patch_taskmanagement_workitem
Update the attributes of a workitem Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workitemId | string | Yes | — | Workitem ID |
assigneeId | string | No | — | The ID of the assignee of the Workitem. If supplied it must be a valid UUID. |
assignmentOperation | string | No | — | Set this value to AgentAssignmentAlerting and supply an ‘assigneeId’ to assign the workitem to an agent and alert the agent of the assignment. Set this value to QueueAssignmentAlerting and supply a ‘queueId’ to route the workitem to an agent who is a member of the queue and alert the agent. |
assignmentState | string | No | — | The assignment state of the Workitem. |
autoStatusTransition | boolean | No | — | Set it to false to disable auto status transition. By default, it is enabled. |
customFields | object | No | — | Custom fields defined in the schema referenced by the worktype of the workitem. If set to {}, the existing keys and values will be removed. |
dateClosed | string | No | — | The closed date of the Workitem. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
dateDue | string | No | — | The due date of the Workitem. Can not be greater than 365 days from the current time. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
dateExpires | string | No | — | The expiry date of the Workitem. Can not be greater than 365 days from the current time. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
description | string | No | — | The description of the Workitem. Maximum length of 512 characters. |
durationSeconds | integer | No | — | The estimated duration in seconds to complete the Workitem. Maximum of 365 days. |
externalContactId | string | No | — | The ID of the external contact of the Workitem. Must be a valid UUID. |
externalTag | string | No | — | The external tag of the Workitem. |
languageId | string | No | — | The ID of language of the Workitem. Must be a valid UUID. |
name | string | No | — | The name of the Workitem. Valid length between 3 and 256 characters. |
preferredAgentIds | any[] | No | — | The preferred agent IDs of the Workitem. Must be valid UUIDs. |
priority | integer | No | — | The priority of the Workitem. The valid range is between -25,000,000 and 25,000,000. |
queueId | string | No | — | The ID of the Workitems queue. Must be a valid UUID. |
scoredAgents | any[] | No | — | A list of scored agents for the Workitem. A workitem can have a maximum of 20 scored agents. |
scriptId | string | No | — | The ID of the Workitems script. Must be a valid UUID. |
skillIds | any[] | No | — | The skill IDs of the Workitem. Must be valid UUIDs. |
statusId | string | No | — | The ID of the Status of the Workitem. |
ttl | integer | No | — | The epoch timestamp in seconds specifying the time to live for the Workitem. Can not be greater than 365 days from the current time. |
utilizationLabelId | string | No | — | The ID of the utilization label of the Workitem. Must be a valid UUID. |
workbinId | string | No | — | The ID of Workbin that contains the Workitem. |
genesys_tasks_quality_patch_taskmanagement_workitem_assignment
Attempts to manually assign a specified workitem to a specified user. Ignores bullseye ring, PAR score, skills, and languages. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workitemId | string | Yes | — | Workitem ID |
id | string | Yes | — | The globally unique identifier for this user. |
genesys_tasks_quality_patch_workbin
Update the attributes of a workbin Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workbinId | string | Yes | — | Workbin ID |
description | string | No | — | Workbin description. Maximum length of 512 characters. |
name | string | No | — | Workbin name. Valid length between 3 and 256 characters. |
genesys_tasks_quality_patch_workitem
Update the attributes of a workitem Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workitemId | string | Yes | — | Workitem ID |
assigneeId | string | No | — | The ID of the assignee of the Workitem. If supplied it must be a valid UUID. |
assignmentOperation | string | No | — | Set this value to AgentAssignmentAlerting and supply an ‘assigneeId’ to assign the workitem to an agent and alert the agent of the assignment. Set this value to QueueAssignmentAlerting and supply a ‘queueId’ to route the workitem to an agent who is a member of the queue and alert the agent. |
assignmentState | string | No | — | The assignment state of the Workitem. |
autoStatusTransition | boolean | No | — | Set it to false to disable auto status transition. By default, it is enabled. |
customFields | object | No | — | Custom fields defined in the schema referenced by the worktype of the workitem. If set to {}, the existing keys and values will be removed. |
dateClosed | string | No | — | The closed date of the Workitem. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
dateDue | string | No | — | The due date of the Workitem. Can not be greater than 365 days from the current time. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
dateExpires | string | No | — | The expiry date of the Workitem. Can not be greater than 365 days from the current time. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
description | string | No | — | The description of the Workitem. Maximum length of 512 characters. |
durationSeconds | integer | No | — | The estimated duration in seconds to complete the Workitem. Maximum of 365 days. |
externalContactId | string | No | — | The ID of the external contact of the Workitem. Must be a valid UUID. |
externalTag | string | No | — | The external tag of the Workitem. |
languageId | string | No | — | The ID of language of the Workitem. Must be a valid UUID. |
name | string | No | — | The name of the Workitem. Valid length between 3 and 256 characters. |
preferredAgentIds | any[] | No | — | The preferred agent IDs of the Workitem. Must be valid UUIDs. |
priority | integer | No | — | The priority of the Workitem. The valid range is between -25,000,000 and 25,000,000. |
queueId | string | No | — | The ID of the Workitems queue. Must be a valid UUID. |
scoredAgents | any[] | No | — | A list of scored agents for the Workitem. A workitem can have a maximum of 20 scored agents. |
scriptId | string | No | — | The ID of the Workitems script. Must be a valid UUID. |
skillIds | any[] | No | — | The skill IDs of the Workitem. Must be valid UUIDs. |
statusId | string | No | — | The ID of the Status of the Workitem. |
ttl | integer | No | — | The epoch timestamp in seconds specifying the time to live for the Workitem. Can not be greater than 365 days from the current time. |
utilizationLabelId | string | No | — | The ID of the utilization label of the Workitem. Must be a valid UUID. |
workbinId | string | No | — | The ID of Workbin that contains the Workitem. |
genesys_tasks_quality_patch_workitem_assignment
Attempts to manually assign a specified workitem to a specified user. Ignores bullseye ring, PAR score, skills, and languages. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workitemId | string | Yes | — | Workitem ID |
id | string | Yes | — | The globally unique identifier for this user. |
genesys_tasks_quality_patch_workitem_user_wrapups
Add/Remove a wrapup code for a given user in a workitem. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workitemId | string | Yes | — | The ID of the Workitem. |
userId | string | Yes | — | The ID of the user |
action | string | Yes | — | Action to be performed for the wrapup code. |
wrapupCode | string | Yes | — | The wrapup code which will be added/removed. |
genesys_tasks_quality_patch_workitem_users_me_wrapups
Add/Remove a wrapup code for the current user in a workitem. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workitemId | string | Yes | — | The ID of the Workitem. |
action | string | Yes | — | Action to be performed for the wrapup code. |
wrapupCode | string | Yes | — | The wrapup code which will be added/removed. |
genesys_tasks_quality_patch_worktype
Update the attributes of a worktype Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
worktypeId | string | Yes | — | Worktype id |
assignmentEnabled | boolean | No | — | When set to true, Workitems will be sent to the queue of the Worktype as they are created. Default value is false. |
defaultDueDurationSeconds | integer | No | — | The default due duration in seconds for Workitems created from the Worktype. Maximum of 365 days. |
defaultDurationSeconds | integer | No | — | The default duration in seconds for Workitems created from the Worktype. Maximum of 365 days. |
defaultExpirationSeconds | integer | No | — | The default expiration time in seconds for Workitems created from the Worktype. Maximum of 365 days. |
defaultLanguageId | string | No | — | The ID of the default language for Workitems created from the Worktype. Must be a valid UUID. |
defaultPriority | integer | No | — | The default priority for Workitems created from the Worktype. The valid range is between -25,000,000 and 25,000,000. |
defaultQueueId | string | No | — | The ID of the default queue for Workitems created from the Worktype. Must be a valid UUID. |
defaultScriptId | string | No | — | The default script for Workitems created from the Worktype. Must be a valid UUID. |
defaultSkillIds | any[] | No | — | The IDs of the default skills for Workitems created from the Worktype. Must be valid UUIDs. Maximum of 20 IDs |
defaultStatusId | string | No | — | The ID of the default status for Workitems created from the Worktype. Must be a valid UUID. |
defaultTtlSeconds | integer | No | — | The default time to time to live in seconds for Workitems created from the Worktype. The valid range is between 1 and 365 days. |
defaultWorkbinId | string | No | — | The ID of the default Workbin for Workitems created from the Worktype. |
description | string | No | — | The description of the Worktype. Maximum length of 512 characters. |
name | string | No | — | The name of the Worktype. Valid length between 3 and 256 characters. |
ruleSettings | object | No | — | ruleSettings |
schemaId | string | No | — | The ID of the custom attribute schema for Workitems created from the Worktype. Must be a valid UUID. |
schemaVersion | integer | No | — | The version of the Worktypes custom attribute schema. The latest schema version will be used if this property is not set. |
serviceLevelTarget | integer | No | — | The target service level for Workitems created from the Worktype. The default value is 100. |
unassignedDivisionContactsEnabled | boolean | No | — | When set to true, will allow Workitems to be associated with External Contacts that are not assigned to any division. Default value is true. |
genesys_tasks_quality_patch_worktype_status
Update the attributes of a status Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
worktypeId | string | Yes | — | Worktype id |
statusId | string | Yes | — | Status id |
autoTerminateWorkitem | boolean | No | — | Terminate workitem on selection of status. Applicable only for statuses in the Closed category. |
defaultDestinationStatusId | string | No | — | Default destination status to which this Status will transition to if auto status transition enabled. |
description | string | No | — | The description of the Status. Maximum length of 512 characters. |
destinationStatusIds | any[] | No | — | A list of destination Statuses where a Workitem with this Status can transition to. If the list is empty Workitems with this Status can transition to all other Statuses defined on the Worktype. A Status can have a maximum of 24 destinations. |
name | string | No | — | The name of the Status. Valid length between 3 and 256 characters. |
statusTransitionDelaySeconds | integer | No | — | Delay in seconds for auto status transition. Required if defaultDestinationStatusId is provided. |
statusTransitionTime | string | No | — | Time is represented as an ISO-8601 string without a timezone. For example: HH:mm:ss.SSS |
genesys_tasks_quality_post_conversation_evaluations
Create an evaluation Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | conversationId |
expand | string | No | — | evaluatorId |
agent | object | No | — | agent |
agentHasRead | boolean | No | — | agentHasRead |
answers | object | No | — | answers |
assignee | object | No | — | assignee |
calibration | object | No | — | calibration |
conversation | object | No | — | conversation |
dateAssigneeChanged | string | No | — | Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
evaluationContextId | string | No | — | evaluationContextId |
evaluationForm | object | No | — | evaluationForm |
evaluationSource | object | No | — | evaluationSource |
evaluator | object | No | — | evaluator |
id | string | No | — | The globally unique identifier for the object. |
neverRelease | boolean | No | — | neverRelease |
queue | object | No | — | queue |
releaseDate | string | No | — | Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
rescore | boolean | No | — | rescore |
resourceType | string | No | — | resourceType |
selfUri | string | No | — | The URI for this object |
status | string | No | — | status |
genesys_tasks_quality_post_conversations_audits_query
Create audit query execution Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
filters | any[] | Yes | — | List of filters for the query. |
interval | string | Yes | — | Date and time range of data to query. Intervals are represented as an ISO-8601 string. For example: YYYY-MM-DDThh:mm:ss/YYYY-MM-DDThh:mm:ss |
sort | any[] | No | — | Sort parameter for the query. |
genesys_tasks_quality_post_evaluations_aggregates_query_me
Query for evaluation aggregates for the current user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
alternateTimeDimension | string | No | — | Dimension to use as the alternative timestamp for data in the aggregate. Choosing “eventTime” uses the actual time of the data event. |
contextId | string | No | — | Evaluation context Id |
groupBy | any[] | No | — | Behaves like a SQL GROUPBY. Allows for multiple levels of grouping as a list of dimensions. Partitions resulting aggregate computations into distinct named subgroups rather than across the entire result set as if it were one group. |
interval | string | Yes | — | Behaves like one clause in a SQL WHERE. Specifies the date and time range of data being queried. Intervals are represented as an ISO-8601 string. For example: YYYY-MM-DDThh:mm:ss/YYYY-MM-DDThh:mm:ss |
metrics | any[] | Yes | — | Behaves like a SQL SELECT clause. Only named metrics will be retrieved. |
timeZone | string | No | — | Time zone context used to calculate response intervals (this allows resolving DST changes). The interval offset is used even when timeZone is specified. Default is UTC. Time zones are represented as a string of the zone name as found in the IANA time zone database. For example: UTC, Etc/UTC, or Europe/London |
genesys_tasks_quality_post_evaluations_scoring
Score evaluation Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
answers | object | No | — | answers |
evaluationForm | object | No | — | evaluationForm |
genesys_tasks_quality_post_evaluations_search
Search evaluations based along specified criteria Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
aggregations | any[] | No | — | Aggregations to compute on the search results |
pageNumber | integer | Yes | — | The page of resources you want to retrieve |
pageSize | integer | No | — | The number of results per page. For aggregation requests, must be omitted or 0. |
query | any[] | Yes | — | query |
sortBy | string | No | — | The field in the resource that you want to sort the results by. Include with sortOrder. |
sortOrder | string | No | — | The sort order for results. Include with sortBy. |
systemSubmitted | boolean | No | — | Filter for automated evaluations submitted by virtual supervisor. Defaults to false. |
genesys_tasks_quality_post_forms_evaluations
Create an evaluation form. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
aiScoring | object | No | — | aiScoring |
contextId | string | No | — | contextId |
dialect | string | No | — | The language dialect for this evaluation form. Supported dialects: ar, cs, da, de, en-US, es, fi, fr, fr-CA, he, hi, it, ja, ko, nl, no, pl, pt-BR, pt-PT, ru, sv, th, tr, uk, zh-CN, zh-TW |
evaluationSettings | object | No | — | evaluationSettings |
id | string | No | — | The globally unique identifier for the object. |
latestVersionFormName | string | No | — | The name of the form’s most recently published version |
modifiedDate | string | No | — | Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
name | string | Yes | — | The evaluation form name |
published | boolean | No | — | published |
publishedVersions | object | No | — | publishedVersions |
questionGroups | any[] | Yes | — | A list of question groups |
selfUri | string | No | — | The URI for this object |
genesys_tasks_quality_post_forms_surveys
Create a survey form. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
contextId | string | Yes | — | Unique Id for all versions of this form |
disabled | boolean | No | — | Is this form disabled |
footer | string | No | — | Markdown text for the bottom of the form. |
header | string | No | — | Markdown text for the top of the form. |
id | string | No | — | The globally unique identifier for the object. |
language | string | Yes | — | Language for survey viewer localization. Currently localized languages: da, de, en-US, es, fi, fr, it, ja, ko, nl, no, pl, pt-BR, sv, th, tr, zh-CH, zh-TW |
modifiedDate | string | No | — | Last modified date. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
name | string | Yes | — | The survey form name |
published | boolean | No | — | Is this form published |
publishedVersions | object | No | — | publishedVersions |
questionGroups | any[] | No | — | A list of question groups |
selfUri | string | No | — | The URI for this object |
genesys_tasks_quality_post_program_agentscoringrules
Create an Agent Scoring Rule Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
programId | string | Yes | — | Program ID from Speech and Text Analytics |
dateCreated | string | No | — | Date when the rule was created. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
dateModified | string | No | — | Date when the rule was last modified. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
enabled | boolean | Yes | — | Whether the rule is enabled. |
evaluationFormContextId | string | Yes | — | The evaluation form contextID to use for scoring. |
evaluator | object | No | — | evaluator |
id | string | No | — | The globally unique identifier for the object. |
published | boolean | No | — | Whether the rule is published. |
samplingPercentage | number | No | — | Percentage of interactions to evaluate (0.01-100.00). Required when samplingType is Percentage, null when All. |
samplingType | string | Yes | — | Sampling type setting. Valid values: All, Percentage |
selfUri | string | No | — | The URI for this object |
submissionType | string | Yes | — | Submission type for evaluations. Valid values: Automated, Manual |
genesys_tasks_quality_post_quality_evaluations_search
Search evaluations based along specified criteria Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
aggregations | any[] | No | — | Aggregations to compute on the search results |
pageNumber | integer | Yes | — | The page of resources you want to retrieve |
pageSize | integer | No | — | The number of results per page. For aggregation requests, must be omitted or 0. |
query | any[] | Yes | — | query |
sortBy | string | No | — | The field in the resource that you want to sort the results by. Include with sortOrder. |
sortOrder | string | No | — | The sort order for results. Include with sortBy. |
systemSubmitted | boolean | No | — | Filter for automated evaluations submitted by virtual supervisor. Defaults to false. |
genesys_tasks_quality_post_surveys
Create a survey for a conversation Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
agentId | string | No | — | The agent to associate with the survey. If not specified, the last agent on the conversation will be selected. |
conversationId | string | Yes | — | The conversation to create the survey for. |
queueId | string | No | — | The queue to associate with the survey. If not specified, the queue associated with the selected agent will be used. |
surveyFormContextId | string | Yes | — | The survey form context to use for the survey. |
genesys_tasks_quality_post_surveys_scoring
Score survey Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
answers | object | No | — | answers |
surveyForm | object | No | — | surveyForm |
genesys_tasks_quality_post_taskmanagement_workbins_query
Query for workbins Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
after | string | No | — | The cursor that points to the end of the set of entities that has been returned. |
attributes | any[] | No | — | List of entity attributes to be retrieved in the result. |
filters | any[] | Yes | — | List of filter objects to be used in the search. Valid filter names are: ‘id’, ‘name’, ‘description’, ‘divisionId’, ‘dateCreated’, ‘dateModified’, ‘modifiedBy’ |
pageSize | integer | No | — | Limit the number of entities to return. It is not guaranteed that the requested number of entities will be filled in a single request. If an after key is returned as part of the response it is possible that more entities that match the filter criteria exist. Maximum of 200. |
select | string | No | — | Specify the value ‘Count’ for this parameter in order to return only the record count. |
sort | object | No | — | sort |
genesys_tasks_quality_post_taskmanagement_workitem_terminate
Terminate a workitem Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workitemId | string | Yes | — | Workitem ID |
statusId | string | No | — | The ID of the status the workitem should be updated to when terminating. The status must be a ‘Closed’ category status. |
genesys_tasks_quality_post_taskmanagement_workitems
Create a workitem Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
assigneeId | string | No | — | The ID of the assignee of the Workitem. Must be a valid UUID. |
autoStatusTransition | boolean | No | — | Set it to false to disable auto status transition. By default, it is enabled. |
customFields | object | No | — | Custom fields defined in the schema referenced by the worktype of the workitem. |
dateDue | string | No | — | The due date of the Workitem. Can not be greater than 365 days from the current time. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
dateExpires | string | No | — | The expiry date of the Workitem. Can not be greater than 365 days from the current time. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
description | string | No | — | The description of the Workitem. Maximum length of 512 characters. |
durationSeconds | integer | No | — | The estimated duration in seconds to complete the Workitem. Maximum of 365 days. |
externalContactId | string | No | — | The ID of the external contact of the Workitem. Must be a valid UUID. |
externalTag | string | No | — | The external tag of the Workitem. |
languageId | string | No | — | The ID of language of the Workitem. Must be a valid UUID. |
name | string | Yes | — | The name of the Workitem. Valid length between 3 and 256 characters. |
preferredAgentIds | any[] | No | — | The preferred agent IDs of the Workitem. Must be valid UUIDs. |
priority | integer | No | — | The priority of the Workitem. The valid range is between -25,000,000 and 25,000,000. |
queueId | string | No | — | The ID of the Workitems queue. Must be a valid UUID. |
scoredAgents | any[] | No | — | A list of scored agents for the Workitem. A workitem can have a maximum of 20 scored agents. |
scriptId | string | No | — | The ID of the Workitems script. Must be a valid UUID. |
skillIds | any[] | No | — | The skill IDs of the Workitem. Must be valid UUIDs. |
statusId | string | No | — | The ID of the Status of the Workitem. |
ttl | integer | No | — | The epoch timestamp in seconds specifying the time to live for the Workitem. Can not be greater than 365 days from the current time. |
typeId | string | Yes | — | The ID of the Worktype of the Workitem. |
utilizationLabelId | string | No | — | The ID of utilization label of the Workitem. Must be a valid UUID. |
workbinId | string | No | — | The ID of Workbin that contains the Workitem. |
wrapupCode | string | No | — | The ID of the wrapup. Must be a valid UUID. |
genesys_tasks_quality_post_taskmanagement_workitems_query
Query for workitems Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
after | string | No | — | The cursor that points to the end of the set of entities that has been returned. |
attributes | any[] | No | — | List of entity attributes to be retrieved in the result. |
expands | any[] | No | — | List of entity attributes to be expanded in the result. |
filters | any[] | Yes | — | List of filter objects to be used in the search. Valid filter names are: ‘id’, ‘name’, ‘description’, ‘languageId’, ‘priority’, ‘dateCreated’, ‘dateModified’, ‘dateDue’, ‘dateExpires’, ‘durationInSeconds’, ‘ttl’, ‘statusId’, ‘statusCategory’, ‘dateClosed’, ‘externalContactId’, ‘reporterId’, ‘queueId’, ‘externalTag’, ‘modifiedBy’, ‘assignmentState’, ‘divisionId’, ‘customFields.<custom field name>‘ |
pageSize | integer | No | — | Limit the number of entities to return. It is not guaranteed that the requested number of entities will be filled in a single request. If an after key is returned as part of the response it is possible that more entities that match the filter criteria exist. Maximum of 200. |
select | string | No | — | Specify the value ‘Count’ for this parameter in order to return only the record count. |
sort | object | No | — | sort |
genesys_tasks_quality_post_taskmanagement_worktypes_query
Query for worktypes Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
after | string | No | — | The cursor that points to the end of the set of entities that has been returned. |
attributes | any[] | No | — | List of entity attributes to be retrieved in the result. |
filters | any[] | Yes | — | List of filter objects to be used in the search. Valid filter names are: ‘divisionId’, ‘id’, ‘name’, ‘description’, ‘defaultWorkbinId’, ‘defaultDurationSeconds’, ‘defaultExpirationSeconds’, ‘defaultDueDurationSeconds’, ‘defaultPriority’, ‘defaultLanguageId’, ‘defaultTtlSeconds’, ‘assignmentEnabled’, ‘defaultQueueId’, ‘schemaId’, ‘schemaVersion’, ‘dateCreated’, ‘dateModified’, ‘modifiedBy’ |
pageSize | integer | No | — | Limit the number of entities to return. It is not guaranteed that the requested number of entities will be filled in a single request. If an after key is returned as part of the response it is possible that more entities that match the filter criteria exist. Maximum of 200. |
select | string | No | — | Specify the value ‘Count’ for this parameter in order to return only the record count. |
sort | object | No | — | sort |
genesys_tasks_quality_post_workbins
Create a workbin Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
description | string | No | — | Workbin description. Maximum length of 512 characters. |
divisionId | string | No | — | The ID of the division the Workbin belongs to. Defaults to home division ID. |
name | string | Yes | — | Workbin name. Valid length between 3 and 256 characters. |
genesys_tasks_quality_post_workbins_query
Query for workbins Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
after | string | No | — | The cursor that points to the end of the set of entities that has been returned. |
attributes | any[] | No | — | List of entity attributes to be retrieved in the result. |
filters | any[] | Yes | — | List of filter objects to be used in the search. Valid filter names are: ‘id’, ‘name’, ‘description’, ‘divisionId’, ‘dateCreated’, ‘dateModified’, ‘modifiedBy’ |
pageSize | integer | No | — | Limit the number of entities to return. It is not guaranteed that the requested number of entities will be filled in a single request. If an after key is returned as part of the response it is possible that more entities that match the filter criteria exist. Maximum of 200. |
select | string | No | — | Specify the value ‘Count’ for this parameter in order to return only the record count. |
sort | object | No | — | sort |
genesys_tasks_quality_post_workitem_acd_cancel
Cancel the assignment process for a workitem that is currently queued for assignment through ACD. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workitemId | string | Yes | — | Workitem ID |
genesys_tasks_quality_post_workitem_disconnect
Disconnect the assignee of the workitem Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workitemId | string | Yes | — | Workitem ID |
genesys_tasks_quality_post_workitem_terminate
Terminate a workitem Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workitemId | string | Yes | — | Workitem ID |
statusId | string | No | — | The ID of the status the workitem should be updated to when terminating. The status must be a ‘Closed’ category status. |
genesys_tasks_quality_post_workitems
Create a workitem Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
assigneeId | string | No | — | The ID of the assignee of the Workitem. Must be a valid UUID. |
autoStatusTransition | boolean | No | — | Set it to false to disable auto status transition. By default, it is enabled. |
customFields | object | No | — | Custom fields defined in the schema referenced by the worktype of the workitem. |
dateDue | string | No | — | The due date of the Workitem. Can not be greater than 365 days from the current time. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
dateExpires | string | No | — | The expiry date of the Workitem. Can not be greater than 365 days from the current time. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
description | string | No | — | The description of the Workitem. Maximum length of 512 characters. |
durationSeconds | integer | No | — | The estimated duration in seconds to complete the Workitem. Maximum of 365 days. |
externalContactId | string | No | — | The ID of the external contact of the Workitem. Must be a valid UUID. |
externalTag | string | No | — | The external tag of the Workitem. |
languageId | string | No | — | The ID of language of the Workitem. Must be a valid UUID. |
name | string | Yes | — | The name of the Workitem. Valid length between 3 and 256 characters. |
preferredAgentIds | any[] | No | — | The preferred agent IDs of the Workitem. Must be valid UUIDs. |
priority | integer | No | — | The priority of the Workitem. The valid range is between -25,000,000 and 25,000,000. |
queueId | string | No | — | The ID of the Workitems queue. Must be a valid UUID. |
scoredAgents | any[] | No | — | A list of scored agents for the Workitem. A workitem can have a maximum of 20 scored agents. |
scriptId | string | No | — | The ID of the Workitems script. Must be a valid UUID. |
skillIds | any[] | No | — | The skill IDs of the Workitem. Must be valid UUIDs. |
statusId | string | No | — | The ID of the Status of the Workitem. |
ttl | integer | No | — | The epoch timestamp in seconds specifying the time to live for the Workitem. Can not be greater than 365 days from the current time. |
typeId | string | Yes | — | The ID of the Worktype of the Workitem. |
utilizationLabelId | string | No | — | The ID of utilization label of the Workitem. Must be a valid UUID. |
workbinId | string | No | — | The ID of Workbin that contains the Workitem. |
wrapupCode | string | No | — | The ID of the wrapup. Must be a valid UUID. |
genesys_tasks_quality_post_workitems_query
Query for workitems Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
after | string | No | — | The cursor that points to the end of the set of entities that has been returned. |
attributes | any[] | No | — | List of entity attributes to be retrieved in the result. |
expands | any[] | No | — | List of entity attributes to be expanded in the result. |
filters | any[] | Yes | — | List of filter objects to be used in the search. Valid filter names are: ‘id’, ‘name’, ‘description’, ‘languageId’, ‘priority’, ‘dateCreated’, ‘dateModified’, ‘dateDue’, ‘dateExpires’, ‘durationInSeconds’, ‘ttl’, ‘statusId’, ‘statusCategory’, ‘dateClosed’, ‘externalContactId’, ‘reporterId’, ‘queueId’, ‘externalTag’, ‘modifiedBy’, ‘assignmentState’, ‘divisionId’, ‘customFields.<custom field name>‘ |
pageSize | integer | No | — | Limit the number of entities to return. It is not guaranteed that the requested number of entities will be filled in a single request. If an after key is returned as part of the response it is possible that more entities that match the filter criteria exist. Maximum of 200. |
select | string | No | — | Specify the value ‘Count’ for this parameter in order to return only the record count. |
sort | object | No | — | sort |
genesys_tasks_quality_post_worktype_statuses
Add a status to a worktype Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
worktypeId | string | Yes | — | Worktype id |
autoTerminateWorkitem | boolean | No | — | Terminate workitem on selection of status. Applicable only for statuses in the Closed category. |
category | string | Yes | — | The Category of the Status. |
defaultDestinationStatusId | string | No | — | Default destination status to which this Status will transition to if auto status transition enabled. |
description | string | No | — | The description of the Status. Maximum length of 512 characters. |
destinationStatusIds | any[] | No | — | A list of destination Statuses where a Workitem with this Status can transition to. If the list is empty Workitems with this Status can transition to all other Statuses defined on the Worktype. A Status can have a maximum of 24 destinations. |
name | string | Yes | — | The name of the Status. Valid length between 3 and 256 characters. |
statusTransitionDelaySeconds | integer | No | — | Delay in seconds for auto status transition. Required if defaultDestinationStatusId is provided. |
statusTransitionTime | string | No | — | Time is represented as an ISO-8601 string without a timezone. For example: HH:mm:ss.SSS |
genesys_tasks_quality_post_worktypes
Create a worktype Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
assignmentEnabled | boolean | No | — | When set to true, Workitems will be sent to the queue of the Worktype as they are created. Default value is false. |
defaultDueDurationSeconds | integer | No | — | The default due duration in seconds for Workitems created from the Worktype. Maximum of 365 days. |
defaultDurationSeconds | integer | No | — | The default duration in seconds for Workitems created from the Worktype. Maximum of 365 days. |
defaultExpirationSeconds | integer | No | — | The default expiration time in seconds for Workitems created from the Worktype. Maximum of 365 days. |
defaultLanguageId | string | No | — | The ID of the default language for Workitems created from the Worktype. Must be a valid UUID. |
defaultPriority | integer | No | — | The default priority for Workitems created from the Worktype. The valid range is between -25,000,000 and 25,000,000. |
defaultQueueId | string | No | — | The ID of the default queue for Workitems created from the Worktype. Must be a valid UUID. |
defaultScriptId | string | No | — | The default script for Workitems created from the Worktype. Must be a valid UUID. |
defaultSkillIds | any[] | No | — | The IDs of the default skills for Workitems created from the Worktype. Must be valid UUIDs. Maximum of 20 IDs |
defaultTtlSeconds | integer | No | — | The default time to time to live in seconds for Workitems created from the Worktype. The valid range is between 1 and 365 days. |
defaultWorkbinId | string | Yes | — | The ID of the default Workbin for Workitems created from the Worktype. |
description | string | No | — | The description of the Worktype. Maximum length of 512 characters. |
disableDefaultStatusCreation | boolean | No | — | Set to true to disable default status creation. Default statuses are created with the Worktype by default |
divisionId | string | No | — | The ID of the division the Worktype belongs to. Defaults to the default Workbin division ID. The Worktype must be in the same division as its default Workbin. |
name | string | Yes | — | The name of the Worktype. Valid length between 3 and 256 characters. |
ruleSettings | object | No | — | ruleSettings |
schemaId | string | No | — | The ID of the custom attribute schema for Workitems created from the Worktype. Must be a valid UUID. |
schemaVersion | integer | No | — | The version of the Worktypes custom attribute schema. The latest schema version will be used if this property is not set. |
serviceLevelTarget | integer | No | — | The target service level for Workitems created from the Worktype. The default value is 100. |
unassignedDivisionContactsEnabled | boolean | No | — | When set to true, will allow Workitems to be associated with External Contacts that are not assigned to any division. Default value is true. |
genesys_tasks_quality_post_worktypes_query
Query for worktypes Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
after | string | No | — | The cursor that points to the end of the set of entities that has been returned. |
attributes | any[] | No | — | List of entity attributes to be retrieved in the result. |
filters | any[] | Yes | — | List of filter objects to be used in the search. Valid filter names are: ‘divisionId’, ‘id’, ‘name’, ‘description’, ‘defaultWorkbinId’, ‘defaultDurationSeconds’, ‘defaultExpirationSeconds’, ‘defaultDueDurationSeconds’, ‘defaultPriority’, ‘defaultLanguageId’, ‘defaultTtlSeconds’, ‘assignmentEnabled’, ‘defaultQueueId’, ‘schemaId’, ‘schemaVersion’, ‘dateCreated’, ‘dateModified’, ‘modifiedBy’ |
pageSize | integer | No | — | Limit the number of entities to return. It is not guaranteed that the requested number of entities will be filled in a single request. If an after key is returned as part of the response it is possible that more entities that match the filter criteria exist. Maximum of 200. |
select | string | No | — | Specify the value ‘Count’ for this parameter in order to return only the record count. |
sort | object | No | — | sort |
genesys_tasks_quality_put_conversation_evaluation
Update an evaluation Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | conversationId |
evaluationId | string | Yes | — | evaluationId |
expand | string | No | — | evaluatorId, evaluationForm, assignee, evaluator |
agent | object | No | — | agent |
agentHasRead | boolean | No | — | agentHasRead |
agentTeam | object | No | — | agentTeam |
aiScoring | object | No | — | aiScoring |
answers | object | No | — | answers |
assigned | boolean | No | — | Set to false to unassign the evaluation. This cannot be set to false when assignee is also set. |
assignedDate | string | No | — | Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
assignee | object | No | — | assignee |
assigneeApplicable | boolean | No | — | Indicates whether an assignee is applicable for the evaluation. Set to false when assignee is not applicable. |
authorizedActions | any[] | No | — | List of user authorized actions on evaluation. Possible values: assign, edit, editScore, editAgentSignoff, delete, release, viewAudit |
calibration | object | No | — | calibration |
changedDate | string | No | — | Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
conversation | object | No | — | conversation |
conversationDate | string | No | — | Creation date of the conversation. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
conversationEndDate | string | No | — | End date of conversation if it had completed before evaluation creation. Null if created before the conversation ended. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
createdDate | string | No | — | Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
dateAssigneeChanged | string | No | — | Date when the assignee was last changed. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
divisionIds | any[] | No | — | Evaluation is assigned in the following division(s). |
evaluationForm | object | No | — | evaluationForm |
evaluationSource | object | No | — | evaluationSource |
evaluator | object | No | — | evaluator |
hasAssistanceFailed | boolean | No | — | Is true when evaluation assistance didn’t execute successfully |
id | string | No | — | The globally unique identifier for the object. |
isScoringIndex | boolean | No | — | isScoringIndex |
mediaType | any[] | No | — | List of different communication types used in conversation. |
name | string | No | — | name |
neverRelease | boolean | No | — | Signifies if the evaluation is never to be released. This cannot be set true if release date is also set. |
queue | object | No | — | queue |
redacted | boolean | No | — | Is only true when the user making the request does not have sufficient permissions to see evaluation |
releaseDate | string | No | — | Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
rescore | boolean | No | — | Is only true when evaluation is re-scored. |
resourceId | string | No | — | Only used for email evaluations. Will be null for all other evaluations. |
resourceType | string | No | — | The type of resource. Only used for email evaluations. Will be null for evaluations on all other resources. |
revisionCreatedDate | string | No | — | Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
selfUri | string | No | — | The URI for this object |
status | string | No | — | status |
submittedDate | string | No | — | Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
genesys_tasks_quality_put_forms_evaluation
Update an evaluation form. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
formId | string | Yes | — | Form ID |
aiScoring | object | No | — | aiScoring |
contextId | string | No | — | contextId |
dialect | string | No | — | The language dialect for this evaluation form. Supported dialects: ar, cs, da, de, en-US, es, fi, fr, fr-CA, he, hi, it, ja, ko, nl, no, pl, pt-BR, pt-PT, ru, sv, th, tr, uk, zh-CN, zh-TW |
evaluationSettings | object | No | — | evaluationSettings |
id | string | No | — | The globally unique identifier for the object. |
latestVersionFormName | string | No | — | The name of the form’s most recently published version |
modifiedDate | string | No | — | Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
name | string | Yes | — | The evaluation form name |
published | boolean | No | — | published |
publishedVersions | object | No | — | publishedVersions |
questionGroups | any[] | Yes | — | A list of question groups |
selfUri | string | No | — | The URI for this object |
genesys_tasks_quality_put_forms_survey
Update a survey form. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
formId | string | Yes | — | Form ID |
contextId | string | Yes | — | Unique Id for all versions of this form |
disabled | boolean | No | — | Is this form disabled |
footer | string | No | — | Markdown text for the bottom of the form. |
header | string | No | — | Markdown text for the top of the form. |
id | string | No | — | The globally unique identifier for the object. |
language | string | Yes | — | Language for survey viewer localization. Currently localized languages: da, de, en-US, es, fi, fr, it, ja, ko, nl, no, pl, pt-BR, sv, th, tr, zh-CH, zh-TW |
modifiedDate | string | No | — | Last modified date. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
name | string | Yes | — | The survey form name |
published | boolean | No | — | Is this form published |
publishedVersions | object | No | — | publishedVersions |
questionGroups | any[] | No | — | A list of question groups |
selfUri | string | No | — | The URI for this object |
genesys_tasks_quality_put_program_agentscoringrule
Update an Agent Scoring Rule Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
programId | string | Yes | — | Program ID from Speech and Text Analytics |
ruleId | string | Yes | — | Agent Scoring Rule ID |
dateCreated | string | No | — | Date when the rule was created. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
dateModified | string | No | — | Date when the rule was last modified. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
enabled | boolean | Yes | — | Whether the rule is enabled. |
evaluationFormContextId | string | Yes | — | The evaluation form contextID to use for scoring. |
evaluator | object | No | — | evaluator |
id | string | No | — | The globally unique identifier for the object. |
published | boolean | No | — | Whether the rule is published. |
samplingPercentage | number | No | — | Percentage of interactions to evaluate (0.01-100.00). Required when samplingType is Percentage, null when All. |
samplingType | string | Yes | — | Sampling type setting. Valid values: All, Percentage |
selfUri | string | No | — | The URI for this object |
submissionType | string | Yes | — | Submission type for evaluations. Valid values: Automated, Manual |
genesys_tasks_quality_put_surveys_scorable
Update a survey as an end-customer, for the purposes of scoring it. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
customerSurveyUrl | string | Yes | — | customerSurveyUrl |
answers | object | No | — | answers |
id | string | No | — | The globally unique identifier for the object. |
name | string | No | — | name |
selfUri | string | No | — | The URI for this object |
status | string | No | — | status |
surveyForm | object | No | — | surveyForm |

