Public/Invoke-GCAnalyticsFlowsObservationsQuery.ps1

<#
.SYNOPSIS
    Queries flow observation analytics.

.DESCRIPTION
    Executes an analytics query for flow observation metrics in Genesys Cloud.
    Returns real-time flow observation data such as active flows and waiting counts.
    Calls POST /api/v2/analytics/flows/observations/query.

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

.EXAMPLE
    $query = @{
        filter = @{
            type = 'or'
            predicates = @(
                @{ dimension = 'flowId'; value = 'flow-id-here' }
            )
        }
        metrics = @('oFlow')
    }
    Invoke-GCAnalyticsFlowsObservationsQuery -Body $query

.NOTES
    Genesys Cloud API: POST /api/v2/analytics/flows/observations/query
#>

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

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