Send-TelegramMediaGroup¶
SYNOPSIS¶
Sends Telegram a group of photos, videos, documents, or audios as an album via Bot API from locally sourced media
SYNTAX¶
Send-TelegramMediaGroup [-BotToken] <String> [-ChatID] <String> [-MediaType] <String> [[-FilePaths] <String[]>]
[-DisableNotification] [-ProtectContent] [<CommonParameters>]
DESCRIPTION¶
Uses Telegram Bot API to send a group of photos, videos, documents, or audios as an album message to specified Telegram chat. The media will be sourced from the local device and uploaded to telegram. This function only supports sending one media type per send (Photo | Video | Documents | Audio). 2 files minimum and 10 files maximum are required for this function.
EXAMPLES¶
EXAMPLE 1¶
$botToken = 'nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx'
$chatID = '-nnnnnnnnn'
$sendTelegramMediaGroupSplat = @{
BotToken = $botToken
ChatID = $chatID
MediaType = 'Photo'
FilePaths = 'C:\photo\photo1.jpg', 'C:\photo\photo2.jpg'
}
Send-TelegramMediaGroup @sendTelegramMediaGroupSplat
Uploads all provided photo files as album via Telegram Bot API.
EXAMPLE 2¶
$botToken = 'nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx'
$chatID = '-nnnnnnnnn'
$sendTelegramMediaGroupSplat = @{
BotToken = $botToken
ChatID = $chatID
MediaType = 'Photo'
FilePaths = (Get-ChildItem C:\PhotoGroup | Select-Object -ExpandProperty FullName)
}
Send-TelegramMediaGroup @sendTelegramMediaGroupSplat
Retrieves all photo file paths from C:\PhotoGroup and uploads as photo album. Keep in mind that your location must have at least 2, but not more than 10 files.
EXAMPLE 3¶
$botToken = 'nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx'
$chatID = '-nnnnnnnnn'
$vPath = 'C:\VideoGroup'
$vFiles = @(
"$vPath\first_contact.mp4",
"$vPath\root_beer.mp4"
)
$sendTelegramMediaGroupSplat = @{
BotToken = $botToken
ChatID = $chatID
MediaType = 'Video'
FilePaths = $vFiles
DisableNotification = $true
ProtectContent = $true
}
Send-TelegramMediaGroup @sendTelegramMediaGroupSplat
Uploads all provided video files as album via Telegram Bot API.
PARAMETERS¶
-BotToken¶
Use this token to access the HTTP API
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ChatID¶
Unique identifier for the target chat
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-MediaType¶
Type of media to send
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 3
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-FilePaths¶
List of filepaths for media you want to send
Type: String[]
Parameter Sets: (All)
Aliases:
Required: False
Position: 4
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableNotification¶
Send the message silently. Users will receive a notification with no sound.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-ProtectContent¶
Protects the contents of the sent message from forwarding and saving
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters¶
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS¶
OUTPUTS¶
System.Management.Automation.PSCustomObject¶
NOTES¶
Author: Jake Morrison - @jakemorrison - https://www.techthoughts.info/ This works with PowerShell Version: 6.1+
The following photo types are supported: JPG, JPEG, PNG, GIF, BMP, WEBP, SVG, TIFF
The following video types are supported: Telegram clients support mp4 videos
The following audio types are supported: MP3, M4A
Questions on how to set up a bot, get a token, or get your channel ID? Answers on the PoshGram documentation: https://poshgram.readthedocs.io/en/latest/PoshGram-FAQ/
? This was really hard to make.
RELATED LINKS¶
https://poshgram.readthedocs.io/en/latest/Send-TelegramMediaGroup