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 integrates with the Telegram Bot API to perform various actions related to Telegram messaging, chats, bots, files, inline queries, and callback queries. Specifically for the Messages resource and the Send Poll operation, it allows sending a poll message to a specified Telegram chat.
This is useful in scenarios where you want to engage users by creating interactive polls within Telegram chats or channels. For example, a bot can send a poll asking users to vote on their favorite product feature or schedule a meeting time.
Properties
| Name | Meaning |
|---|---|
| Chat ID | The unique identifier of the Telegram chat where the poll will be sent. |
| Poll Data | JSON object containing the Telegram poll parameters such as question, options, etc. |
The Poll Data property expects a JSON structure compliant with Telegram's sendPoll method, including fields like question, options, is_anonymous, type, and others.
Output
The node outputs a JSON object representing the response from the Telegram API after sending the poll. This typically includes details about the sent poll message, such as message ID, chat information, poll content, and other metadata.
If an error occurs during execution, the output JSON will contain an error field with the error message (if "Continue On Fail" is enabled).
The node does not output binary data for this operation.
Dependencies
- Requires a valid Telegram Bot API token configured as credentials in n8n.
- Requires a subscription and API key for the external "N8N Tools API" service, which validates usage before forwarding requests to Telegram.
- The node uses HTTP requests to communicate with both the N8N Tools API and Telegram Bot API endpoints.
Troubleshooting
- Invalid subscription or API key error: If the node throws an error indicating invalid subscription or API key, verify that the API key credential for the external validation service is correct and active.
- Malformed Poll Data: Ensure the JSON provided in the Poll Data property is correctly formatted and complies with Telegram's API requirements. Invalid JSON or missing required fields will cause errors.
- Chat ID issues: Confirm that the Chat ID is correct and that the bot has permission to send messages to that chat.
- Network or API errors: Temporary network issues or Telegram API downtime may cause failures; retrying later might help.
Links and References
- Telegram Bot API - sendPoll method: https://core.telegram.org/bots/api#sendpoll
- Telegram Bot API documentation: https://core.telegram.org/bots/api
- n8n documentation on creating Telegram nodes (general reference): https://docs.n8n.io/integrations/builtin/app-nodes/n8n-nodes-base.telegram/