Actions23
- Chat Actions
- Callback Actions
- File Actions
- Message Actions
Overview
The "Send Location" operation of the Telegram node allows users to send a geographic location message to a specified chat in Telegram. This is useful for sharing precise latitude and longitude coordinates with individuals or groups directly through Telegram chats.
Common scenarios include:
- Sharing your current location with friends or family.
- Sending a meeting point or event location in group chats.
- Automating location-based notifications or alerts via Telegram bots.
For example, a delivery service could automatically send the real-time location of a courier to a customer using this node.
Properties
| Name | Meaning |
|---|---|
| Chat ID | Unique identifier for the target chat or username of the target channel (e.g., @channelusername). |
| 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. |
| Reply Markup | Additional interface options for the message. Options: Force Reply, Inline Keyboard, None, Reply Keyboard, Reply Keyboard Remove. |
| Force Reply | When selected, forces the user to reply to the message. Includes options to restrict to specific users. |
| Inline Keyboard | Adds an inline keyboard next to the message with customizable rows and buttons. Buttons can have text, callback data, URLs, payment options, and inline query switches. |
| Reply Keyboard | Adds a custom reply keyboard with rows of buttons that can request contact or location from the user. |
| Reply Keyboard Options | Options for the reply keyboard such as resizing, one-time display, and selective visibility. |
| Reply Keyboard Remove | Option to remove the custom keyboard, optionally selectively for specific users. |
| Additional Fields | Extra optional parameters such as disabling notification, parsing mode, replying to a message, message thread ID, and appending n8n attribution. |
Output
The node outputs JSON data representing the response from the Telegram API after sending the location message. This typically includes details about the sent message such as message ID, chat information, date, and location data.
If binary data were involved (not applicable for sending location), it would be included in the binary output field, but for this operation, no binary output is expected.
Dependencies
- Requires a valid Telegram Bot API key credential configured in n8n.
- The node makes HTTP POST requests to the Telegram Bot API endpoints.
- No additional external services are required beyond Telegram itself.
Troubleshooting
- Invalid Chat ID: If the chat ID or channel username is incorrect or the bot is not a member of the chat, the API will return an error. Verify the chat ID and ensure the bot has access.
- Latitude/Longitude out of range: Coordinates must be within valid ranges (-90 to 90 for latitude, -180 to 180 for longitude). Invalid values will cause errors.
- Missing Required Parameters: Ensure that Chat ID, Latitude, and Longitude are provided; otherwise, the request will fail.
- Reply Markup Misconfiguration: Incorrectly structured reply markup options may cause the API to reject the message. Validate the structure of keyboards and buttons.
- API Rate Limits: Sending too many messages in a short time may trigger rate limits from Telegram. Implement delays or error handling accordingly.