Actions32
- Bot Actions
- Callback Actions
- Chat Actions
- File Actions
- Message Actions
- Payment Actions
- Sticker Actions
Overview
The "Send Media Group" operation of the Message resource in this node allows sending a group (album) of photos or videos to a specified chat via the Bale Messenger API. This is useful when you want to send multiple media items together as a single message, such as photo albums or video collections.
Typical use cases include:
- Sharing event photo albums with a group.
- Sending multiple product images in one message.
- Broadcasting a set of related videos to a chat.
For example, you can send an album containing several photos and videos by specifying each media item’s type, source (file ID or URL), and optional captions.
Properties
| Name | Meaning |
|---|---|
| Chat ID | Unique identifier for the target chat where the media group will be sent. |
| Reply To Message ID | If the media group message is a reply, this is the ID of the original message to reply to. |
| Media | The collection of media items to send. Each media item includes: • Type: Either "Photo" or "Video". • Media File: A file ID referencing a file on Bale servers or an HTTP URL. • Additional Fields: – Caption: Text caption (0-1024 characters). – Parse Mode: How to parse the caption text ("Markdown (Legacy)", "MarkdownV2", or "HTML"). |
Output
The output JSON contains the response from the Bale Messenger API after sending the media group. It typically includes details about the sent message(s), such as message IDs and confirmation data.
No binary data output is produced by this operation.
Dependencies
- Requires an active Bale Messenger API credential with a valid token.
- Uses the official Bale Messenger API endpoint at
https://tapi.bale.ai/bot. - The node depends on the
node-telegram-bot-apilibrary adapted for Bale Messenger API calls. - No additional environment variables are required beyond the API credentials.
Troubleshooting
- Invalid Chat ID: Ensure the Chat ID is correct and the bot has permission to send messages to that chat.
- Invalid Media URLs or File IDs: Media files must either be valid Bale server file IDs or accessible HTTP URLs. Invalid references will cause failures.
- Caption Length Exceeded: Captions must be between 0 and 1024 characters; longer captions may cause errors.
- API Authentication Errors: Verify that the provided API token is valid and has not expired.
- Empty Media Array: At least one media item must be provided; sending an empty array will fail.
- Parse Mode Issues: Use only supported parse modes ("Markdown", "MarkdownV2", "HTML") for captions.
If the node throws errors related to the API request, check the error message for details and verify network connectivity and API token validity.
Links and References
- Bale Messenger Bot API Documentation (general reference for API methods)
- Telegram Bot API - sendMediaGroup method (similar concept, useful for understanding media group messaging)
This summary focuses exclusively on the "Send Media Group" operation of the Message resource as requested.