SuperAPI AI Directory
Partner中文AI newsFavorites
Skillstg-polls

tg-polls

General & other

View repository

Updated 11-06 16:23

About this skill

tg-polls

Checked against the official docs on 2026-10-16: Bot API 10.3 (latest, August 24, 2026), MTProto layer 225+ (poll, inputMediaPoll), Telegram blog post of 2026-03-31 "AI Editor, Mighty Polls…".

One message: text + poll

A post and its poll fit in one message. Put the post text into the poll description, not into a separate message.

Need Bot API (sendPoll) User account (MTProto / Telethon)
Post text above the poll description, 0–1024 chars after entities parsing; description_parse_mode / description_entities message of messages.sendMedia with media=inputMediaPoll (Telethon: send_file(chat, InputMediaPoll(...), caption=TEXT))
One photo/video/file on the poll media (InputPollMedia: animation, audio, document, live photo, location, photo, venue, video) inputMediaPoll.attached_media
Media on an option InputPollOption.media (animation, link, live photo, location, photo, sticker, venue, video) inputPollAnswer.media
Text longer than 1024 chars separate message first (for example a rich message), poll second same

A poll can't go inside a rich message (no poll block among the 24 InputRichBlock types), into an album (sendMediaGroup takes audio, document, live photo, photo, video only) or into sendMessage.

MTProto has no separate description field in poll / inputMediaPoll. The caption is the description. Verified 2026-10-16 with Telethon 1.44 (layer 227) in a self-chat: the server accepted a 12-option poll with a caption and returned the text in message.message.

Limits

What Limit Since
Options 1–12 (poll_answers_max = 12 in client config) max 12 in Bot API 9.1, min 1 in 10.0
Question 1–300 chars; only custom emoji entities
Option text 1–100 chars; only custom emoji entities
Description 0–1024 chars 9.6
Quiz explanation 0–200 chars, at most 2 line feeds; explanation_media media in 10.0
open_period / close_date 5–2628000 s, not both 9.6
country_codes 0–12 ISO codes, channels only; FT = anonymous numbers 10.0

Older code often hardcodes 10 options. Remove that check: it rejects valid 11- and 12-option polls.

Settings

Bot API name → MTProto flag on poll:

  • allows_multiple_answers → multiple_choice. Default off; turn it on when people combine tools.
  • is_anonymous (default true) → inverse of public_voters.
  • allow_adding_options → open_answers. Participants suggest options in an active poll; not for anonymous polls and quizzes. MTProto: messages.addPollAnswer, a participant may delete own answer within poll_answer_delete_period (300 s).
  • allows_revoting (default true for regular polls, false for quizzes) → inverse of revoting_disabled.
  • shuffle_options → shuffle_answers.
  • hide_results_until_closes → hide_results_until_close.
  • members_only → subscribers_only: only members for more than 24 h; channels only.
  • country_codes → countries_iso2.
  • Quiz: type: "quiz" + correct_option_ids (several correct answers allowed since 9.6) → quiz + inputMediaPoll.correct_answers.

chat_id can't be a channel direct messages chat.

Bot API example

curl -s "https://api.telegram.org/bot$TOKEN/sendPoll" \
  -H 'Content-Type: application/json' \
  -d '{
    "chat_id": "@your_channel",
    "question": "Where do you track tasks when agents write the code?",
    "description": "Backlog, release plans, what to do tomorrow. Pick several if you combine tools.",
    "options": [{"text": "Jira"}, {"text": "Linear"}, {"text": "GitHub / GitLab Issues"},
                {"text": "Notion"}, {"text": "Obsidian"}, {"text": "Markdown files in the repo"},
                {"text": "Other (in comments)"}],
    "is_anonymous": true,
    "allows_multiple_answers": true
  }'

Telethon example

from telethon.tl.types import InputMediaPoll, Poll, PollAnswer, TextWithEntities

answers = [PollAnswer(text=TextWithEntities(text=o, entities=[]), option=bytes([i]))
           for i, o in enumerate(options)]          # up to 12
poll = Poll(id=0, hash=0, question=TextWithEntities(text=question, entities=[]),
            answers=answers, multiple_choice=True)
await client.send_file(chat, InputMediaPoll(poll=poll), caption=post_text)  # caption = description

Before sending

  1. Preview in your own chat (Saved Messages or a bot DM), then send to the audience.
  2. Options and question within the limits above; description ≤ 1024.
  3. A sent poll can't be edited: Bot API has no method for its question or options, and the description is frozen too. Verified 2026-10-16 from a user account: messages.editMessage with new text on a poll returns MESSAGE_NOT_MODIFIED, and Telegram apps show no Edit for polls. Fix mistakes in the preview; a correction is a new poll.

Sources