Rahsaz Telegram icon

Rahsaz Telegram

Sends data to Telegram

Actions23

Overview

This node allows you to interact with Telegram chats by performing various chat-related operations. Specifically, the Set Description operation lets you update the description of a Telegram chat or channel. This is useful for managing group or channel metadata dynamically, such as updating the purpose or rules of a chat without manual intervention.

Common scenarios include:

  • Automatically updating a group description based on external data or events.
  • Managing multiple Telegram channels and keeping their descriptions current via automation.
  • Setting descriptive text for newly created groups or channels programmatically.

Example: You could use this node to set a new description for a Telegram group whenever a certain event occurs in your workflow, like publishing a new newsletter or launching a campaign.

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 description to update.
Description The new chat description text to set, limited to 0-255 characters.
Reply Keyboard (Optional) Adds a custom reply keyboard with buttons that users can tap. Useful for interactive chats.
Reply Keyboard Options Options to customize the reply keyboard behavior, including resizing, one-time display, and selective visibility.
Reply Keyboard Remove Options to remove a custom keyboard from the chat interface, optionally targeting specific users.

Note: For the Set Description operation, only Chat ID and Description are required. The reply keyboard options are part of the broader message sending capabilities but may be available depending on context.

Output

The node outputs JSON data representing the result returned by the Telegram API after setting the chat description. Typically, this includes a boolean success indicator or the updated chat object depending on the API response.

If the operation involves file downloads (not applicable here), binary data would be included. For Set Description, no binary output is expected.

Output example structure (simplified):

{
  "ok": true,
  "result": {
    // Updated chat information or confirmation
  }
}

Dependencies

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

Troubleshooting

  • Invalid Chat ID: If the 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 or admin of the chat.
  • Description Length Exceeded: The description must be between 0 and 255 characters. Longer descriptions will cause errors.
  • Permission Errors: The bot must have permission to change chat descriptions. Ensure it has appropriate admin rights.
  • Network Issues: Connectivity problems can cause request failures. Check network and API availability.
  • Missing Required Parameters: Both chatId and description are mandatory; missing either will cause the node to fail.

Links and References

This summary focuses on the Chat > Set Description operation as requested, describing its inputs, outputs, and usage context based on static analysis of the provided source code and property definitions.

Discussion