sendPoll
Надсилає опитування.
Повертає: У разі успіху повертає Message.
Параметри
| Параметр | Тип | Обов’язковий | Опис |
|---|---|---|---|
business_connection_id | String | Ні | ID бізнес-підключення |
chat_id | Integer or String | Так | ID чату або @username |
message_thread_id | Integer | Ні | ID теми форуму |
question | String | Так | Запитання (1-300 символів) |
question_parse_mode | String | Ні | Режим розмітки запитання: HTML, Markdown, MarkdownV2 |
question_entities | Array of MessageEntity | Ні | JSON-масив MessageEntity для запитання |
options | Array of InputPollOption | Так | JSON-масив InputPollOption [{"text":"Варіант 1"},{"text":"Варіант 2"}] |
is_anonymous | Boolean | Ні | Анонімне опитування (типово true) |
type | String | Ні | quiz або regular |
allows_multiple_answers | Boolean | Ні | Дозволити кілька відповідей |
allows_revoting | Boolean | Ні | Дозволити переголосування (Bot API 9.6) |
shuffle_options | Boolean | Ні | Перемішати варіанти (Bot API 9.6) |
allow_adding_options | Boolean | Ні | Дозволити додавати варіанти (Bot API 9.6) |
hide_results_until_closes | Boolean | Ні | Приховати результати до закриття (Bot API 9.6) |
members_only | Boolean | Ні | Лише для учасників (Bot API 10.0) |
country_codes | Array of String | Ні | JSON-масив кодів країн (Bot API 10.0) |
correct_option_ids | Array of Integer | Ні | JSON-масив ID правильних варіантів (для quiz), напр. [0] |
explanation | String | Ні | Пояснення правильної відповіді (для quiz) |
explanation_parse_mode | String | Ні | Режим розмітки пояснення |
explanation_entities | Array of MessageEntity | Ні | JSON-масив MessageEntity для пояснення |
explanation_media | InputPollMedia | Ні | JSON-об’єкт InputPollMedia (Bot API 10.0) |
open_period | Integer | Ні | Тривалість опитування в секундах (5-2628000) |
close_date | Integer | Ні | Unix-час закриття опитування |
is_closed | Boolean | Ні | Закрити опитування одразу |
description | String | Ні | Опис опитування (0-1024 символи, Bot API 9.6) |
description_parse_mode | String | Ні | Режим розмітки опису: HTML, Markdown, MarkdownV2 |
description_entities | Array of MessageEntity | Ні | JSON-масив MessageEntity для опису |
media | InputPollMedia | Ні | JSON-об’єкт InputPollMedia — медіа опитування (Bot API 10.0) |
disable_notification | Boolean | Ні | Надіслати без звуку |
protect_content | Boolean | Ні | Захистити вміст |
allow_paid_broadcast | Boolean | Ні | Дозволити платну розсилку |
message_effect_id | String | Ні | ID ефекту повідомлення |
reply_parameters | ReplyParameters | Ні | JSON-об’єкт ReplyParameters |
reply_markup | InlineKeyboardMarkup or ReplyKeyboardMarkup or ReplyKeyboardRemove or ForceReply | Ні | JSON: InlineKeyboardMarkup / ReplyKeyboardMarkup / ReplyKeyboardRemove / ForceReply |
Приклад запиту
curl
curl -s -X POST "https://api.telegram.org/bot$TOKEN/sendPoll" \
-H "Content-Type: application/json" \
-d '{
"chat_id": 123456789,
"question": "Which language do you use?",
"options": [
{
"text": "Python"
},
{
"text": "JavaScript"
}
]
}'
Python
import requests
TOKEN = "123456789:AAEexampleTokenReplaceWithYours"
resp = requests.post(
f"https://api.telegram.org/bot{TOKEN}/sendPoll",
json={
"chat_id": 123456789,
"question": "Which language do you use?",
"options": [
{
"text": "Python"
},
{
"text": "JavaScript"
}
]
},
timeout=30,
)
print(resp.json())
JavaScript
const TOKEN = "123456789:AAEexampleTokenReplaceWithYours";
const res = await fetch(`https://api.telegram.org/bot${TOKEN}/sendPoll`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"chat_id": 123456789,
"question": "Which language do you use?",
"options": [
{
"text": "Python"
},
{
"text": "JavaScript"
}
]
}),
});
console.log(await res.json());
Покроковий посібник: Як створити бота в Телеграм: від @BotFather до першого повідомлення
Схожі методи
stopPollЗупиняє опитування.