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

Tools

ToolDescription
genesys_analytics_delete_conversations_details_jobDelete/cancel an async details job
genesys_analytics_delete_users_details_jobDelete/cancel an async request
genesys_analytics_get_agent_statusGet an agent and their active sessions by user ID
genesys_analytics_get_analytics_agent_statusGet an agent and their active sessions by user ID
genesys_analytics_get_analytics_conversation_detailsGet a conversation by id
genesys_analytics_get_analytics_conversations_detailsGets multiple conversations by id
genesys_analytics_get_botflow_divisions_reportingturnsGet Reporting Turns (division aware).
genesys_analytics_get_botflow_sessionsGet Bot Flow Sessions.
genesys_analytics_get_conversations_details_jobGet status for async query for conversation details
genesys_analytics_get_users_details_jobGet status for async query for user details
genesys_analytics_get_users_details_job_resultsFetch a page of results for an async query
genesys_analytics_post_actions_aggregates_queryQuery for action aggregates
genesys_analytics_post_agentcopilots_aggregates_queryQuery for agent copilot aggregates
genesys_analytics_post_agents_status_countsCount agents by different groupings
genesys_analytics_post_agents_status_queryRetrieve the top 50 agents matching the query filters
genesys_analytics_post_analytics_agents_status_countsCount agents by different groupings
genesys_analytics_post_analytics_agents_status_queryRetrieve the top 50 agents matching the query filters
genesys_analytics_post_analytics_conversations_activity_queryQuery for conversation activity observations
genesys_analytics_post_analytics_evaluations_aggregates_queryQuery for evaluation aggregates
genesys_analytics_post_analytics_surveys_aggregates_queryQuery for survey aggregates
genesys_analytics_post_analytics_users_activity_queryQuery for user activity observations
genesys_analytics_post_analytics_users_aggregates_queryQuery for user aggregates
genesys_analytics_post_analytics_users_details_queryQuery for user details
genesys_analytics_post_analytics_users_observations_queryQuery for user observations
genesys_analytics_post_bots_aggregates_queryQuery for bot aggregates
genesys_analytics_post_conversation_details_propertiesIndex conversation properties
genesys_analytics_post_conversations_details_jobsQuery for conversation details asynchronously
genesys_analytics_post_evaluations_aggregates_queryQuery for evaluation aggregates
genesys_analytics_post_flowexecutions_aggregates_queryQuery for flow execution aggregates
genesys_analytics_post_flows_activity_queryQuery for flow activity observations
genesys_analytics_post_flows_aggregates_queryQuery for flow aggregates
genesys_analytics_post_flows_observations_queryQuery for flow observations
genesys_analytics_post_journeys_aggregates_queryQuery for journey aggregates
genesys_analytics_post_knowledge_aggregates_queryQuery for knowledge aggregates
genesys_analytics_post_queues_observations_queryQuery for queue observations
genesys_analytics_post_ratelimits_aggregates_queryQuery for limits rate limit aggregates. Data populated when limits reach 90% of the maximum. Not a source of truth for limits hit but a best effort estimate.
genesys_analytics_post_resolutions_aggregates_queryQuery for resolution aggregates
genesys_analytics_post_routing_activity_queryQuery for user activity observations
genesys_analytics_post_summaries_aggregates_queryQuery for summary aggregates
genesys_analytics_post_surveys_aggregates_queryQuery for survey aggregates
genesys_analytics_post_taskmanagement_aggregates_queryQuery for task management aggregates
genesys_analytics_post_teams_activity_queryQuery for team activity observations
genesys_analytics_post_transcripts_aggregates_queryQuery for transcript aggregates
genesys_analytics_post_users_activity_queryQuery for user activity observations
genesys_analytics_post_users_aggregates_queryQuery for user aggregates
genesys_analytics_post_users_details_jobsQuery for user details asynchronously
genesys_analytics_post_users_details_queryQuery for user details
genesys_analytics_post_users_observations_queryQuery for user observations

genesys_analytics_delete_conversations_details_job

Delete/cancel an async details job Parameters:
ParameterTypeRequiredDefaultDescription
jobIdstringYesjobId

genesys_analytics_delete_users_details_job

Delete/cancel an async request Parameters:
ParameterTypeRequiredDefaultDescription
jobIdstringYesjobId

genesys_analytics_get_agent_status

Get an agent and their active sessions by user ID Parameters:
ParameterTypeRequiredDefaultDescription
userIdstringYesuserId

genesys_analytics_get_analytics_agent_status

Get an agent and their active sessions by user ID Parameters:
ParameterTypeRequiredDefaultDescription
userIdstringYesuserId

genesys_analytics_get_analytics_conversation_details

Get a conversation by id Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId

genesys_analytics_get_analytics_conversations_details

Gets multiple conversations by id Parameters:
ParameterTypeRequiredDefaultDescription
idany[]NoComma-separated conversation ids

genesys_analytics_get_botflow_divisions_reportingturns

Get Reporting Turns (division aware). Parameters:
ParameterTypeRequiredDefaultDescription
botFlowIdstringYesID of the bot flow.
afterstringNoThe cursor that points to the ID of the last item in the list of entities that has been returned.
pageSizestringNoMax number of entities to return. Maximum of 250
intervalstringNoDate range filter based on the date the individual resources were completed. UTC is the default if no TZ is supplied, however alternate timezones can be used e.g: ‘2022-11-22T09:11:11.111+08:00/2022-11-30T07:17:44.586-07’. . Intervals are represented as an ISO-8601 string. For example: YYYY-MM-DDThh:mm:ss/YYYY-MM-DDThh:mm:ss
actionIdstringNoOptional action ID to get the reporting turns associated to a particular flow action
sessionIdstringNoOptional session ID to get the reporting turns for a particular session. Specifying a session ID alongside an action ID or a language or any ask action results is not allowed.
languagestringNoOptional language code to get the reporting turns for a particular language
askActionResultsstringNoOptional case-insensitive comma separated list of ask action results to filter the reporting turns.

genesys_analytics_get_botflow_sessions

Get Bot Flow Sessions. Parameters:
ParameterTypeRequiredDefaultDescription
botFlowIdstringYesID of the bot flow.
afterstringNoThe cursor that points to the ID of the last item in the list of entities that has been returned.
pageSizestringNoMax number of entities to return. Maximum of 250
intervalstringNoDate range filter based on the date the individual resources were completed. UTC is the default if no TZ is supplied, however alternate timezones can be used e.g: ‘2022-11-22T09:11:11.111+08:00/2022-11-30T07:17:44.586-07’. . Intervals are represented as an ISO-8601 string. For example: YYYY-MM-DDThh:mm:ss/YYYY-MM-DDThh:mm:ss
botResultCategoriesstringNoOptional case-insensitive comma separated list of Bot Result Categories to filter sessions by.
endLanguagestringNoOptional case-insensitive language code to filter sessions by the language the sessions ended in.

genesys_analytics_get_conversations_details_job

Get status for async query for conversation details Parameters:
ParameterTypeRequiredDefaultDescription
jobIdstringYesjobId

genesys_analytics_get_users_details_job

Get status for async query for user details Parameters:
ParameterTypeRequiredDefaultDescription
jobIdstringYesjobId

genesys_analytics_get_users_details_job_results

Fetch a page of results for an async query Parameters:
ParameterTypeRequiredDefaultDescription
jobIdstringYesjobId
cursorstringNoIndicates where to resume query results (not required for first page)
pageSizeintegerNoThe desired maximum number of results

genesys_analytics_post_actions_aggregates_query

Query for action aggregates Parameters:
ParameterTypeRequiredDefaultDescription
alternateTimeDimensionstringNoDimension to use as the alternative timestamp for data in the aggregate. Choosing “eventTime” uses the actual time of the data event.
filterobjectNofilter
flattenMultivaluedDimensionsbooleanNoFlattens any multivalued dimensions used in response groups (e.g. [‘a’,‘b’,‘c’]->‘a,b,c’)
granularitystringNoGranularity aggregates metrics into subpartitions within the time interval specified. The default granularity is the same duration as the interval. Periods are represented as an ISO-8601 string. For example: P1D or P1DT12H
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
viewsany[]NoCustom derived metric views

genesys_analytics_post_agentcopilots_aggregates_query

Query for agent copilot aggregates Parameters:
ParameterTypeRequiredDefaultDescription
alternateTimeDimensionstringNoDimension to use as the alternative timestamp for data in the aggregate. Choosing “eventTime” uses the actual time of the data event.
filterobjectNofilter
flattenMultivaluedDimensionsbooleanNoFlattens any multivalued dimensions used in response groups (e.g. [‘a’,‘b’,‘c’]->‘a,b,c’)
granularitystringNoGranularity aggregates metrics into subpartitions within the time interval specified. The default granularity is the same duration as the interval. Periods are represented as an ISO-8601 string. For example: P1D or P1DT12H
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
limitintegerNoHow many results you want in an ordered list. Only applicable for topN/bottomN query type.
metricsany[]YesBehaves like a SQL SELECT clause. Only named metrics will be retrieved.
queryTypestringNoQuery type to use. Use groupBy for all matching results, and topN/bottomN for N results ordered by the sortMetric. Default is groupBy.
sortMetricobjectNosortMetric
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
viewsany[]NoCustom derived metric views

genesys_analytics_post_agents_status_counts

Count agents by different groupings Parameters:
ParameterTypeRequiredDefaultDescription
groupByany[]NoInclude to choose which groupings to count by and return. If not included it will return only counts grouped by segmentType
sessionFilterobjectNosessionFilter
userFilterobjectNouserFilter

genesys_analytics_post_agents_status_query

Retrieve the top 50 agents matching the query filters Parameters:
ParameterTypeRequiredDefaultDescription
sessionFilterobjectNosessionFilter
sessionOrderstringNoSearch session order direction; default to asc
sessionOrderBystringNoSearch session order dimension names; default to segmentStart
userFilterobjectNouserFilter
userOrderstringNoSearch user order direction; default to asc
userOrderBystringNoSearch user order dimension names; default to userName

genesys_analytics_post_analytics_agents_status_counts

Count agents by different groupings Parameters:
ParameterTypeRequiredDefaultDescription
groupByany[]NoInclude to choose which groupings to count by and return. If not included it will return only counts grouped by segmentType
sessionFilterobjectNosessionFilter
userFilterobjectNouserFilter

genesys_analytics_post_analytics_agents_status_query

Retrieve the top 50 agents matching the query filters Parameters:
ParameterTypeRequiredDefaultDescription
sessionFilterobjectNosessionFilter
sessionOrderstringNoSearch session order direction; default to asc
sessionOrderBystringNoSearch session order dimension names; default to segmentStart
userFilterobjectNouserFilter
userOrderstringNoSearch user order direction; default to asc
userOrderBystringNoSearch user order dimension names; default to userName

genesys_analytics_post_analytics_conversations_activity_query

Query for conversation activity observations Parameters:
ParameterTypeRequiredDefaultDescription
pageSizeintegerNoThe desired page size
pageNumberintegerNoThe desired page number
filterobjectNofilter
groupByany[]YesDimension(s) to group by
metricsany[]YesList of requested metrics
orderstringNoSort the result set in ascending/descending order. Default is ascending

genesys_analytics_post_analytics_evaluations_aggregates_query

Query for evaluation aggregates Parameters:
ParameterTypeRequiredDefaultDescription
alternateTimeDimensionstringNoDimension to use as the alternative timestamp for data in the aggregate. Choosing “eventTime” uses the actual time of the data event.
filterobjectNofilter
flattenMultivaluedDimensionsbooleanNoFlattens any multivalued dimensions used in response groups (e.g. [‘a’,‘b’,‘c’]->‘a,b,c’)
granularitystringNoGranularity aggregates metrics into subpartitions within the time interval specified. The default granularity is the same duration as the interval. Periods are represented as an ISO-8601 string. For example: P1D or P1DT12H
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
viewsany[]NoCustom derived metric views

genesys_analytics_post_analytics_surveys_aggregates_query

Query for survey aggregates Parameters:
ParameterTypeRequiredDefaultDescription
alternateTimeDimensionstringNoDimension to use as the alternative timestamp for data in the aggregate. Choosing “eventTime” uses the actual time of the data event.
filterobjectNofilter
flattenMultivaluedDimensionsbooleanNoFlattens any multivalued dimensions used in response groups (e.g. [‘a’,‘b’,‘c’]->‘a,b,c’)
granularitystringNoGranularity aggregates metrics into subpartitions within the time interval specified. The default granularity is the same duration as the interval. Periods are represented as an ISO-8601 string. For example: P1D or P1DT12H
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
viewsany[]NoCustom derived metric views

genesys_analytics_post_analytics_users_activity_query

Query for user activity observations Parameters:
ParameterTypeRequiredDefaultDescription
pageSizeintegerNoThe desired page size
pageNumberintegerNoThe desired page number
filterobjectNofilter
groupByany[]YesDimension(s) to group by
metricsany[]YesList of requested metrics
orderstringNoSort the result set in ascending/descending order. Default is ascending

genesys_analytics_post_analytics_users_aggregates_query

Query for user aggregates Parameters:
ParameterTypeRequiredDefaultDescription
alternateTimeDimensionstringNoDimension to use as the alternative timestamp for data in the aggregate. Choosing “eventTime” uses the actual time of the data event.
filterobjectNofilter
flattenMultivaluedDimensionsbooleanNoFlattens any multivalued dimensions used in response groups (e.g. [‘a’,‘b’,‘c’]->‘a,b,c’)
granularitystringNoGranularity aggregates metrics into subpartitions within the time interval specified. The default granularity is the same duration as the interval. Periods are represented as an ISO-8601 string. For example: P1D or P1DT12H
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
viewsany[]NoCustom derived metric views

genesys_analytics_post_analytics_users_details_query

Query for user details Parameters:
ParameterTypeRequiredDefaultDescription
intervalstringYesSpecifies the date and time range of data being queried. Conversations MUST have started within this time range to potentially be included within the result set. Intervals are represented as an ISO-8601 string. For example: YYYY-MM-DDThh:mm:ss/YYYY-MM-DDThh:mm:ss
orderstringNoSort the result set in ascending/descending order. Default is ascending
pagingobjectNopaging
presenceAggregationsany[]NoInclude faceted search and aggregate roll-ups of presence data in your search results. This does not function as a filter, but rather, summary data about the presence results matching your filters
presenceFiltersany[]NoFilters that target system and organization presence-level data
routingStatusAggregationsany[]NoInclude faceted search and aggregate roll-ups of agent routing status data in your search results. This does not function as a filter, but rather, summary data about the agent routing status results matching your filters
routingStatusFiltersany[]NoFilters that target agent routing status-level data
userFiltersany[]NoFilters that target the users to retrieve data for

genesys_analytics_post_analytics_users_observations_query

Query for user observations Parameters:
ParameterTypeRequiredDefaultDescription
detailMetricsany[]NoMetrics for which to include additional detailed observations
filterobjectYesfilter
metricsany[]YesBehaves like a SQL SELECT clause. Only named metrics will be retrieved.

genesys_analytics_post_bots_aggregates_query

Query for bot aggregates Parameters:
ParameterTypeRequiredDefaultDescription
alternateTimeDimensionstringNoDimension to use as the alternative timestamp for data in the aggregate. Choosing “eventTime” uses the actual time of the data event.
filterobjectNofilter
flattenMultivaluedDimensionsbooleanNoFlattens any multivalued dimensions used in response groups (e.g. [‘a’,‘b’,‘c’]->‘a,b,c’)
granularitystringNoGranularity aggregates metrics into subpartitions within the time interval specified. The default granularity is the same duration as the interval. Periods are represented as an ISO-8601 string. For example: P1D or P1DT12H
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
viewsany[]NoCustom derived metric views

genesys_analytics_post_conversation_details_properties

Index conversation properties Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId
propertiesany[]YesThe list of properties to index
sessionIdstringYesAttach properties to a segment in the indicated session
targetDatestringYesAttach properties to a segment covering a specific point in time. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z

genesys_analytics_post_conversations_details_jobs

Query for conversation details asynchronously Parameters:
ParameterTypeRequiredDefaultDescription
conversationFiltersany[]NoFilters that target conversation-level data
evaluationFiltersany[]NoFilters that target evaluations
intervalstringYesSpecifies the date and time range of data being queried. Results will include all conversations that had activity during the interval. Intervals are represented as an ISO-8601 string. For example: YYYY-MM-DDThh:mm:ss/YYYY-MM-DDThh:mm:ss
limitintegerNoSpecify number of results to be returned
orderstringNoSort the result set in ascending/descending order. Default is ascending
orderBystringNoSpecify which data element within the result set to use for sorting. The options to use as a basis for sorting the results: conversationStart, segmentStart, and segmentEnd. If not specified, the default is conversationStart
resolutionFiltersany[]NoFilters that target resolutions
segmentFiltersany[]NoFilters that target individual segments within a conversation
startOfDayIntervalMatchingbooleanNoAdd a filter to only include conversations that started after the beginning of the interval start date (UTC)
surveyFiltersany[]NoFilters that target surveys

genesys_analytics_post_evaluations_aggregates_query

Query for evaluation aggregates Parameters:
ParameterTypeRequiredDefaultDescription
alternateTimeDimensionstringNoDimension to use as the alternative timestamp for data in the aggregate. Choosing “eventTime” uses the actual time of the data event.
filterobjectNofilter
flattenMultivaluedDimensionsbooleanNoFlattens any multivalued dimensions used in response groups (e.g. [‘a’,‘b’,‘c’]->‘a,b,c’)
granularitystringNoGranularity aggregates metrics into subpartitions within the time interval specified. The default granularity is the same duration as the interval. Periods are represented as an ISO-8601 string. For example: P1D or P1DT12H
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
viewsany[]NoCustom derived metric views

genesys_analytics_post_flowexecutions_aggregates_query

Query for flow execution aggregates Parameters:
ParameterTypeRequiredDefaultDescription
alternateTimeDimensionstringNoDimension to use as the alternative timestamp for data in the aggregate. Choosing “eventTime” uses the actual time of the data event.
filterobjectNofilter
flattenMultivaluedDimensionsbooleanNoFlattens any multivalued dimensions used in response groups (e.g. [‘a’,‘b’,‘c’]->‘a,b,c’)
granularitystringNoGranularity aggregates metrics into subpartitions within the time interval specified. The default granularity is the same duration as the interval. Periods are represented as an ISO-8601 string. For example: P1D or P1DT12H
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
viewsany[]NoCustom derived metric views

genesys_analytics_post_flows_activity_query

Query for flow activity observations Parameters:
ParameterTypeRequiredDefaultDescription
pageSizeintegerNoThe desired page size
pageNumberintegerNoThe desired page number
filterobjectNofilter
groupByany[]YesDimension(s) to group by
metricsany[]YesList of requested metrics
orderstringNoSort the result set in ascending/descending order. Default is ascending

genesys_analytics_post_flows_aggregates_query

Query for flow aggregates Parameters:
ParameterTypeRequiredDefaultDescription
alternateTimeDimensionstringNoDimension to use as the alternative timestamp for data in the aggregate. Choosing “eventTime” uses the actual time of the data event.
filterobjectNofilter
flattenMultivaluedDimensionsbooleanNoFlattens any multivalued dimensions used in response groups (e.g. [‘a’,‘b’,‘c’]->‘a,b,c’)
granularitystringNoGranularity aggregates metrics into subpartitions within the time interval specified. The default granularity is the same duration as the interval. Periods are represented as an ISO-8601 string. For example: P1D or P1DT12H
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
viewsany[]NoCustom derived metric views

genesys_analytics_post_flows_observations_query

Query for flow observations Parameters:
ParameterTypeRequiredDefaultDescription
detailMetricsany[]NoMetrics for which to include additional detailed observations
filterobjectYesfilter
metricsany[]YesBehaves like a SQL SELECT clause. Only named metrics will be retrieved.

genesys_analytics_post_journeys_aggregates_query

Query for journey aggregates Parameters:
ParameterTypeRequiredDefaultDescription
alternateTimeDimensionstringNoDimension to use as the alternative timestamp for data in the aggregate. Choosing “eventTime” uses the actual time of the data event.
filterobjectNofilter
flattenMultivaluedDimensionsbooleanNoFlattens any multivalued dimensions used in response groups (e.g. [‘a’,‘b’,‘c’]->‘a,b,c’)
granularitystringNoGranularity aggregates metrics into subpartitions within the time interval specified. The default granularity is the same duration as the interval. Periods are represented as an ISO-8601 string. For example: P1D or P1DT12H
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
viewsany[]NoCustom derived metric views

genesys_analytics_post_knowledge_aggregates_query

Query for knowledge aggregates Parameters:
ParameterTypeRequiredDefaultDescription
alternateTimeDimensionstringNoDimension to use as the alternative timestamp for data in the aggregate. Choosing “eventTime” uses the actual time of the data event.
filterobjectNofilter
flattenMultivaluedDimensionsbooleanNoFlattens any multivalued dimensions used in response groups (e.g. [‘a’,‘b’,‘c’]->‘a,b,c’)
granularitystringNoGranularity aggregates metrics into subpartitions within the time interval specified. The default granularity is the same duration as the interval. Periods are represented as an ISO-8601 string. For example: P1D or P1DT12H
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
limitintegerNoHow many results you want in an ordered list. Only applicable for topN/bottomN query type.
metricsany[]YesBehaves like a SQL SELECT clause. Only named metrics will be retrieved.
queryTypestringNoQuery type to use. Use groupBy for all matching results, and topN/bottomN for N results ordered by the sortMetric. Default is groupBy.
sortMetricobjectNosortMetric
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
viewsany[]NoCustom derived metric views

genesys_analytics_post_queues_observations_query

Query for queue observations Parameters:
ParameterTypeRequiredDefaultDescription
detailMetricsany[]NoMetrics for which to include additional detailed observations
filterobjectYesfilter
metricsany[]YesBehaves like a SQL SELECT clause. Only named metrics will be retrieved.

genesys_analytics_post_ratelimits_aggregates_query

Query for limits rate limit aggregates. Data populated when limits reach 90% of the maximum. Not a source of truth for limits hit but a best effort estimate. Parameters:
ParameterTypeRequiredDefaultDescription
alternateTimeDimensionstringNoDimension to use as the alternative timestamp for data in the aggregate. Choosing “eventTime” uses the actual time of the data event.
filterobjectNofilter
flattenMultivaluedDimensionsbooleanNoFlattens any multivalued dimensions used in response groups (e.g. [‘a’,‘b’,‘c’]->‘a,b,c’)
granularitystringNoGranularity aggregates metrics into subpartitions within the time interval specified. The default granularity is the same duration as the interval. Periods are represented as an ISO-8601 string. For example: P1D or P1DT12H
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
viewsany[]NoCustom derived metric views

genesys_analytics_post_resolutions_aggregates_query

Query for resolution aggregates Parameters:
ParameterTypeRequiredDefaultDescription
alternateTimeDimensionstringNoDimension to use as the alternative timestamp for data in the aggregate. Choosing “eventTime” uses the actual time of the data event and choosing “wrapUpDate” uses the date when conversation is ended
filterobjectNofilter
flattenMultivaluedDimensionsbooleanNoFlattens any multivalued dimensions used in response groups (e.g. [‘a’,‘b’,‘c’]->‘a,b,c’)
granularitystringNoGranularity aggregates metrics into subpartitions within the time interval specified. The default granularity is the same duration as the interval. Periods are represented as an ISO-8601 string. For example: P1D or P1DT12H
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
viewsany[]NoCustom derived metric views

genesys_analytics_post_routing_activity_query

Query for user activity observations Parameters:
ParameterTypeRequiredDefaultDescription
pageSizeintegerNoThe desired page size
pageNumberintegerNoThe desired page number
filterobjectNofilter
groupByany[]YesDimension(s) to group by
metricsany[]YesList of requested metrics
orderstringNoSort the result set in ascending/descending order. Default is ascending

genesys_analytics_post_summaries_aggregates_query

Query for summary aggregates Parameters:
ParameterTypeRequiredDefaultDescription
alternateTimeDimensionstringNoDimension to use as the alternative timestamp for data in the aggregate. Choosing “eventTime” uses the actual time of the data event.
filterobjectNofilter
flattenMultivaluedDimensionsbooleanNoFlattens any multivalued dimensions used in response groups (e.g. [‘a’,‘b’,‘c’]->‘a,b,c’)
granularitystringNoGranularity aggregates metrics into subpartitions within the time interval specified. The default granularity is the same duration as the interval. Periods are represented as an ISO-8601 string. For example: P1D or P1DT12H
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
limitintegerNoHow many results you want in an ordered list. Only applicable for topN/bottomN query type.
metricsany[]YesBehaves like a SQL SELECT clause. Only named metrics will be retrieved.
queryTypestringNoQuery type to use. Use groupBy for all matching results, and topN/bottomN for N results ordered by the sortMetric. Default is groupBy.
sortMetricobjectNosortMetric
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
viewsany[]NoCustom derived metric views

genesys_analytics_post_surveys_aggregates_query

Query for survey aggregates Parameters:
ParameterTypeRequiredDefaultDescription
alternateTimeDimensionstringNoDimension to use as the alternative timestamp for data in the aggregate. Choosing “eventTime” uses the actual time of the data event.
filterobjectNofilter
flattenMultivaluedDimensionsbooleanNoFlattens any multivalued dimensions used in response groups (e.g. [‘a’,‘b’,‘c’]->‘a,b,c’)
granularitystringNoGranularity aggregates metrics into subpartitions within the time interval specified. The default granularity is the same duration as the interval. Periods are represented as an ISO-8601 string. For example: P1D or P1DT12H
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
viewsany[]NoCustom derived metric views

genesys_analytics_post_taskmanagement_aggregates_query

Query for task management aggregates Parameters:
ParameterTypeRequiredDefaultDescription
alternateTimeDimensionstringNoDimension to use as the alternative timestamp for data in the aggregate. Choosing “eventTime” uses the actual time of the data event.
filterobjectNofilter
flattenMultivaluedDimensionsbooleanNoFlattens any multivalued dimensions used in response groups (e.g. [‘a’,‘b’,‘c’]->‘a,b,c’)
granularitystringNoGranularity aggregates metrics into subpartitions within the time interval specified. The default granularity is the same duration as the interval. Periods are represented as an ISO-8601 string. For example: P1D or P1DT12H
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
viewsany[]NoCustom derived metric views

genesys_analytics_post_teams_activity_query

Query for team activity observations Parameters:
ParameterTypeRequiredDefaultDescription
pageSizeintegerNoThe desired page size
pageNumberintegerNoThe desired page number
filterobjectNofilter
groupByany[]YesDimension(s) to group by
metricsany[]YesList of requested metrics
orderstringNoSort the result set in ascending/descending order. Default is ascending

genesys_analytics_post_transcripts_aggregates_query

Query for transcript aggregates Parameters:
ParameterTypeRequiredDefaultDescription
alternateTimeDimensionstringNoDimension to use as the alternative timestamp for data in the aggregate. Choosing “eventTime” uses the actual time of the data event.
filterobjectNofilter
flattenMultivaluedDimensionsbooleanNoFlattens any multivalued dimensions used in response groups (e.g. [‘a’,‘b’,‘c’]->‘a,b,c’)
granularitystringNoGranularity aggregates metrics into subpartitions within the time interval specified. The default granularity is the same duration as the interval. Periods are represented as an ISO-8601 string. For example: P1D or P1DT12H
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
viewsany[]NoCustom derived metric views

genesys_analytics_post_users_activity_query

Query for user activity observations Parameters:
ParameterTypeRequiredDefaultDescription
pageSizeintegerNoThe desired page size
pageNumberintegerNoThe desired page number
filterobjectNofilter
groupByany[]YesDimension(s) to group by
metricsany[]YesList of requested metrics
orderstringNoSort the result set in ascending/descending order. Default is ascending

genesys_analytics_post_users_aggregates_query

Query for user aggregates Parameters:
ParameterTypeRequiredDefaultDescription
alternateTimeDimensionstringNoDimension to use as the alternative timestamp for data in the aggregate. Choosing “eventTime” uses the actual time of the data event.
filterobjectNofilter
flattenMultivaluedDimensionsbooleanNoFlattens any multivalued dimensions used in response groups (e.g. [‘a’,‘b’,‘c’]->‘a,b,c’)
granularitystringNoGranularity aggregates metrics into subpartitions within the time interval specified. The default granularity is the same duration as the interval. Periods are represented as an ISO-8601 string. For example: P1D or P1DT12H
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
viewsany[]NoCustom derived metric views

genesys_analytics_post_users_details_jobs

Query for user details asynchronously Parameters:
ParameterTypeRequiredDefaultDescription
intervalstringYesSpecifies the date and time range of data being queried. Conversations MUST have started within this time range to potentially be included within the result set. Intervals are represented as an ISO-8601 string. For example: YYYY-MM-DDThh:mm:ss/YYYY-MM-DDThh:mm:ss
limitintegerNoSpecify number of results to be returned
orderstringNoSort the result set in ascending/descending order. Default is ascending
presenceFiltersany[]NoFilters that target system and organization presence-level data
routingStatusFiltersany[]NoFilters that target agent routing status-level data
userFiltersany[]NoFilters that target the users to retrieve data for

genesys_analytics_post_users_details_query

Query for user details Parameters:
ParameterTypeRequiredDefaultDescription
intervalstringYesSpecifies the date and time range of data being queried. Conversations MUST have started within this time range to potentially be included within the result set. Intervals are represented as an ISO-8601 string. For example: YYYY-MM-DDThh:mm:ss/YYYY-MM-DDThh:mm:ss
orderstringNoSort the result set in ascending/descending order. Default is ascending
pagingobjectNopaging
presenceAggregationsany[]NoInclude faceted search and aggregate roll-ups of presence data in your search results. This does not function as a filter, but rather, summary data about the presence results matching your filters
presenceFiltersany[]NoFilters that target system and organization presence-level data
routingStatusAggregationsany[]NoInclude faceted search and aggregate roll-ups of agent routing status data in your search results. This does not function as a filter, but rather, summary data about the agent routing status results matching your filters
routingStatusFiltersany[]NoFilters that target agent routing status-level data
userFiltersany[]NoFilters that target the users to retrieve data for

genesys_analytics_post_users_observations_query

Query for user observations Parameters:
ParameterTypeRequiredDefaultDescription
detailMetricsany[]NoMetrics for which to include additional detailed observations
filterobjectYesfilter
metricsany[]YesBehaves like a SQL SELECT clause. Only named metrics will be retrieved.