Public/New-GCConversationsMessage.ps1

<#
.SYNOPSIS
    Creates a new message conversation.

.DESCRIPTION
    Initiates a new messaging conversation in Genesys Cloud (e.g., SMS, WhatsApp, Open messaging).
    Calls POST /api/v2/conversations/messages.

.PARAMETER Body
    The request body containing message details such as to address, messaging integration, and content.

.EXAMPLE
    $messageBody = @{
        toAddress = '+15551234567'
        toAddressMessengerType = 'sms'
        useExistingConversation = $false
    }
    New-GCConversationsMessage -Body $messageBody

.NOTES
    Genesys Cloud API: POST /api/v2/conversations/messages
#>

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

    $endpoint = "conversations/messages"
    return Invoke-GCApiRequest -Endpoint $endpoint -Method POST -Body $Body
}