sendPoll
Gửi bình chọn.
Giá trị trả về: Nếu thành công, trả về Message.
Tham số
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
business_connection_id | String | Tùy chọn | ID kết nối doanh nghiệp |
chat_id | Integer or String | Có | ID chat hoặc @username |
message_thread_id | Integer | Tùy chọn | ID chủ đề diễn đàn |
question | String | Có | Câu hỏi (1-300 ký tự) |
question_parse_mode | String | Tùy chọn | Chế độ định dạng câu hỏi: HTML, Markdown, MarkdownV2 |
question_entities | Array of MessageEntity | Tùy chọn | Mảng JSON MessageEntity cho câu hỏi |
options | Array of InputPollOption | Có | Mảng JSON InputPollOption [{"text":"Option 1"},{"text":"Option 2"}] |
is_anonymous | Boolean | Tùy chọn | Bình chọn ẩn danh (mặc định true) |
type | String | Tùy chọn | quiz hoặc regular |
allows_multiple_answers | Boolean | Tùy chọn | Cho phép chọn nhiều đáp án |
allows_revoting | Boolean | Tùy chọn | Cho phép bình chọn lại (Bot API 9.6) |
shuffle_options | Boolean | Tùy chọn | Xáo trộn các lựa chọn (Bot API 9.6) |
allow_adding_options | Boolean | Tùy chọn | Cho phép thêm lựa chọn (Bot API 9.6) |
hide_results_until_closes | Boolean | Tùy chọn | Ẩn kết quả cho đến khi bình chọn kết thúc (Bot API 9.6) |
members_only | Boolean | Tùy chọn | Chỉ thành viên (Bot API 10.0) |
country_codes | Array of String | Tùy chọn | Mảng JSON các mã quốc gia (Bot API 10.0) |
correct_option_ids | Array of Integer | Tùy chọn | Mảng JSON các ID lựa chọn đúng (cho quiz), ví dụ [0] |
explanation | String | Tùy chọn | Giải thích đáp án đúng (cho quiz) |
explanation_parse_mode | String | Tùy chọn | Chế độ định dạng phần giải thích |
explanation_entities | Array of MessageEntity | Tùy chọn | Mảng JSON MessageEntity cho phần giải thích |
explanation_media | InputPollMedia | Tùy chọn | Đối tượng JSON InputPollMedia (Bot API 10.0) |
open_period | Integer | Tùy chọn | Thời gian mở bình chọn tính bằng giây (5-2628000) |
close_date | Integer | Tùy chọn | Mốc thời gian Unix đóng bình chọn |
is_closed | Boolean | Tùy chọn | Đóng bình chọn ngay lập tức |
description | String | Tùy chọn | Mô tả bình chọn (0-1024 ký tự, Bot API 9.6) |
description_parse_mode | String | Tùy chọn | Chế độ định dạng mô tả: HTML, Markdown, MarkdownV2 |
description_entities | Array of MessageEntity | Tùy chọn | Mảng JSON MessageEntity cho phần mô tả |
media | InputPollMedia | Tùy chọn | Đối tượng JSON InputPollMedia — media của bình chọn (Bot API 10.0) |
disable_notification | Boolean | Tùy chọn | Gửi không âm thanh |
protect_content | Boolean | Tùy chọn | Bảo vệ nội dung |
allow_paid_broadcast | Boolean | Tùy chọn | Cho phép gửi hàng loạt trả phí |
message_effect_id | String | Tùy chọn | ID hiệu ứng tin nhắn |
reply_parameters | ReplyParameters | Tùy chọn | Đối tượng JSON ReplyParameters |
reply_markup | InlineKeyboardMarkup or ReplyKeyboardMarkup or ReplyKeyboardRemove or ForceReply | Tùy chọn | JSON: InlineKeyboardMarkup / ReplyKeyboardMarkup / ReplyKeyboardRemove / ForceReply |
Ví dụ request
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());
Hướng dẫn từng bước: Cách tạo bot Telegram từ A đến Z: BotFather, token và tin nhắn đầu tiên
Phương thức liên quan
stopPollDừng bình chọn.