BaleMessenger icon

BaleMessenger

Interact with Bale Messenger API
Join our community

Actions32

Overview

The node enables sending a location message via the Bale Messenger API. It allows users to share geographic coordinates (latitude and longitude) along with optional horizontal accuracy information to a specified chat. This is useful in scenarios such as:

  • Sharing a meeting point or event location with a group.
  • Providing real-time location updates in customer support chats.
  • Sending location details for delivery or service requests.

For example, a user can configure the node to send the exact GPS coordinates of a restaurant to a chat group, helping all members find the place easily.

Properties

Name Meaning
Chat ID Unique identifier for the target chat where the location will be sent.
Reply Markup Additional interface options for the message's keyboard:
- Inline Keyboard
- None
- Reply Keyboard
- Reply Keyboard Remove
Inline Keyboard Defines rows and buttons for an inline keyboard that appears next to the message. Buttons can have text, callback data, or URLs.
Reply Keyboard Defines rows and buttons for a custom reply keyboard with text buttons.
Reply Keyboard Remove Options to remove the custom keyboard, including whether to remove it selectively for specific users.
Latitude The latitude coordinate of the location to send. Must be between -90 and 90.
Longitude The longitude coordinate of the location to send. Must be between -180 and 180.
Horizontal Accuracy Optional horizontal accuracy of the location in meters (0 to 1500).

Output

The output JSON contains the response from the Bale Messenger API after sending the location message. It typically includes details about the sent message such as message ID, chat ID, and the location data confirmed by the server.

No binary data is output by this operation.

Example output structure (simplified):

{
  "message_id": 123,
  "chat": {
    "id": "chatId",
    "type": "group"
  },
  "location": {
    "latitude": 35.6895,
    "longitude": 139.6917,
    "horizontal_accuracy": 10
  }
}

Dependencies

  • Requires an active Bale Messenger API authentication token configured in n8n credentials.
  • Uses the official Bale Messenger Bot API endpoint https://tapi.bale.ai/bot.
  • Relies on the node-telegram-bot-api library internally for API calls.

Troubleshooting

  • Invalid Chat ID: If the chat ID is incorrect or the bot is not a member of the chat, the API call will fail. Verify the chat ID and bot permissions.
  • Latitude/Longitude Out of Range: Ensure latitude is between -90 and 90, and longitude between -180 and 180. Values outside these ranges will cause errors.
  • Horizontal Accuracy Too High: The horizontal accuracy must be between 0 and 1500 meters; values outside this range may be rejected.
  • API Authentication Errors: If the API token is invalid or expired, the node will fail to send the location. Reconfigure the API credentials.
  • Reply Markup Misconfiguration: Incorrectly structured keyboards can cause the API to reject the message. Use the provided UI options carefully.

Common error messages usually include HTTP status codes and descriptive messages from the Bale API. Checking the node execution logs and ensuring correct parameter values usually resolves most issues.

Links and References

Discussion