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 "N8N Tools Telegram" integrates with the Telegram Bot API, allowing users to perform various operations on Telegram resources such as messages, updates, chats, bots, files, inline queries, and callback queries. Specifically, for the Chats resource and the Get Chat Member operation, this node retrieves detailed information about a specific member of a Telegram chat by their user ID.
This functionality is useful in scenarios where you need to:
- Check the status or role of a user within a group or channel.
- Verify membership details before performing administrative actions.
- Automate moderation workflows based on user roles or permissions.
For example, you could use this node to fetch a user's chat member status to decide whether to promote them, restrict them, or send them a personalized message.
Properties
| Name | Meaning |
|---|---|
| Chat ID | The unique identifier for the Telegram chat (group, supergroup, or channel). Required. |
| User ID | The unique identifier of the Telegram user whose chat member information you want to get. |
| Options | Additional optional parameters as a JSON object (not specifically used in this operation). |
Output
The output is a JSON object containing the detailed information about the specified chat member. This typically includes fields such as:
- User details (id, first name, last name, username).
- Status in the chat (e.g., creator, administrator, member, restricted, left, kicked).
- Permissions and restrictions applicable to the user.
- Custom titles if set.
The exact structure follows the Telegram Bot API's ChatMember object format.
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 POST requests to the N8N Tools API endpoint, which then interacts with the Telegram API.
Troubleshooting
- Invalid subscription or API key error: If you receive errors related to invalid subscription or API key, verify that your API key credential for the external validation service is correct and active.
- Missing required parameters: Ensure that both
Chat IDandUser IDare provided; otherwise, the Telegram API will reject the request. - Unknown operation error: This node supports many operations; make sure the operation parameter is correctly set to
getChatMemberwhen working with chat members. - Permission errors from Telegram: The bot must have appropriate rights in the chat to retrieve member information. If the bot lacks permissions, Telegram may return an error.
Links and References
- Telegram Bot API - getChatMember
- Telegram Bot API - ChatMember Object
- n8n Documentation (for general node usage and credential setup)