Actions23
- Chat Actions
- Callback Actions
- File Actions
- Message Actions
Overview
The node integrates with Telegram to perform various chat and message-related operations. Specifically, for the Pin Chat Message operation under the Message resource, it allows users to pin a specific message in a Telegram chat or channel. Pinning a message highlights it at the top of the chat, making it easily visible to all members.
This operation is useful in scenarios such as:
- Highlighting important announcements or rules in group chats.
- Pinning event details or updates in channels.
- Keeping critical information accessible without scrolling through the chat history.
Example use case: Automatically pinning a welcome message or an update notification when triggered by an external event or workflow.
Properties
| Name | Meaning |
|---|---|
| Chat ID | Unique identifier for the target chat or username of the target channel (format: @channelusername). |
| Message ID | Unique identifier of the message to pin. |
| Additional Fields | Optional settings for the pin action: |
| - Disable Notification | Whether to send a notification to all chat members about the new pinned message (boolean). |
Output
The node outputs JSON data representing the response from the Telegram API after attempting to pin the message. This typically includes confirmation of success or error details.
No binary data output is associated with this operation.
Dependencies
- Requires an active Telegram Bot API key credential configured in n8n.
- The node uses Telegram's Bot API endpoints to perform actions.
- No additional external services are required beyond Telegram.
Troubleshooting
Common issues:
- Invalid or missing Chat ID or Message ID will cause the operation to fail.
- Insufficient bot permissions in the chat to pin messages.
- Trying to pin a message that does not exist or is already pinned.
Error messages:
- Errors returned from Telegram API will be propagated, e.g., "Bad Request: message to pin not found".
- If the file name is missing when uploading binary data (not applicable here but relevant for other operations), an error prompts to set the file name.
Resolutions:
- Verify the Chat ID and Message ID values are correct.
- Ensure the bot has admin rights with permission to pin messages in the chat.
- Check if the message is already pinned or if the chat supports pinning.