Public/Invoke-GCAnalyticsConversationsAggregatesQuery.ps1

<#
.SYNOPSIS
    Queries conversation aggregate analytics.

.DESCRIPTION
    Executes an analytics query for conversation aggregate metrics in Genesys Cloud.
    Returns aggregated conversation data based on the provided query filters and metrics.
    Calls POST /api/v2/analytics/conversations/aggregates/query.

.PARAMETER Body
    The mandatory request body containing the analytics query definition including interval,
    granularity, groupBy, filter, and metrics.

.EXAMPLE
    $query = @{
        interval = '2024-01-01T00:00:00Z/2024-01-02T00:00:00Z'
        granularity = 'PT30M'
        metrics = @('nOffered', 'tAnswered', 'tAbandon')
    }
    Invoke-GCAnalyticsConversationsAggregatesQuery -Body $query

.NOTES
    Genesys Cloud API: POST /api/v2/analytics/conversations/aggregates/query
#>

function Invoke-GCAnalyticsConversationsAggregatesQuery {
    [CmdletBinding()]
    param(
        [Parameter(Mandatory = $true)]
        [object]$Body
    )

    $endpoint = "analytics/conversations/aggregates/query"
    return Invoke-GCApiRequest -Endpoint $endpoint -Method POST -Body $Body
}