Telegram Bot icon

Telegram Bot

Interact with the Telegram Bot API – send messages, manage chats, handle payments, and more

Actions101

Message → Send Poll

AI-generated

Summary

Send a poll message to a specified Telegram chat with configurable question, options, and poll settings.

Inputs

  • Chat ID (required) — Unique identifier for the target chat or username (@channelusername).
  • Question (required) — The text of the poll question to be asked.
  • Poll Options (JSON) (required) — JSON array of poll option strings, e.g. ["Option A", "Option B"].
  • Reply Markup (JSON) — Optional inline keyboard, reply keyboard, or other reply markup as a JSON object.
  • Additional Fields — Optional collection of fields to customize the poll, including: is_anonymous (boolean, default true), type ('regular' or 'quiz'), allows_multiple_answers (boolean), correct_option_id (number, for quiz mode), explanation (string shown when a wrong answer is chosen), open_period (number of seconds poll is active, 5-600), close_date (Unix timestamp to close poll), and disable_notification (boolean to send silently).

Output shape

a single JSON object representing the sent Poll message from Telegram's API response.

The operation returns the Telegram API response with the sent poll message details. The 'poll_options' input must be a valid JSON array string. 'Additional Fields' allow further customization following Telegram's sendPoll API parameters. Errors will be returned as failure messages unless 'continueOnFail' is enabled.

Examples

Example 1: Send a simple poll to a chat with two options.

Specify 'Chat ID', provide a 'Question' string, set 'Poll Options (JSON)' to ["Yes", "No"], optionally configure 'Additional Fields' for anonymity or poll type.

Links

Discussion