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 Administrator Custom Title" operation, it allows you to assign a custom title to a chat administrator within a specified Telegram chat. This is useful for managing group chats or channels where administrators have specific roles or titles that should be displayed.
Practical scenarios include:
- Assigning special titles to moderators or admins in a Telegram group to reflect their responsibilities.
- Updating admin titles dynamically based on workflow events or external triggers.
- Enhancing group management by clearly labeling administrators with custom roles.
Properties
| Name | Meaning |
|---|---|
| Chat ID | The unique identifier of the Telegram chat where the administrator's title will be set. |
| User ID | The unique identifier of the Telegram user (administrator) whose custom title will be set. |
| Options | Additional optional parameters as a JSON object (not specifically used in this operation). |
Output
The output is a JSON object representing the response from the Telegram Bot API after setting the custom title for the chat administrator. It typically contains information about the success of the operation or details of the updated chat administrator.
No binary data output is involved in this operation.
Dependencies
- Requires an active Telegram Bot API token configured as credentials in n8n.
- Requires a valid subscription and API key for the external "N8N Tools API" service, which validates usage before forwarding requests to Telegram.
- The node uses HTTP requests to communicate with both the N8N Tools API and the Telegram Bot API.
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 external validation service is correct and active.
- Unknown Operation Error: Ensure that the operation name is correctly set to "setChatAdministratorCustomTitle" when using the Chats resource.
- Missing Required Parameters: Both
chatIdanduserIdare required. Missing these will cause errors. - Telegram API Errors: Errors returned from Telegram (e.g., user not an admin, chat not found) will be passed through. Check the Telegram Bot API documentation for error meanings.
- Continue On Fail: If enabled, the node will continue processing other items even if one fails, returning error details in the output JSON.