Skip to main content
Server path: /genesys-tasks-quality | Type: Application | PCID required: Yes

Tools

ToolDescription
genesys_tasks_quality_delete_conversation_evaluationDelete an evaluation
genesys_tasks_quality_delete_forms_evaluationDelete an evaluation form.
genesys_tasks_quality_delete_forms_surveyDelete a survey form.
genesys_tasks_quality_delete_program_agentscoringruleDelete an Agent Scoring Rule
genesys_tasks_quality_delete_taskmanagement_workitemDelete a workitem
genesys_tasks_quality_delete_workbinDelete a workbin
genesys_tasks_quality_delete_workitemDelete a workitem
genesys_tasks_quality_delete_worktypeDelete a worktype
genesys_tasks_quality_delete_worktype_statusDelete a status
genesys_tasks_quality_get_agents_activityGets a list of Agent Activities
genesys_tasks_quality_get_conversation_evaluationGet an evaluation
genesys_tasks_quality_get_conversation_surveysGet the surveys for a conversation
genesys_tasks_quality_get_conversations_audits_query_transaction_idGet status of audit query execution
genesys_tasks_quality_get_conversations_audits_query_transaction_id_resultsGet results of audit query
genesys_tasks_quality_get_evaluations_queryQueries Evaluations and returns a paged list
genesys_tasks_quality_get_evaluators_activityGet an evaluator activity. To ensure optimal performance and prevent timeouts when processing large datasets, startTime and endTime fields are highly recommended for all requests.
genesys_tasks_quality_get_forms_evaluationGet an evaluation form
genesys_tasks_quality_get_forms_evaluation_versionsGets all the revisions for a specific evaluation.
genesys_tasks_quality_get_forms_evaluationsGet the list of evaluation forms
genesys_tasks_quality_get_forms_surveyGet a survey form
genesys_tasks_quality_get_forms_surveysGet the list of survey forms. If you set “expand=publishHistory”, then you will be able to get published versions for each corresponding survey form.
genesys_tasks_quality_get_program_agentscoringruleGet an Agent Scoring Rule
genesys_tasks_quality_get_program_agentscoringrulesGet Agent Scoring Rules for a program
genesys_tasks_quality_get_quality_conversation_evaluationGet an evaluation
genesys_tasks_quality_get_quality_evaluations_queryQueries Evaluations and returns a paged list
genesys_tasks_quality_get_surveyGet a survey for a conversation
genesys_tasks_quality_get_surveys_scorableGet a survey as an end-customer, for the purposes of scoring it.
genesys_tasks_quality_get_taskmanagement_workbinGet a workbin
genesys_tasks_quality_get_taskmanagement_workitemGet a workitem
genesys_tasks_quality_get_taskmanagement_worktypeGet a worktype
genesys_tasks_quality_get_taskmanagement_worktype_statusesGet list of statuses for this worktype.
genesys_tasks_quality_get_workbinGet a workbin
genesys_tasks_quality_get_workbin_historyGet a listing of a workbin’s attribute change history
genesys_tasks_quality_get_workbin_versionGet a version of a workbin
genesys_tasks_quality_get_workbin_versionsGet all versions of a workbin
genesys_tasks_quality_get_workitemGet a workitem
genesys_tasks_quality_get_workitem_historyGet a listing of a workitem’s attribute change history
genesys_tasks_quality_get_workitem_user_wrapupsGet all wrapup codes added for the given user for a workitem.
genesys_tasks_quality_get_workitem_versionGet a version of a workitem
genesys_tasks_quality_get_workitem_versionsGet all versions of a workitem
genesys_tasks_quality_get_workitem_wrapupsGet all wrapup codes added for all users for a workitem.
genesys_tasks_quality_get_worktypeGet a worktype
genesys_tasks_quality_get_worktype_historyGet a listing of a worktype’s attribute change history
genesys_tasks_quality_get_worktype_statusGet a status
genesys_tasks_quality_get_worktype_statusesGet list of statuses for this worktype.
genesys_tasks_quality_get_worktype_versionGet a version of a worktype
genesys_tasks_quality_get_worktype_versionsGet all versions of a worktype
genesys_tasks_quality_patch_forms_surveyDisable a particular version of a survey form and invalidates any invitations that have already been sent to customers using this version of the form.
genesys_tasks_quality_patch_taskmanagement_workitemUpdate the attributes of a workitem
genesys_tasks_quality_patch_taskmanagement_workitem_assignmentAttempts to manually assign a specified workitem to a specified user. Ignores bullseye ring, PAR score, skills, and languages.
genesys_tasks_quality_patch_workbinUpdate the attributes of a workbin
genesys_tasks_quality_patch_workitemUpdate the attributes of a workitem
genesys_tasks_quality_patch_workitem_assignmentAttempts to manually assign a specified workitem to a specified user. Ignores bullseye ring, PAR score, skills, and languages.
genesys_tasks_quality_patch_workitem_user_wrapupsAdd/Remove a wrapup code for a given user in a workitem.
genesys_tasks_quality_patch_workitem_users_me_wrapupsAdd/Remove a wrapup code for the current user in a workitem.
genesys_tasks_quality_patch_worktypeUpdate the attributes of a worktype
genesys_tasks_quality_patch_worktype_statusUpdate the attributes of a status
genesys_tasks_quality_post_conversation_evaluationsCreate an evaluation
genesys_tasks_quality_post_conversations_audits_queryCreate audit query execution
genesys_tasks_quality_post_evaluations_aggregates_query_meQuery for evaluation aggregates for the current user
genesys_tasks_quality_post_evaluations_scoringScore evaluation
genesys_tasks_quality_post_evaluations_searchSearch evaluations based along specified criteria
genesys_tasks_quality_post_forms_evaluationsCreate an evaluation form.
genesys_tasks_quality_post_forms_surveysCreate a survey form.
genesys_tasks_quality_post_program_agentscoringrulesCreate an Agent Scoring Rule
genesys_tasks_quality_post_quality_evaluations_searchSearch evaluations based along specified criteria
genesys_tasks_quality_post_surveysCreate a survey for a conversation
genesys_tasks_quality_post_surveys_scoringScore survey
genesys_tasks_quality_post_taskmanagement_workbins_queryQuery for workbins
genesys_tasks_quality_post_taskmanagement_workitem_terminateTerminate a workitem
genesys_tasks_quality_post_taskmanagement_workitemsCreate a workitem
genesys_tasks_quality_post_taskmanagement_workitems_queryQuery for workitems
genesys_tasks_quality_post_taskmanagement_worktypes_queryQuery for worktypes
genesys_tasks_quality_post_workbinsCreate a workbin
genesys_tasks_quality_post_workbins_queryQuery for workbins
genesys_tasks_quality_post_workitem_acd_cancelCancel the assignment process for a workitem that is currently queued for assignment through ACD.
genesys_tasks_quality_post_workitem_disconnectDisconnect the assignee of the workitem
genesys_tasks_quality_post_workitem_terminateTerminate a workitem
genesys_tasks_quality_post_workitemsCreate a workitem
genesys_tasks_quality_post_workitems_queryQuery for workitems
genesys_tasks_quality_post_worktype_statusesAdd a status to a worktype
genesys_tasks_quality_post_worktypesCreate a worktype
genesys_tasks_quality_post_worktypes_queryQuery for worktypes
genesys_tasks_quality_put_conversation_evaluationUpdate an evaluation
genesys_tasks_quality_put_forms_evaluationUpdate an evaluation form.
genesys_tasks_quality_put_forms_surveyUpdate a survey form.
genesys_tasks_quality_put_program_agentscoringruleUpdate an Agent Scoring Rule
genesys_tasks_quality_put_surveys_scorableUpdate a survey as an end-customer, for the purposes of scoring it.

genesys_tasks_quality_delete_conversation_evaluation

Delete an evaluation Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId
evaluationIdstringYesevaluationId
expandstringNoevaluatorId, evaluationForm

genesys_tasks_quality_delete_forms_evaluation

Delete an evaluation form. Parameters:
ParameterTypeRequiredDefaultDescription
formIdstringYesForm ID

genesys_tasks_quality_delete_forms_survey

Delete a survey form. Parameters:
ParameterTypeRequiredDefaultDescription
formIdstringYesForm ID

genesys_tasks_quality_delete_program_agentscoringrule

Delete an Agent Scoring Rule Parameters:
ParameterTypeRequiredDefaultDescription
programIdstringYesProgram ID from Speech and Text Analytics
ruleIdstringYesAgent Scoring Rule ID

genesys_tasks_quality_delete_taskmanagement_workitem

Delete a workitem Parameters:
ParameterTypeRequiredDefaultDescription
workitemIdstringYesWorkitem ID

genesys_tasks_quality_delete_workbin

Delete a workbin Parameters:
ParameterTypeRequiredDefaultDescription
workbinIdstringYesWorkbin ID

genesys_tasks_quality_delete_workitem

Delete a workitem Parameters:
ParameterTypeRequiredDefaultDescription
workitemIdstringYesWorkitem ID

genesys_tasks_quality_delete_worktype

Delete a worktype Parameters:
ParameterTypeRequiredDefaultDescription
worktypeIdstringYesWorktype id

genesys_tasks_quality_delete_worktype_status

Delete a status Parameters:
ParameterTypeRequiredDefaultDescription
worktypeIdstringYesWorktype id
statusIdstringYesStatus id

genesys_tasks_quality_get_agents_activity

Gets a list of Agent Activities Parameters:
ParameterTypeRequiredDefaultDescription
pageSizeintegerNoThe total page size requested
pageNumberintegerNoThe page number requested
sortBystringNovariable name requested to sort by
expandany[]Novariable name requested by expand list
nextPagestringNonext page token
previousPagestringNoPrevious page token
startTimestringNoStart 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
endTimestringNoEnd 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
agentUserIdany[]Nouser id of agent requested
evaluatorUserIdstringNouser id of the evaluator
namestringNoname
groupstringNogroup id
agentTeamIdstringNoteam id of agents requested
formContextIdstringNoshared id between form versions
userStatestringNo‘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:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId
evaluationIdstringYesevaluationId
expandstringNoagent, assignee, evaluator, evaluationForm

genesys_tasks_quality_get_conversation_surveys

Get the surveys for a conversation Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId

genesys_tasks_quality_get_conversations_audits_query_transaction_id

Get status of audit query execution Parameters:
ParameterTypeRequiredDefaultDescription
transactionIdstringYesTransaction ID

genesys_tasks_quality_get_conversations_audits_query_transaction_id_results

Get results of audit query Parameters:
ParameterTypeRequiredDefaultDescription
transactionIdstringYesTransaction ID
cursorstringNoIndicates where to resume query results (not required for first page)
pageSizeintegerNoPage size
expandany[]NoWhich fields, if any, to expand

genesys_tasks_quality_get_evaluations_query

Queries Evaluations and returns a paged list Parameters:
ParameterTypeRequiredDefaultDescription
pageSizeintegerNoThe total page size requested
pageNumberintegerNoThe page number requested
expandany[]Novariable name requested by expand list
previousPagestringNoPrevious page token
conversationIdstringNoconversationId specified
agentUserIdstringNouser id of the agent
agentTeamIdstringNoteam id of the agent
evaluatorUserIdstringNoevaluator user id
assigneeUserIdstringNoassignee user id
queueIdstringNoqueue id
startTimestringNostart time of the evaluation query
endTimestringNoend time of the evaluation query
formContextIdstringNoshared id between form versions
evaluationStateany[]NoevaluationState
isReleasedbooleanNothe evaluation has been released
agentHasReadbooleanNoagent has the evaluation
expandAnswerTotalScoresbooleanNoget the total scores for evaluations. NOTE: The answers will only be populated if this parameter is set to true in the request.
maximumintegerNothe maximum number of results to return
sortOrderstringNoNOTE: Does not work when conversationId is supplied.
includeDeletedUsersbooleanNoAllow 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:
ParameterTypeRequiredDefaultDescription
pageSizeintegerNoThe total page size requested
pageNumberintegerNoThe page number requested
sortBystringNovariable name requested to sort by
expandany[]Novariable name requested by expand list
nextPagestringNonext page token
previousPagestringNoPrevious page token
startTimestringNoThe start time specified. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
endTimestringNoThe end time specified. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
namestringNoEvaluator name
permissionany[]Nopermission strings
groupstringNogroup id
agentTeamIdstringNoteam id of agents to be considered

genesys_tasks_quality_get_forms_evaluation

Get an evaluation form Parameters:
ParameterTypeRequiredDefaultDescription
formIdstringYesForm ID

genesys_tasks_quality_get_forms_evaluation_versions

Gets all the revisions for a specific evaluation. Parameters:
ParameterTypeRequiredDefaultDescription
formIdstringYesForm ID
pageSizeintegerNoPage size
pageNumberintegerNoPage number
sortOrderstringNoSort order

genesys_tasks_quality_get_forms_evaluations

Get the list of evaluation forms Parameters:
ParameterTypeRequiredDefaultDescription
pageSizeintegerNoThe total page size requested
pageNumberintegerNoThe page number requested
sortBystringNovariable name requested to sort by
nextPagestringNonext page token
previousPagestringNoPrevious page token
expandstringNoIf ‘expand=publishHistory’, then each unpublished evaluation form includes a listing of its published versions
namestringNoName
sortOrderstringNoOrder to sort results, either asc or desc

genesys_tasks_quality_get_forms_survey

Get a survey form Parameters:
ParameterTypeRequiredDefaultDescription
formIdstringYesForm 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:
ParameterTypeRequiredDefaultDescription
pageSizeintegerNoThe total page size requested
pageNumberintegerNoThe page number requested
sortBystringNovariable name requested to sort by
nextPagestringNonext page token
previousPagestringNoPrevious page token
expandstringNoIf ‘expand=publishHistory’, then each unpublished evaluation form includes a listing of its published versions
namestringNoName
sortOrderstringNoOrder to sort results, either asc or desc

genesys_tasks_quality_get_program_agentscoringrule

Get an Agent Scoring Rule Parameters:
ParameterTypeRequiredDefaultDescription
programIdstringYesProgram ID from Speech and Text Analytics
ruleIdstringYesAgent Scoring Rule ID

genesys_tasks_quality_get_program_agentscoringrules

Get Agent Scoring Rules for a program Parameters:
ParameterTypeRequiredDefaultDescription
programIdstringYesProgram ID from Speech and Text Analytics

genesys_tasks_quality_get_quality_conversation_evaluation

Get an evaluation Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId
evaluationIdstringYesevaluationId
expandstringNoagent, assignee, evaluator, evaluationForm

genesys_tasks_quality_get_quality_evaluations_query

Queries Evaluations and returns a paged list Parameters:
ParameterTypeRequiredDefaultDescription
pageSizeintegerNoThe total page size requested
pageNumberintegerNoThe page number requested
expandany[]Novariable name requested by expand list
previousPagestringNoPrevious page token
conversationIdstringNoconversationId specified
agentUserIdstringNouser id of the agent
agentTeamIdstringNoteam id of the agent
evaluatorUserIdstringNoevaluator user id
assigneeUserIdstringNoassignee user id
queueIdstringNoqueue id
startTimestringNostart time of the evaluation query
endTimestringNoend time of the evaluation query
formContextIdstringNoshared id between form versions
evaluationStateany[]NoevaluationState
isReleasedbooleanNothe evaluation has been released
agentHasReadbooleanNoagent has the evaluation
expandAnswerTotalScoresbooleanNoget the total scores for evaluations. NOTE: The answers will only be populated if this parameter is set to true in the request.
maximumintegerNothe maximum number of results to return
sortOrderstringNoNOTE: Does not work when conversationId is supplied.
includeDeletedUsersbooleanNoAllow 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:
ParameterTypeRequiredDefaultDescription
surveyIdstringYessurveyId

genesys_tasks_quality_get_surveys_scorable

Get a survey as an end-customer, for the purposes of scoring it. Parameters:
ParameterTypeRequiredDefaultDescription
customerSurveyUrlstringYescustomerSurveyUrl

genesys_tasks_quality_get_taskmanagement_workbin

Get a workbin Parameters:
ParameterTypeRequiredDefaultDescription
workbinIdstringYesWorkbin ID

genesys_tasks_quality_get_taskmanagement_workitem

Get a workitem Parameters:
ParameterTypeRequiredDefaultDescription
workitemIdstringYesWorkitem ID
expandsany[]NoWhich fields to expand. Comma separated if more than one.

genesys_tasks_quality_get_taskmanagement_worktype

Get a worktype Parameters:
ParameterTypeRequiredDefaultDescription
worktypeIdstringYesWorktype id
expandsany[]NoWhich fields, if any, to expand.

genesys_tasks_quality_get_taskmanagement_worktype_statuses

Get list of statuses for this worktype. Parameters:
ParameterTypeRequiredDefaultDescription
worktypeIdstringYesWorktype id

genesys_tasks_quality_get_workbin

Get a workbin Parameters:
ParameterTypeRequiredDefaultDescription
workbinIdstringYesWorkbin ID

genesys_tasks_quality_get_workbin_history

Get a listing of a workbin’s attribute change history Parameters:
ParameterTypeRequiredDefaultDescription
workbinIdstringYesWorkbin ID
afterstringNoThe cursor that points to the end of the set of entities that has been returned.
pageSizeintegerNoLimit 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.
sortOrderstringNoAscending or descending sort order

genesys_tasks_quality_get_workbin_version

Get a version of a workbin Parameters:
ParameterTypeRequiredDefaultDescription
workbinIdstringYesWorkbin ID
entityVersionintegerYesWorkbin version

genesys_tasks_quality_get_workbin_versions

Get all versions of a workbin Parameters:
ParameterTypeRequiredDefaultDescription
workbinIdstringYesWorkbin ID
afterstringNoThe cursor that points to the end of the set of entities that has been returned.
pageSizeintegerNoLimit 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.
sortOrderstringNoAscending or descending sort order

genesys_tasks_quality_get_workitem

Get a workitem Parameters:
ParameterTypeRequiredDefaultDescription
workitemIdstringYesWorkitem ID
expandsany[]NoWhich 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:
ParameterTypeRequiredDefaultDescription
workitemIdstringYesWorkitem ID
afterstringNoThe cursor that points to the end of the set of entities that has been returned.
pageSizeintegerNoLimit 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.
sortOrderstringNoAscending or descending sort order

genesys_tasks_quality_get_workitem_user_wrapups

Get all wrapup codes added for the given user for a workitem. Parameters:
ParameterTypeRequiredDefaultDescription
workitemIdstringYesThe ID of the Workitem.
userIdstringYesThe ID of the user
expandsstringNoWhich fields, if any, to expand.
afterstringNoThe cursor that points to the end of the set of entities that has been returned.
pageSizeintegerNoLimit 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.
sortOrderstringNoAscending or descending sort order

genesys_tasks_quality_get_workitem_version

Get a version of a workitem Parameters:
ParameterTypeRequiredDefaultDescription
workitemIdstringYesWorkitem ID
entityVersionintegerYesWorkitem version

genesys_tasks_quality_get_workitem_versions

Get all versions of a workitem Parameters:
ParameterTypeRequiredDefaultDescription
workitemIdstringYesWorkitem ID
afterstringNoThe cursor that points to the end of the set of entities that has been returned.
pageSizeintegerNoLimit 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.
sortOrderstringNoAscending or descending sort order

genesys_tasks_quality_get_workitem_wrapups

Get all wrapup codes added for all users for a workitem. Parameters:
ParameterTypeRequiredDefaultDescription
workitemIdstringYesThe ID of the Workitem.
expandsstringNoWhich fields, if any, to expand.
afterstringNoThe cursor that points to the end of the set of entities that has been returned.
pageSizeintegerNoLimit 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.
sortOrderstringNoAscending or descending sort order

genesys_tasks_quality_get_worktype

Get a worktype Parameters:
ParameterTypeRequiredDefaultDescription
worktypeIdstringYesWorktype id
expandsany[]NoWhich fields, if any, to expand.

genesys_tasks_quality_get_worktype_history

Get a listing of a worktype’s attribute change history Parameters:
ParameterTypeRequiredDefaultDescription
worktypeIdstringYesWorktype id
afterstringNoThe cursor that points to the end of the set of entities that has been returned.
pageSizeintegerNoLimit 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.
sortOrderstringNoAscending or descending sort order
fieldsany[]NoComma-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:
ParameterTypeRequiredDefaultDescription
worktypeIdstringYesWorktype id
statusIdstringYesStatus id

genesys_tasks_quality_get_worktype_statuses

Get list of statuses for this worktype. Parameters:
ParameterTypeRequiredDefaultDescription
worktypeIdstringYesWorktype id

genesys_tasks_quality_get_worktype_version

Get a version of a worktype Parameters:
ParameterTypeRequiredDefaultDescription
worktypeIdstringYesWorktype id
entityVersionintegerYesWorktype version

genesys_tasks_quality_get_worktype_versions

Get all versions of a worktype Parameters:
ParameterTypeRequiredDefaultDescription
worktypeIdstringYesWorktype id
afterstringNoThe cursor that points to the end of the set of entities that has been returned.
pageSizeintegerNoLimit 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.
sortOrderstringNoAscending 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:
ParameterTypeRequiredDefaultDescription
formIdstringYesForm ID
contextIdstringYesUnique Id for all versions of this form
disabledbooleanNoIs this form disabled
footerstringNoMarkdown text for the bottom of the form.
headerstringNoMarkdown text for the top of the form.
idstringNoThe globally unique identifier for the object.
languagestringYesLanguage 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
modifiedDatestringNoLast modified date. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
namestringYesThe survey form name
publishedbooleanNoIs this form published
publishedVersionsobjectNopublishedVersions
questionGroupsany[]NoA list of question groups
selfUristringNoThe URI for this object

genesys_tasks_quality_patch_taskmanagement_workitem

Update the attributes of a workitem Parameters:
ParameterTypeRequiredDefaultDescription
workitemIdstringYesWorkitem ID
assigneeIdstringNoThe ID of the assignee of the Workitem. If supplied it must be a valid UUID.
assignmentOperationstringNoSet 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.
assignmentStatestringNoThe assignment state of the Workitem.
autoStatusTransitionbooleanNoSet it to false to disable auto status transition. By default, it is enabled.
customFieldsobjectNoCustom fields defined in the schema referenced by the worktype of the workitem. If set to {}, the existing keys and values will be removed.
dateClosedstringNoThe closed date of the Workitem. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
dateDuestringNoThe 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
dateExpiresstringNoThe 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
descriptionstringNoThe description of the Workitem. Maximum length of 512 characters.
durationSecondsintegerNoThe estimated duration in seconds to complete the Workitem. Maximum of 365 days.
externalContactIdstringNoThe ID of the external contact of the Workitem. Must be a valid UUID.
externalTagstringNoThe external tag of the Workitem.
languageIdstringNoThe ID of language of the Workitem. Must be a valid UUID.
namestringNoThe name of the Workitem. Valid length between 3 and 256 characters.
preferredAgentIdsany[]NoThe preferred agent IDs of the Workitem. Must be valid UUIDs.
priorityintegerNoThe priority of the Workitem. The valid range is between -25,000,000 and 25,000,000.
queueIdstringNoThe ID of the Workitems queue. Must be a valid UUID.
scoredAgentsany[]NoA list of scored agents for the Workitem. A workitem can have a maximum of 20 scored agents.
scriptIdstringNoThe ID of the Workitems script. Must be a valid UUID.
skillIdsany[]NoThe skill IDs of the Workitem. Must be valid UUIDs.
statusIdstringNoThe ID of the Status of the Workitem.
ttlintegerNoThe epoch timestamp in seconds specifying the time to live for the Workitem. Can not be greater than 365 days from the current time.
utilizationLabelIdstringNoThe ID of the utilization label of the Workitem. Must be a valid UUID.
workbinIdstringNoThe 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:
ParameterTypeRequiredDefaultDescription
workitemIdstringYesWorkitem ID
idstringYesThe globally unique identifier for this user.

genesys_tasks_quality_patch_workbin

Update the attributes of a workbin Parameters:
ParameterTypeRequiredDefaultDescription
workbinIdstringYesWorkbin ID
descriptionstringNoWorkbin description. Maximum length of 512 characters.
namestringNoWorkbin name. Valid length between 3 and 256 characters.

genesys_tasks_quality_patch_workitem

Update the attributes of a workitem Parameters:
ParameterTypeRequiredDefaultDescription
workitemIdstringYesWorkitem ID
assigneeIdstringNoThe ID of the assignee of the Workitem. If supplied it must be a valid UUID.
assignmentOperationstringNoSet 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.
assignmentStatestringNoThe assignment state of the Workitem.
autoStatusTransitionbooleanNoSet it to false to disable auto status transition. By default, it is enabled.
customFieldsobjectNoCustom fields defined in the schema referenced by the worktype of the workitem. If set to {}, the existing keys and values will be removed.
dateClosedstringNoThe closed date of the Workitem. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
dateDuestringNoThe 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
dateExpiresstringNoThe 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
descriptionstringNoThe description of the Workitem. Maximum length of 512 characters.
durationSecondsintegerNoThe estimated duration in seconds to complete the Workitem. Maximum of 365 days.
externalContactIdstringNoThe ID of the external contact of the Workitem. Must be a valid UUID.
externalTagstringNoThe external tag of the Workitem.
languageIdstringNoThe ID of language of the Workitem. Must be a valid UUID.
namestringNoThe name of the Workitem. Valid length between 3 and 256 characters.
preferredAgentIdsany[]NoThe preferred agent IDs of the Workitem. Must be valid UUIDs.
priorityintegerNoThe priority of the Workitem. The valid range is between -25,000,000 and 25,000,000.
queueIdstringNoThe ID of the Workitems queue. Must be a valid UUID.
scoredAgentsany[]NoA list of scored agents for the Workitem. A workitem can have a maximum of 20 scored agents.
scriptIdstringNoThe ID of the Workitems script. Must be a valid UUID.
skillIdsany[]NoThe skill IDs of the Workitem. Must be valid UUIDs.
statusIdstringNoThe ID of the Status of the Workitem.
ttlintegerNoThe epoch timestamp in seconds specifying the time to live for the Workitem. Can not be greater than 365 days from the current time.
utilizationLabelIdstringNoThe ID of the utilization label of the Workitem. Must be a valid UUID.
workbinIdstringNoThe 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:
ParameterTypeRequiredDefaultDescription
workitemIdstringYesWorkitem ID
idstringYesThe 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:
ParameterTypeRequiredDefaultDescription
workitemIdstringYesThe ID of the Workitem.
userIdstringYesThe ID of the user
actionstringYesAction to be performed for the wrapup code.
wrapupCodestringYesThe 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:
ParameterTypeRequiredDefaultDescription
workitemIdstringYesThe ID of the Workitem.
actionstringYesAction to be performed for the wrapup code.
wrapupCodestringYesThe wrapup code which will be added/removed.

genesys_tasks_quality_patch_worktype

Update the attributes of a worktype Parameters:
ParameterTypeRequiredDefaultDescription
worktypeIdstringYesWorktype id
assignmentEnabledbooleanNoWhen set to true, Workitems will be sent to the queue of the Worktype as they are created. Default value is false.
defaultDueDurationSecondsintegerNoThe default due duration in seconds for Workitems created from the Worktype. Maximum of 365 days.
defaultDurationSecondsintegerNoThe default duration in seconds for Workitems created from the Worktype. Maximum of 365 days.
defaultExpirationSecondsintegerNoThe default expiration time in seconds for Workitems created from the Worktype. Maximum of 365 days.
defaultLanguageIdstringNoThe ID of the default language for Workitems created from the Worktype. Must be a valid UUID.
defaultPriorityintegerNoThe default priority for Workitems created from the Worktype. The valid range is between -25,000,000 and 25,000,000.
defaultQueueIdstringNoThe ID of the default queue for Workitems created from the Worktype. Must be a valid UUID.
defaultScriptIdstringNoThe default script for Workitems created from the Worktype. Must be a valid UUID.
defaultSkillIdsany[]NoThe IDs of the default skills for Workitems created from the Worktype. Must be valid UUIDs. Maximum of 20 IDs
defaultStatusIdstringNoThe ID of the default status for Workitems created from the Worktype. Must be a valid UUID.
defaultTtlSecondsintegerNoThe default time to time to live in seconds for Workitems created from the Worktype. The valid range is between 1 and 365 days.
defaultWorkbinIdstringNoThe ID of the default Workbin for Workitems created from the Worktype.
descriptionstringNoThe description of the Worktype. Maximum length of 512 characters.
namestringNoThe name of the Worktype. Valid length between 3 and 256 characters.
ruleSettingsobjectNoruleSettings
schemaIdstringNoThe ID of the custom attribute schema for Workitems created from the Worktype. Must be a valid UUID.
schemaVersionintegerNoThe version of the Worktypes custom attribute schema. The latest schema version will be used if this property is not set.
serviceLevelTargetintegerNoThe target service level for Workitems created from the Worktype. The default value is 100.
unassignedDivisionContactsEnabledbooleanNoWhen 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:
ParameterTypeRequiredDefaultDescription
worktypeIdstringYesWorktype id
statusIdstringYesStatus id
autoTerminateWorkitembooleanNoTerminate workitem on selection of status. Applicable only for statuses in the Closed category.
defaultDestinationStatusIdstringNoDefault destination status to which this Status will transition to if auto status transition enabled.
descriptionstringNoThe description of the Status. Maximum length of 512 characters.
destinationStatusIdsany[]NoA 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.
namestringNoThe name of the Status. Valid length between 3 and 256 characters.
statusTransitionDelaySecondsintegerNoDelay in seconds for auto status transition. Required if defaultDestinationStatusId is provided.
statusTransitionTimestringNoTime 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:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId
expandstringNoevaluatorId
agentobjectNoagent
agentHasReadbooleanNoagentHasRead
answersobjectNoanswers
assigneeobjectNoassignee
calibrationobjectNocalibration
conversationobjectNoconversation
dateAssigneeChangedstringNoDate time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
evaluationContextIdstringNoevaluationContextId
evaluationFormobjectNoevaluationForm
evaluationSourceobjectNoevaluationSource
evaluatorobjectNoevaluator
idstringNoThe globally unique identifier for the object.
neverReleasebooleanNoneverRelease
queueobjectNoqueue
releaseDatestringNoDate time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
rescorebooleanNorescore
resourceTypestringNoresourceType
selfUristringNoThe URI for this object
statusstringNostatus

genesys_tasks_quality_post_conversations_audits_query

Create audit query execution Parameters:
ParameterTypeRequiredDefaultDescription
filtersany[]YesList of filters for the query.
intervalstringYesDate 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
sortany[]NoSort parameter for the query.

genesys_tasks_quality_post_evaluations_aggregates_query_me

Query for evaluation aggregates for the current user Parameters:
ParameterTypeRequiredDefaultDescription
alternateTimeDimensionstringNoDimension to use as the alternative timestamp for data in the aggregate. Choosing “eventTime” uses the actual time of the data event.
contextIdstringNoEvaluation context Id
groupByany[]NoBehaves 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.
intervalstringYesBehaves 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
metricsany[]YesBehaves like a SQL SELECT clause. Only named metrics will be retrieved.
timeZonestringNoTime 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:
ParameterTypeRequiredDefaultDescription
answersobjectNoanswers
evaluationFormobjectNoevaluationForm

genesys_tasks_quality_post_evaluations_search

Search evaluations based along specified criteria Parameters:
ParameterTypeRequiredDefaultDescription
aggregationsany[]NoAggregations to compute on the search results
pageNumberintegerYesThe page of resources you want to retrieve
pageSizeintegerNoThe number of results per page. For aggregation requests, must be omitted or 0.
queryany[]Yesquery
sortBystringNoThe field in the resource that you want to sort the results by. Include with sortOrder.
sortOrderstringNoThe sort order for results. Include with sortBy.
systemSubmittedbooleanNoFilter for automated evaluations submitted by virtual supervisor. Defaults to false.

genesys_tasks_quality_post_forms_evaluations

Create an evaluation form. Parameters:
ParameterTypeRequiredDefaultDescription
aiScoringobjectNoaiScoring
contextIdstringNocontextId
dialectstringNoThe 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
evaluationSettingsobjectNoevaluationSettings
idstringNoThe globally unique identifier for the object.
latestVersionFormNamestringNoThe name of the form’s most recently published version
modifiedDatestringNoDate time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
namestringYesThe evaluation form name
publishedbooleanNopublished
publishedVersionsobjectNopublishedVersions
questionGroupsany[]YesA list of question groups
selfUristringNoThe URI for this object

genesys_tasks_quality_post_forms_surveys

Create a survey form. Parameters:
ParameterTypeRequiredDefaultDescription
contextIdstringYesUnique Id for all versions of this form
disabledbooleanNoIs this form disabled
footerstringNoMarkdown text for the bottom of the form.
headerstringNoMarkdown text for the top of the form.
idstringNoThe globally unique identifier for the object.
languagestringYesLanguage 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
modifiedDatestringNoLast modified date. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
namestringYesThe survey form name
publishedbooleanNoIs this form published
publishedVersionsobjectNopublishedVersions
questionGroupsany[]NoA list of question groups
selfUristringNoThe URI for this object

genesys_tasks_quality_post_program_agentscoringrules

Create an Agent Scoring Rule Parameters:
ParameterTypeRequiredDefaultDescription
programIdstringYesProgram ID from Speech and Text Analytics
dateCreatedstringNoDate when the rule was created. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
dateModifiedstringNoDate when the rule was last modified. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
enabledbooleanYesWhether the rule is enabled.
evaluationFormContextIdstringYesThe evaluation form contextID to use for scoring.
evaluatorobjectNoevaluator
idstringNoThe globally unique identifier for the object.
publishedbooleanNoWhether the rule is published.
samplingPercentagenumberNoPercentage of interactions to evaluate (0.01-100.00). Required when samplingType is Percentage, null when All.
samplingTypestringYesSampling type setting. Valid values: All, Percentage
selfUristringNoThe URI for this object
submissionTypestringYesSubmission type for evaluations. Valid values: Automated, Manual

genesys_tasks_quality_post_quality_evaluations_search

Search evaluations based along specified criteria Parameters:
ParameterTypeRequiredDefaultDescription
aggregationsany[]NoAggregations to compute on the search results
pageNumberintegerYesThe page of resources you want to retrieve
pageSizeintegerNoThe number of results per page. For aggregation requests, must be omitted or 0.
queryany[]Yesquery
sortBystringNoThe field in the resource that you want to sort the results by. Include with sortOrder.
sortOrderstringNoThe sort order for results. Include with sortBy.
systemSubmittedbooleanNoFilter for automated evaluations submitted by virtual supervisor. Defaults to false.

genesys_tasks_quality_post_surveys

Create a survey for a conversation Parameters:
ParameterTypeRequiredDefaultDescription
agentIdstringNoThe agent to associate with the survey. If not specified, the last agent on the conversation will be selected.
conversationIdstringYesThe conversation to create the survey for.
queueIdstringNoThe queue to associate with the survey. If not specified, the queue associated with the selected agent will be used.
surveyFormContextIdstringYesThe survey form context to use for the survey.

genesys_tasks_quality_post_surveys_scoring

Score survey Parameters:
ParameterTypeRequiredDefaultDescription
answersobjectNoanswers
surveyFormobjectNosurveyForm

genesys_tasks_quality_post_taskmanagement_workbins_query

Query for workbins Parameters:
ParameterTypeRequiredDefaultDescription
afterstringNoThe cursor that points to the end of the set of entities that has been returned.
attributesany[]NoList of entity attributes to be retrieved in the result.
filtersany[]YesList of filter objects to be used in the search. Valid filter names are: ‘id’, ‘name’, ‘description’, ‘divisionId’, ‘dateCreated’, ‘dateModified’, ‘modifiedBy’
pageSizeintegerNoLimit 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.
selectstringNoSpecify the value ‘Count’ for this parameter in order to return only the record count.
sortobjectNosort

genesys_tasks_quality_post_taskmanagement_workitem_terminate

Terminate a workitem Parameters:
ParameterTypeRequiredDefaultDescription
workitemIdstringYesWorkitem ID
statusIdstringNoThe 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:
ParameterTypeRequiredDefaultDescription
assigneeIdstringNoThe ID of the assignee of the Workitem. Must be a valid UUID.
autoStatusTransitionbooleanNoSet it to false to disable auto status transition. By default, it is enabled.
customFieldsobjectNoCustom fields defined in the schema referenced by the worktype of the workitem.
dateDuestringNoThe 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
dateExpiresstringNoThe 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
descriptionstringNoThe description of the Workitem. Maximum length of 512 characters.
durationSecondsintegerNoThe estimated duration in seconds to complete the Workitem. Maximum of 365 days.
externalContactIdstringNoThe ID of the external contact of the Workitem. Must be a valid UUID.
externalTagstringNoThe external tag of the Workitem.
languageIdstringNoThe ID of language of the Workitem. Must be a valid UUID.
namestringYesThe name of the Workitem. Valid length between 3 and 256 characters.
preferredAgentIdsany[]NoThe preferred agent IDs of the Workitem. Must be valid UUIDs.
priorityintegerNoThe priority of the Workitem. The valid range is between -25,000,000 and 25,000,000.
queueIdstringNoThe ID of the Workitems queue. Must be a valid UUID.
scoredAgentsany[]NoA list of scored agents for the Workitem. A workitem can have a maximum of 20 scored agents.
scriptIdstringNoThe ID of the Workitems script. Must be a valid UUID.
skillIdsany[]NoThe skill IDs of the Workitem. Must be valid UUIDs.
statusIdstringNoThe ID of the Status of the Workitem.
ttlintegerNoThe epoch timestamp in seconds specifying the time to live for the Workitem. Can not be greater than 365 days from the current time.
typeIdstringYesThe ID of the Worktype of the Workitem.
utilizationLabelIdstringNoThe ID of utilization label of the Workitem. Must be a valid UUID.
workbinIdstringNoThe ID of Workbin that contains the Workitem.
wrapupCodestringNoThe ID of the wrapup. Must be a valid UUID.

genesys_tasks_quality_post_taskmanagement_workitems_query

Query for workitems Parameters:
ParameterTypeRequiredDefaultDescription
afterstringNoThe cursor that points to the end of the set of entities that has been returned.
attributesany[]NoList of entity attributes to be retrieved in the result.
expandsany[]NoList of entity attributes to be expanded in the result.
filtersany[]YesList 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>‘
pageSizeintegerNoLimit 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.
selectstringNoSpecify the value ‘Count’ for this parameter in order to return only the record count.
sortobjectNosort

genesys_tasks_quality_post_taskmanagement_worktypes_query

Query for worktypes Parameters:
ParameterTypeRequiredDefaultDescription
afterstringNoThe cursor that points to the end of the set of entities that has been returned.
attributesany[]NoList of entity attributes to be retrieved in the result.
filtersany[]YesList 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’
pageSizeintegerNoLimit 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.
selectstringNoSpecify the value ‘Count’ for this parameter in order to return only the record count.
sortobjectNosort

genesys_tasks_quality_post_workbins

Create a workbin Parameters:
ParameterTypeRequiredDefaultDescription
descriptionstringNoWorkbin description. Maximum length of 512 characters.
divisionIdstringNoThe ID of the division the Workbin belongs to. Defaults to home division ID.
namestringYesWorkbin name. Valid length between 3 and 256 characters.

genesys_tasks_quality_post_workbins_query

Query for workbins Parameters:
ParameterTypeRequiredDefaultDescription
afterstringNoThe cursor that points to the end of the set of entities that has been returned.
attributesany[]NoList of entity attributes to be retrieved in the result.
filtersany[]YesList of filter objects to be used in the search. Valid filter names are: ‘id’, ‘name’, ‘description’, ‘divisionId’, ‘dateCreated’, ‘dateModified’, ‘modifiedBy’
pageSizeintegerNoLimit 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.
selectstringNoSpecify the value ‘Count’ for this parameter in order to return only the record count.
sortobjectNosort

genesys_tasks_quality_post_workitem_acd_cancel

Cancel the assignment process for a workitem that is currently queued for assignment through ACD. Parameters:
ParameterTypeRequiredDefaultDescription
workitemIdstringYesWorkitem ID

genesys_tasks_quality_post_workitem_disconnect

Disconnect the assignee of the workitem Parameters:
ParameterTypeRequiredDefaultDescription
workitemIdstringYesWorkitem ID

genesys_tasks_quality_post_workitem_terminate

Terminate a workitem Parameters:
ParameterTypeRequiredDefaultDescription
workitemIdstringYesWorkitem ID
statusIdstringNoThe 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:
ParameterTypeRequiredDefaultDescription
assigneeIdstringNoThe ID of the assignee of the Workitem. Must be a valid UUID.
autoStatusTransitionbooleanNoSet it to false to disable auto status transition. By default, it is enabled.
customFieldsobjectNoCustom fields defined in the schema referenced by the worktype of the workitem.
dateDuestringNoThe 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
dateExpiresstringNoThe 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
descriptionstringNoThe description of the Workitem. Maximum length of 512 characters.
durationSecondsintegerNoThe estimated duration in seconds to complete the Workitem. Maximum of 365 days.
externalContactIdstringNoThe ID of the external contact of the Workitem. Must be a valid UUID.
externalTagstringNoThe external tag of the Workitem.
languageIdstringNoThe ID of language of the Workitem. Must be a valid UUID.
namestringYesThe name of the Workitem. Valid length between 3 and 256 characters.
preferredAgentIdsany[]NoThe preferred agent IDs of the Workitem. Must be valid UUIDs.
priorityintegerNoThe priority of the Workitem. The valid range is between -25,000,000 and 25,000,000.
queueIdstringNoThe ID of the Workitems queue. Must be a valid UUID.
scoredAgentsany[]NoA list of scored agents for the Workitem. A workitem can have a maximum of 20 scored agents.
scriptIdstringNoThe ID of the Workitems script. Must be a valid UUID.
skillIdsany[]NoThe skill IDs of the Workitem. Must be valid UUIDs.
statusIdstringNoThe ID of the Status of the Workitem.
ttlintegerNoThe epoch timestamp in seconds specifying the time to live for the Workitem. Can not be greater than 365 days from the current time.
typeIdstringYesThe ID of the Worktype of the Workitem.
utilizationLabelIdstringNoThe ID of utilization label of the Workitem. Must be a valid UUID.
workbinIdstringNoThe ID of Workbin that contains the Workitem.
wrapupCodestringNoThe ID of the wrapup. Must be a valid UUID.

genesys_tasks_quality_post_workitems_query

Query for workitems Parameters:
ParameterTypeRequiredDefaultDescription
afterstringNoThe cursor that points to the end of the set of entities that has been returned.
attributesany[]NoList of entity attributes to be retrieved in the result.
expandsany[]NoList of entity attributes to be expanded in the result.
filtersany[]YesList 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>‘
pageSizeintegerNoLimit 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.
selectstringNoSpecify the value ‘Count’ for this parameter in order to return only the record count.
sortobjectNosort

genesys_tasks_quality_post_worktype_statuses

Add a status to a worktype Parameters:
ParameterTypeRequiredDefaultDescription
worktypeIdstringYesWorktype id
autoTerminateWorkitembooleanNoTerminate workitem on selection of status. Applicable only for statuses in the Closed category.
categorystringYesThe Category of the Status.
defaultDestinationStatusIdstringNoDefault destination status to which this Status will transition to if auto status transition enabled.
descriptionstringNoThe description of the Status. Maximum length of 512 characters.
destinationStatusIdsany[]NoA 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.
namestringYesThe name of the Status. Valid length between 3 and 256 characters.
statusTransitionDelaySecondsintegerNoDelay in seconds for auto status transition. Required if defaultDestinationStatusId is provided.
statusTransitionTimestringNoTime 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:
ParameterTypeRequiredDefaultDescription
assignmentEnabledbooleanNoWhen set to true, Workitems will be sent to the queue of the Worktype as they are created. Default value is false.
defaultDueDurationSecondsintegerNoThe default due duration in seconds for Workitems created from the Worktype. Maximum of 365 days.
defaultDurationSecondsintegerNoThe default duration in seconds for Workitems created from the Worktype. Maximum of 365 days.
defaultExpirationSecondsintegerNoThe default expiration time in seconds for Workitems created from the Worktype. Maximum of 365 days.
defaultLanguageIdstringNoThe ID of the default language for Workitems created from the Worktype. Must be a valid UUID.
defaultPriorityintegerNoThe default priority for Workitems created from the Worktype. The valid range is between -25,000,000 and 25,000,000.
defaultQueueIdstringNoThe ID of the default queue for Workitems created from the Worktype. Must be a valid UUID.
defaultScriptIdstringNoThe default script for Workitems created from the Worktype. Must be a valid UUID.
defaultSkillIdsany[]NoThe IDs of the default skills for Workitems created from the Worktype. Must be valid UUIDs. Maximum of 20 IDs
defaultTtlSecondsintegerNoThe default time to time to live in seconds for Workitems created from the Worktype. The valid range is between 1 and 365 days.
defaultWorkbinIdstringYesThe ID of the default Workbin for Workitems created from the Worktype.
descriptionstringNoThe description of the Worktype. Maximum length of 512 characters.
disableDefaultStatusCreationbooleanNoSet to true to disable default status creation. Default statuses are created with the Worktype by default
divisionIdstringNoThe 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.
namestringYesThe name of the Worktype. Valid length between 3 and 256 characters.
ruleSettingsobjectNoruleSettings
schemaIdstringNoThe ID of the custom attribute schema for Workitems created from the Worktype. Must be a valid UUID.
schemaVersionintegerNoThe version of the Worktypes custom attribute schema. The latest schema version will be used if this property is not set.
serviceLevelTargetintegerNoThe target service level for Workitems created from the Worktype. The default value is 100.
unassignedDivisionContactsEnabledbooleanNoWhen 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:
ParameterTypeRequiredDefaultDescription
afterstringNoThe cursor that points to the end of the set of entities that has been returned.
attributesany[]NoList of entity attributes to be retrieved in the result.
filtersany[]YesList 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’
pageSizeintegerNoLimit 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.
selectstringNoSpecify the value ‘Count’ for this parameter in order to return only the record count.
sortobjectNosort

genesys_tasks_quality_put_conversation_evaluation

Update an evaluation Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId
evaluationIdstringYesevaluationId
expandstringNoevaluatorId, evaluationForm, assignee, evaluator
agentobjectNoagent
agentHasReadbooleanNoagentHasRead
agentTeamobjectNoagentTeam
aiScoringobjectNoaiScoring
answersobjectNoanswers
assignedbooleanNoSet to false to unassign the evaluation. This cannot be set to false when assignee is also set.
assignedDatestringNoDate time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
assigneeobjectNoassignee
assigneeApplicablebooleanNoIndicates whether an assignee is applicable for the evaluation. Set to false when assignee is not applicable.
authorizedActionsany[]NoList of user authorized actions on evaluation. Possible values: assign, edit, editScore, editAgentSignoff, delete, release, viewAudit
calibrationobjectNocalibration
changedDatestringNoDate time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
conversationobjectNoconversation
conversationDatestringNoCreation date of the conversation. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
conversationEndDatestringNoEnd 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
createdDatestringNoDate time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
dateAssigneeChangedstringNoDate when the assignee was last changed. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
divisionIdsany[]NoEvaluation is assigned in the following division(s).
evaluationFormobjectNoevaluationForm
evaluationSourceobjectNoevaluationSource
evaluatorobjectNoevaluator
hasAssistanceFailedbooleanNoIs true when evaluation assistance didn’t execute successfully
idstringNoThe globally unique identifier for the object.
isScoringIndexbooleanNoisScoringIndex
mediaTypeany[]NoList of different communication types used in conversation.
namestringNoname
neverReleasebooleanNoSignifies if the evaluation is never to be released. This cannot be set true if release date is also set.
queueobjectNoqueue
redactedbooleanNoIs only true when the user making the request does not have sufficient permissions to see evaluation
releaseDatestringNoDate time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
rescorebooleanNoIs only true when evaluation is re-scored.
resourceIdstringNoOnly used for email evaluations. Will be null for all other evaluations.
resourceTypestringNoThe type of resource. Only used for email evaluations. Will be null for evaluations on all other resources.
revisionCreatedDatestringNoDate time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
selfUristringNoThe URI for this object
statusstringNostatus
submittedDatestringNoDate 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:
ParameterTypeRequiredDefaultDescription
formIdstringYesForm ID
aiScoringobjectNoaiScoring
contextIdstringNocontextId
dialectstringNoThe 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
evaluationSettingsobjectNoevaluationSettings
idstringNoThe globally unique identifier for the object.
latestVersionFormNamestringNoThe name of the form’s most recently published version
modifiedDatestringNoDate time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
namestringYesThe evaluation form name
publishedbooleanNopublished
publishedVersionsobjectNopublishedVersions
questionGroupsany[]YesA list of question groups
selfUristringNoThe URI for this object

genesys_tasks_quality_put_forms_survey

Update a survey form. Parameters:
ParameterTypeRequiredDefaultDescription
formIdstringYesForm ID
contextIdstringYesUnique Id for all versions of this form
disabledbooleanNoIs this form disabled
footerstringNoMarkdown text for the bottom of the form.
headerstringNoMarkdown text for the top of the form.
idstringNoThe globally unique identifier for the object.
languagestringYesLanguage 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
modifiedDatestringNoLast modified date. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
namestringYesThe survey form name
publishedbooleanNoIs this form published
publishedVersionsobjectNopublishedVersions
questionGroupsany[]NoA list of question groups
selfUristringNoThe URI for this object

genesys_tasks_quality_put_program_agentscoringrule

Update an Agent Scoring Rule Parameters:
ParameterTypeRequiredDefaultDescription
programIdstringYesProgram ID from Speech and Text Analytics
ruleIdstringYesAgent Scoring Rule ID
dateCreatedstringNoDate when the rule was created. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
dateModifiedstringNoDate when the rule was last modified. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
enabledbooleanYesWhether the rule is enabled.
evaluationFormContextIdstringYesThe evaluation form contextID to use for scoring.
evaluatorobjectNoevaluator
idstringNoThe globally unique identifier for the object.
publishedbooleanNoWhether the rule is published.
samplingPercentagenumberNoPercentage of interactions to evaluate (0.01-100.00). Required when samplingType is Percentage, null when All.
samplingTypestringYesSampling type setting. Valid values: All, Percentage
selfUristringNoThe URI for this object
submissionTypestringYesSubmission 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:
ParameterTypeRequiredDefaultDescription
customerSurveyUrlstringYescustomerSurveyUrl
answersobjectNoanswers
idstringNoThe globally unique identifier for the object.
namestringNoname
selfUristringNoThe URI for this object
statusstringNostatus
surveyFormobjectNosurveyForm