Rahsaz Telegram icon

Rahsaz Telegram

Sends data to Telegram

Overview

The node integrates with Telegram to perform various chat-related actions. Specifically, the Chat - Set Title operation allows users to update the title of a Telegram chat or channel. This is useful for managing group chats or channels where the title needs to be changed dynamically based on workflow events or administrative decisions.

Common scenarios include:

  • Automatically renaming a group chat after an event or milestone.
  • Updating channel titles to reflect current topics or campaigns.
  • Managing multiple chats programmatically without manual intervention.

Example: A marketing automation workflow could rename a Telegram channel to match the current campaign name whenever a new campaign starts.

Properties

Name Meaning
Chat ID Unique identifier for the target chat or username of the target channel (format: @channelusername). Required to specify which chat's title will be set.
Title New chat title string, between 1 and 255 characters. The updated title to assign to the chat.
Reply Keyboard (Optional) Adds a custom reply keyboard with buttons for user interaction in the chat.
Reply Keyboard Options Options to customize the reply keyboard behavior such as resizing, one-time display, and selective visibility.
Reply Keyboard Remove Options to remove a custom keyboard from the chat interface, including selective removal.

Note: For the Set Title operation, only Chat ID and Title are required and relevant. The reply keyboard options are part of the broader node properties but not specifically used in this operation.

Output

The node outputs JSON data representing the result returned by the Telegram API for the setChatTitle method. Typically, this includes a boolean indicating success or failure.

Output structure example:

{
  "ok": true,
  "result": true
}
  • ok: Indicates if the request was successful.
  • result: Usually true if the title was successfully set.

No binary data output is associated with this operation.

Dependencies

  • Requires a valid Telegram Bot API key credential configured in n8n.
  • The node makes HTTP POST requests to Telegram’s Bot API endpoints.
  • No additional external services are needed beyond Telegram.

Troubleshooting

  • Invalid Chat ID: If the provided chat ID or channel username is incorrect or the bot lacks access, the API will return an error. Verify the chat identifier and ensure the bot is a member/admin of the chat.
  • Title Length Errors: Titles must be between 1 and 255 characters. Providing an empty or overly long title will cause the API to reject the request.
  • Permission Issues: The bot must have appropriate permissions to change the chat title. Lack of admin rights will result in errors.
  • API Rate Limits: Frequent changes may hit Telegram rate limits; handle errors gracefully and consider retry logic.
  • Missing Required Parameters: Ensure both Chat ID and Title are provided; otherwise, the node will throw an error.

Links and References

Discussion