BaleMessenger icon

BaleMessenger

Interact with Bale Messenger API

Actions32

Overview

The node interacts with the Bale Messenger API, specifically enabling operations related to stickers in this context. The "Create New Sticker Set" operation allows users to create a new sticker set associated with a user ID by uploading sticker image data and specifying a name and title for the set.

This node is beneficial when automating the management of sticker sets on Bale Messenger, such as creating custom sticker collections for bots or users programmatically. For example, a bot developer can use this node to dynamically create themed sticker sets based on user input or events.

Properties

Name Meaning
UserId Numeric identifier of the user who will own the new sticker set.
Name The short name of the new sticker set (used as an identifier).
Title The display title of the new sticker set shown to users.
Binary Property The name of the binary property containing the sticker image data to upload (e.g., "data").

Additionally, there are properties related to reply keyboards and keyboard removal, but these are not relevant for the "Create New Sticker Set" operation.

Output

The output JSON contains the response from the Bale Messenger API after attempting to create the new sticker set. This typically includes confirmation details about the created sticker set or error information if the creation failed.

No binary output is produced by this operation.

Example output structure (simplified):

{
  "ok": true,
  "result": {
    "user_id": 123456,
    "name": "sticker_set_name",
    "title": "Sticker Set Title"
  }
}

Dependencies

  • Requires an active Bale Messenger API credential with a valid token.
  • Uses the node-telegram-bot-api library configured to communicate with Bale Messenger's API endpoint.
  • Input binary data must be provided in a binary property (e.g., file content of the sticker image).

Troubleshooting

  • Missing or invalid binary data: Ensure that the binary property specified contains valid image data for the sticker. Without this, the upload will fail.
  • Invalid user ID or permissions: The user ID must be correct and authorized to create sticker sets. Errors may occur if the user does not have permission.
  • API errors: Network issues or incorrect API tokens will cause failures. Verify credentials and network connectivity.
  • Incorrect property names: Make sure the "Name" and "Title" fields are properly filled; empty or invalid values may cause the API to reject the request.

Common error messages include:

  • "Failed to create new sticker set": Indicates an issue during the API call, often due to invalid parameters or authentication failure.
  • "The binary property does not exist": Means the specified binary property was not found in the input data.

Resolving these usually involves verifying input data, credentials, and ensuring the API token has the necessary rights.

Links and References

Discussion