BaleMessenger icon

BaleMessenger

Interact with Bale Messenger API

Actions32

Overview

The "Send Chat Action" operation in the Message resource allows a bot to broadcast a chat action status to a target chat. This status indicates to the chat participants that the bot is performing an action such as typing, uploading a photo, recording voice, etc. The action status typically lasts for up to 5 seconds or until the bot sends a message.

This node is useful in scenarios where you want to provide real-time feedback to users that the bot is actively processing or preparing content. For example:

  • Showing "typing" when the bot is composing a reply.
  • Indicating "upload_photo" when the bot is about to send a photo.
  • Signaling "record_voice" if the bot is preparing a voice message.

Such feedback improves user experience by making interactions feel more natural and responsive.

Properties

Name Meaning
Chat ID Unique identifier for the target chat where the chat action will be broadcasted.
Action Type of chat action to broadcast. Options include:
- Record Video
- Record Voice
- Typing
- Upload Photo
- Upload Video
- Upload Voice
Choose one depending on what the user is about to receive.

Output

The output JSON contains a single field:

  • successful: A boolean indicating whether the chat action was successfully sent.

No binary data is output by this operation.

Example output JSON:

{
  "successful": true
}

Dependencies

  • Requires an API authentication token credential configured in n8n to access the Bale Messenger API.
  • Uses the Bale Messenger Bot API endpoint at https://tapi.bale.ai/bot.
  • Relies on the official Node Telegram Bot API client adapted for Bale Messenger.

Troubleshooting

  • Common issues:

    • Invalid or missing chat ID can cause failure to send the chat action.
    • Using an unsupported or misspelled action type may result in errors.
    • Expired or invalid API token will prevent successful requests.

  • Error messages:

    • Errors from the Bale Messenger API are logged and returned in the output's error fields if the request fails.
    • If the node throws an error related to credentials, verify that the API token is correctly set and has necessary permissions.

  • Resolution tips:

    • Double-check the chat ID format and ensure the bot has access to the chat.
    • Select the correct action type from the provided options.
    • Refresh or reconfigure the API authentication token if authorization errors occur.

Links and References

Discussion