Actions23
- Chat Actions
- Callback Actions
- File Actions
- Message Actions
Overview
The "Send Chat Action" operation of the Telegram node allows you to broadcast a chat action status to a specified chat. This is useful for indicating to users that the bot is performing an action such as typing, uploading a photo, recording audio, or finding a location. The action status typically lasts for up to 5 seconds or until a message is sent by the bot.
Common scenarios include:
- Showing "typing" status while the bot prepares a response.
- Indicating that the bot is uploading media like photos or documents.
- Signaling that the bot is recording audio or video before sending it.
This improves user experience by providing real-time feedback about the bot's activity in the chat.
Properties
| Name | Meaning |
|---|---|
| Chat ID | Unique identifier for the target chat or username of the target channel (format: @channelusername). |
| Action | Type of chat action to broadcast. Options include: |
| - Find Location | |
| - Record Audio | |
| - Record Video | |
| - Record Video Note | |
| - Typing | |
| - Upload Audio | |
| - Upload Document | |
| - Upload Photo | |
| - Upload Video | |
| - Upload Video Note |
Output
The node outputs JSON data representing the result returned from the Telegram API after sending the chat action. Typically, this will confirm that the action was successfully broadcasted.
No binary data output is generated by this operation.
Dependencies
- Requires a valid Telegram API authentication token configured in n8n credentials.
- The node uses the Telegram Bot API endpoint to send chat actions.
- No additional external services are required beyond Telegram.
Troubleshooting
- Invalid Chat ID: If the chat ID is incorrect or the bot is not a member of the chat, the API call will fail. Verify the chat ID or username and ensure the bot has access.
- Invalid Action: Selecting an unsupported action type may cause errors. Use one of the predefined action options.
- API Authentication Errors: Ensure the Telegram API token credential is correctly set up and has necessary permissions.
- Timeouts or Network Issues: Network problems can prevent the request from completing. Check connectivity and retry.
Common error messages usually come directly from the Telegram API and indicate issues such as unauthorized access, invalid parameters, or chat not found.