POST
/
api
/
external
/
get-interaction-aggregates

This endpoint returns aggregate values among interactions. The returned aggregates are:

  • number of interactions
  • number of users
  • number of positive implicit feedback
  • number of positive explicit feedback
  • number of negative implicit feedback
  • number of negative explicit feedback

Using the optional group by field you can aggregate the interaction on different view, e.g. grouping by “intent” or “positive_implicit_feedback”.

You need an API key to authenticate. See here for more information about the API keys.

time_range
object
required

The time range to consider when computing the metrics and analytics to show.

filters
object[]
required

Filters you can use to get data based only on the interactions you are interested in.

group_by
object

Filters you can use to get data based only on the interactions you are interested in. If no value is give, the total aggregated values among the desired interactions are returned.

variables
string[]

The variables for which values are required. If not specified, all available variables will be computed. The supported variables are

  • n_interactions
  • n_users
  • user_feedback
  • cost
  • latency_seconds
  • n_intents
  • retention
additional_group_bys
object[]

Optional additional group by filters. These group by filters can be used to further refine the aggregations, splitting the selected variables for the main group by into more detailed categories using the additional filters.

limit
integer
required

Parameter needed for pagination. It indicates the number of rows per page.

offset
integer
required

Parameter needed for pagination. It indicates the offset to be applied to the first rows returned.

Response

total
integer

Needed for pagination. The total number of rows available.

offset
integer

Needed for pagination. It indicates the offset to be applied to the first rows returned.

limit
integer

Needed for pagination. It indicates the number of rows per page.

data
object[]

The data aggregated using the given group_by field.