sendPoll
نظرسنجی ارسال میکند.
مقدار بازگشتی: در صورت موفقیت، Message برمیگرداند.
پارامترها
| پارامتر | نوع | الزامی | توضیحات |
|---|---|---|---|
business_connection_id | String | اختیاری | شناسه اتصال تجاری |
chat_id | Integer or String | بله | شناسه چت یا @username |
message_thread_id | Integer | اختیاری | شناسه تاپیک انجمن |
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":"Option 1"},{"text":"Option 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 از شناسههای گزینههای صحیح (برای نوع 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 timestamp) |
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 | اختیاری | شناسه افکت پیام |
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 تا اولین پیام با Python
متدهای مرتبط
stopPollنظرسنجی را متوقف میکند.