Public/New-GCConversationsEmailMessage.ps1

<#
.SYNOPSIS
    Sends an email message within an email conversation.

.DESCRIPTION
    Creates and sends a new email message (reply) within an existing email conversation.
    Calls POST /api/v2/conversations/emails/{conversationId}/messages.

.PARAMETER ConversationId
    The unique identifier of the email conversation.

.PARAMETER Body
    The request body containing the email message details (to, subject, body, etc.).

.EXAMPLE
    $emailMsg = @{
        to = @(@{ email = 'customer@example.com' })
        subject = 'Re: Your inquiry'
        textBody = 'Thank you for contacting us.'
    }
    New-GCConversationsEmailMessage -ConversationId 'conv-id' -Body $emailMsg

.NOTES
    Genesys Cloud API: POST /api/v2/conversations/emails/{conversationId}/messages
#>

function New-GCConversationsEmailMessage {
    [CmdletBinding()]
    param(
        [Parameter(Mandatory = $true)]
        [string]$ConversationId,

        [Parameter(Mandatory = $true)]
        [object]$Body
    )

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