BaleMessenger icon

BaleMessenger

Interact with Bale Messenger API

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 Sticker operation, it allows sending a sticker message to a specified chat in Bale Messenger.

This is useful when you want to automate sending stickers as part of your chatbot or messaging workflow, enhancing user engagement with expressive content beyond plain text.

Example use cases:

  • Sending a welcome sticker automatically when a user joins a chat.
  • Responding with a sticker reaction based on user input or events.
  • Broadcasting promotional or themed stickers during campaigns.

Properties

Name Meaning
Chat ID Unique identifier for the target chat where the sticker will be sent.
Sticker ID Identifier of the sticker to send. This should be a file ID referencing a sticker already on Bale servers (recommended).
Reply To Message ID If replying to an existing message, this is the ID of that original message.

Additional properties related to keyboard markup or binary data are available but not applicable specifically to the Send Sticker operation unless binary data upload is involved (not shown here).

Output

The output JSON contains the response from the Bale Messenger API after sending the sticker. It typically includes details about the sent message such as message ID, chat ID, date, and sticker information confirming successful delivery.

No binary data output is produced by this operation.

Dependencies

  • Requires an active Bale Messenger API credential with a valid token configured in n8n.
  • Uses the official Bale Messenger Bot API endpoint https://tapi.bale.ai/bot.
  • The node depends on the node-telegram-bot-api library 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 in that chat.
  • Invalid Sticker ID: The sticker ID must reference a sticker already uploaded to Bale servers; otherwise, the API call will fail.
  • API Authentication Errors: Verify that the API token credential is valid and has not expired.
  • Network Issues: Check connectivity to https://tapi.bale.ai and ensure no firewall blocks outbound requests.
  • Reply To Message ID Errors: If specified, the message ID must exist in the chat; otherwise, the API may reject the request.

Common error messages returned by the API will include descriptive messages indicating the cause, which can be found in the node's execution logs.

Links and References


This summary focuses on the "Message" resource and "Send Sticker" operation as requested, based on static analysis of the provided source code and property definitions.

Discussion