Actions23
- Chat Actions
- Callback Actions
- File Actions
- Message Actions
Overview
The "Get Administrators" operation of the Chat resource in this Telegram node retrieves a list of all administrators in a specified chat. This is useful for scenarios where you need to manage or audit chat permissions, automate administrative tasks, or monitor who has elevated privileges within a group, supergroup, or channel.
Practical examples:
- Automatically fetching and logging the current administrators of a Telegram group to keep track of changes.
- Triggering workflows based on the presence or absence of certain administrators.
- Sending notifications or messages specifically to administrators by first retrieving their user details.
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 administrators to retrieve. |
Output
The output JSON contains an array under the json field representing the list of chat administrators. Each item corresponds to one administrator with detailed information as returned by the Telegram API's getChatAdministrators method. This typically includes user details and their status/role in the chat.
No binary data is output for this operation.
Dependencies
- Requires an active connection to the Telegram Bot API using a valid API authentication token configured in the node credentials.
- The node internally calls the Telegram API endpoint
getChatAdministrators. - No additional external services or environment variables are required beyond the Telegram API credential.
Troubleshooting
Common issues:
- Invalid or missing Chat ID: Ensure the Chat ID is correctly provided and the bot has access to the chat.
- Insufficient permissions: The bot must be an administrator or have appropriate rights to query administrators in the chat.
- Network or API errors: Temporary connectivity issues or Telegram API rate limits may cause failures.
Error messages:
"The resource "chat" is not known!": Indicates an unsupported resource or operation was selected; verify that "Chat" resource and "Get Administrators" operation are chosen.- Errors related to invalid chat identifiers or permissions will come from the Telegram API and should be resolved by verifying bot permissions and chat identifiers.