Actions27
- Chat Actions
- File Actions
- Group Actions
- Message Actions
- User Actions
Overview
The node "Telegram CoPilot" integrates with the Telegram API to perform various chat-related actions programmatically. Specifically, for the Chat resource and Send Chat Action operation, it allows sending real-time chat status updates such as typing, recording voice notes, or uploading media indicators to a specified chat. This is useful in scenarios where you want to simulate user activity or provide feedback to chat participants that an action is in progress (e.g., showing "typing..." while composing a message).
Practical examples include:
- Indicating to a chat participant that a message is being typed.
- Showing that a voice note is being recorded.
- Signaling that a photo or document is being uploaded.
This enhances user experience by providing live interaction cues within Telegram chats.
Properties
| Name | Meaning |
|---|---|
| Chat ID | The unique identifier of the Telegram chat where the action will be sent. |
| Action | The type of chat action to send. Options include: |
| - Cancel | |
| - Recording voice note | |
| - Typing | |
| - Uploading document | |
| - Uploading photo | |
| - Uploading video | |
| - Uploading voice note |
Output
The output is a JSON array containing the response from the Telegram API after sending the chat action. The structure corresponds to the Telegram API's response object for the sendChatAction method, typically confirming the action was accepted or providing error details if any.
No binary data is output by this operation.
Dependencies
- Requires an active Telegram API authentication credential (an API key and associated login).
- Depends on the TelePilotNodeConnectionManager to manage Telegram client sessions.
- The node expects the Telegram session to be logged in and ready; otherwise, it prompts for login via phone number and code.
- Network access to Telegram servers is required.
Troubleshooting
- Session Not Logged In: If the Telegram session is not authenticated, the node will throw an error instructing to log in using the login flow. Users should follow the guide at https://telepilot.co/login-howto.
- Closed Client Error: If the client session was closed or terminated, the node will request re-login.
- Unauthorized Errors: These indicate invalid or expired credentials; re-authentication is necessary.
- Invalid Chat ID: Providing an incorrect or non-existent chat ID may cause errors or no action effect.
- Unsupported Actions: Selecting an unsupported action value will result in failure; ensure the action matches one of the predefined options.
Links and References
- Telegram Bot API - sendChatAction (for general understanding of chat actions)
- TelePilot Login Guide (for setup and troubleshooting login issues)