v1

latestOpenAPI 3.0.02026-07-1374103805.5 KB

Use this method to send a native poll. On success, the sent Message is returned.

post/sendPoll

Request body

questionstring required

Poll question, 1-300 characters

optionsstring[] required

A JSON-serialized list of answer options, 2-10 strings 1-100 characters each

is_anonymousboolean

True, if the poll needs to be anonymous, defaults to True

typestring

Poll type, “quiz” or “regular”, defaults to “regular”

allows_multiple_answersboolean

True, if the poll allows multiple answers, ignored for polls in quiz mode, defaults to False

correct_option_idinteger

0-based identifier of the correct answer option, required for polls in quiz mode

explanationstring

Text that is shown when a user chooses an incorrect answer or taps on the lamp icon in a quiz-style poll, 0-200 characters with at most 2 line feeds after entities parsing

explanation_parse_modestring

Mode for parsing entities in the explanation. See formatting options for more details.

open_periodinteger

Amount of time in seconds the poll will be active after creation, 5-600. Can't be used together with close_date.

close_dateinteger

Point in time (Unix timestamp) when the poll will be automatically closed. Must be at least 5 and no more than 600 seconds in the future. Can't be used together with open_period.

is_closedboolean

Pass True, if the poll needs to be immediately closed. This can be useful for poll preview.

disable_notificationboolean

Sends the message silently. Users will receive a notification with no sound.

reply_to_message_idinteger

If the message is a reply, ID of the original message

allow_sending_without_replyboolean

Pass True, if the message should be sent even if the specified replied-to message is not found

Response

okboolean required