Actions72
- Messages Actions
- Bots Actions
- Updates Actions
- Chats Actions
- Get Chat
- Get Chat Administrators
- Get Chat Member
- Get Chat Member Count
- Leave Chat
- Set Chat Title
- Set Chat Description
- Set Chat Photo
- Delete Chat Photo
- Set Chat Permissions
- Export Chat Invite Link
- Create Chat Invite Link
- Edit Chat Invite Link
- Revoke Chat Invite Link
- Approve Chat Join Request
- Decline Chat Join Request
- Set Chat Administrator Custom Title
- Ban Chat Member
- Unban Chat Member
- Restrict Chat Member
- Promote Chat Member
- Set Chat Sticker Set
- Delete Chat Sticker Set
- Pin Chat Message
- Unpin Chat Message
- Unpin All Chat Messages
- Files Actions
- Inline Queries Actions
- Callback Queries Actions
Overview
This node integrates with the Telegram Bot API to perform various chat-related operations. Specifically, for the "Chats" resource and the "Set Chat Description" operation, it allows users to update the description of a Telegram chat by specifying the chat ID and the new description text.
This functionality is useful in scenarios where you want to programmatically manage Telegram group or channel descriptions as part of an automated workflow. For example, you could update a chat description to reflect current events, announcements, or status updates without manual intervention.
Properties
| Name | Meaning |
|---|---|
| Chat ID | The unique identifier for the Telegram chat whose description will be set. This is required. |
| Options | Additional options as a JSON object (optional). |
Output
The node outputs a JSON object representing the response from the Telegram Bot API after attempting to set the chat description. This typically includes confirmation of success or details about the updated chat. If the operation fails, the output may contain an error message.
No binary data output is involved in this operation.
Dependencies
- Requires an active Telegram Bot API token configured as credentials in n8n.
- Requires access to the "N8N Tools API" service with a valid subscription and API key for validation before executing Telegram API calls.
- The node uses HTTP requests to communicate with both the N8N Tools API and the Telegram Bot API endpoints.
Troubleshooting
- Invalid Subscription or API Key: If the node throws an error indicating invalid subscription or API key, verify that your API key credential for the N8N Tools API is correct and active.
- Unknown Operation Error: If the operation name is incorrect or unsupported, the node will throw an "Unknown operation" error. Ensure the operation is exactly "setChatDescription" when using the Chats resource.
- Missing Required Parameters: The "Chat ID" must be provided; otherwise, the Telegram API call will fail.
- API Rate Limits or Telegram Errors: Telegram may return errors if the bot lacks permissions or if rate limits are exceeded. Check the Telegram Bot API documentation for error codes and remedies.
Links and References
- Telegram Bot API - setChatDescription
- n8n Documentation - Creating Custom Nodes
- N8N Tools API Documentation (generic reference, actual URL depends on service)