Functions/Submit-SlackMessage.ps1

<#
.SYNOPSIS
    This function posts a message to a channel in Slack.
.DESCRIPTION
    This function posts a message to a channel in Slack.
    The scope required to call this function is "chat:write:user".
#>

function Submit-SlackMessage {
    [CmdletBinding(PositionalBinding=$false)]
    [OutputType([Bool])]
    param(
        # The authentication token for Slack
        [Parameter(Mandatory=$true)]
        [ValidateNotNullOrEmpty()]
        [String]$token,

        # The name of the channel
        [Parameter(Mandatory=$true)]
        [ValidateNotNullOrEmpty()]
        [String]$channelName,

        # The message to post
        [Parameter(Mandatory=$true)]
        [ValidateNotNullOrEmpty()]
        [String]$message
    )

    # Retrieve the ID for the specified channel and verify that the channel exists
    $channelID = (Get-SlackChannel -Token $token -ChannelName $channelName).id
    if (!$channelID) {
        throw "The channel '$($channelName)' cannot be found in Slack."
    }

    # Prepare the API call parameters
    $invokeRestMethodParams = @{
        Uri     = "https://slack.com/api/chat.postMessage"
        Method  = "POST"
        Headers = @{
            "Content-Type" = "application/json"
            Authorization  = "Bearer $($token)"
        }
        Body    = @{
            channel = "$($channelID)"
            text    = "$($message)"
        } | ConvertTo-Json
    }

    # Invoke the call
    $response = Invoke-RestMethod @invokeRestMethodParams

    # Verify that the message is post
    if ($response.ok) {
        return $true
    }
    else {
        throw "Failed to post message '$($message)' to channel '$($channelName)' with the error message:`r`n$($response.error)."
        return $false
    }
}