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
The node integrates with the Telegram Bot API to perform various chat-related operations. Specifically, for the "Chats" resource and the "Set Chat Title" operation, it allows users to change the title of a Telegram chat by specifying the chat's unique identifier and the new title. This is useful in scenarios where you want to programmatically update group or channel names based on workflow events or external triggers.
Practical examples include:
- Automatically renaming a group chat when a project phase changes.
- Updating a channel title to reflect current promotions or announcements.
- Managing multiple chats dynamically from an automation workflow.
Properties
| Name | Meaning |
|---|---|
| Chat ID | The unique identifier of the Telegram chat whose title you want to set (required). |
| Options | Additional optional parameters as a JSON object (not specifically used in this operation but available for extensibility). |
Note: For the "Set Chat Title" operation, an additional property named title (string) is required to specify the new chat title, although it was not included in the provided properties snippet. This is inferred from the source code usage.
Output
The node outputs a JSON object representing the response from the Telegram Bot API after attempting to set the chat title. This typically includes confirmation details about the updated chat or an error message if the operation failed.
No binary data output is involved in this operation.
Example output structure (simplified):
{
"ok": true,
"result": {
"id": 123456789,
"title": "New Chat Title",
"type": "group"
}
}
Dependencies
- Requires a valid Telegram Bot API token configured as credentials in n8n.
- Requires access to the "N8N Tools API" service for subscription validation via an API key credential.
- 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.
- Missing Required Parameters: Ensure that the
chatIdandtitleparameters are provided and correctly formatted. - Permission Errors: The bot must have appropriate permissions to change the chat title; otherwise, the Telegram API will reject the request.
- Unknown Operation Error: If the operation name is incorrect or unsupported, the node will throw an error. Confirm that "setChatTitle" is selected under the "Chats" resource.
- JSON Parsing Errors: When providing JSON input in options or other fields, ensure the JSON is valid to avoid parsing errors.