BaleMessenger icon

BaleMessenger

Interact with Bale Messenger API
Join our community

Actions32

Overview

The node integrates with the Bale Messenger API to send various types of messages and perform chat-related actions. Specifically, for the Message resource and Send Video operation, it allows sending video files to a specified chat in Bale Messenger.

This node is useful when automating communication workflows that involve sharing video content directly within chats on Bale Messenger. For example, businesses can use it to send promotional videos, tutorials, or updates to customers or groups automatically.

Practical examples:

  • Sending a recorded product demo video to a customer support group.
  • Sharing event highlight videos in a community chat.
  • Automatically delivering personalized video messages based on user interactions.

Properties

Name Meaning
Chat ID Unique identifier for the target chat where the video will be sent.
Binary Data Boolean flag indicating whether the video data should be taken from a binary field (uploaded file) or referenced by an existing file ID on Bale servers.
Binary Property The name of the binary property containing the video data to upload if Binary Data is true.
File ID Identifier of a video file already stored on Bale servers to send without uploading new data (used if Binary Data is false).
Caption Optional text caption to accompany the video message (0-1024 characters).
Reply Markup Additional interface options for the message, such as inline keyboards or custom reply keyboards. Options include: Inline Keyboard, None, Reply Keyboard, Reply Keyboard Remove.
Inline Keyboard Configuration for an inline keyboard attached to the message, consisting of rows and buttons with customizable text, callback data, or URLs.
Reply Keyboard Configuration for a custom reply keyboard with rows of buttons that users can tap to send predefined replies.
Reply Keyboard Remove Option to remove any custom reply keyboard from the client interface, with settings to selectively apply removal.
Reply To Message ID If the video message is a reply, this is the ID of the original message being replied to.
File Name Optional filename for the uploaded video file (used when uploading binary data).

Output

The output JSON contains the response from the Bale Messenger API after sending the video message. It typically includes details about the sent message such as message ID, chat ID, and other metadata returned by the API.

No binary output is produced by this operation.

Example output structure (simplified):

{
  "message_id": 12345,
  "chat_id": "987654321",
  "video": {
    "file_id": "abc123def456",
    "width": 640,
    "height": 480,
    "duration": 30
  },
  "caption": "Optional caption text"
}

Dependencies

  • Requires an active Bale Messenger API token credential configured in n8n.
  • Uses the official Bale Messenger Bot API endpoint (https://tapi.bale.ai/bot).
  • Supports sending video either by uploading binary data or referencing an existing file ID on Bale servers.

Troubleshooting

  • Invalid Chat ID: Ensure the Chat ID is correct and the bot has permission to send messages to that chat.
  • File Upload Issues: When using binary data, verify the binary property name matches the uploaded file's property and that the file format is supported.
  • Caption Length: Captions must not exceed 1024 characters; exceeding this may cause errors.
  • Reply Markup Misconfiguration: Incorrectly structured inline or reply keyboards can cause API errors. Validate button configurations carefully.
  • API Authentication Errors: Confirm the API token credential is valid and has necessary permissions.
  • Network or API Downtime: Temporary failures communicating with Bale Messenger API may occur; retrying later might resolve these issues.

Common error messages usually include descriptive API responses which can help identify the problem, such as invalid parameters or unauthorized access.

Links and References

Discussion