Telegram Bot API
🌐 Türkçe

sendPoll

Kategori: Anketler · Bot API 10.3 · Resmi dokümantasyon

Anket gönderir.

Dönüş değeri: Başarılı olduğunda Message döndürür.

Parametreler

ParametreTürZorunluAçıklama
business_connection_idStringİsteğe bağlıİşletme bağlantısı ID'si
chat_idInteger or StringEvetSohbet ID'si veya @username
message_thread_idIntegerİsteğe bağlıForum konusu ID'si
questionStringEvetSoru (1-300 karakter)
question_parse_modeStringİsteğe bağlıSoru biçimlendirme modu: HTML, Markdown, MarkdownV2
question_entitiesArray of MessageEntityİsteğe bağlıSoru için JSON MessageEntity dizisi
optionsArray of InputPollOptionEvetJSON InputPollOption dizisi [{"text":"Option 1"},{"text":"Option 2"}]
is_anonymousBooleanİsteğe bağlıAnonim anket (varsayılan true)
typeStringİsteğe bağlıquiz veya regular
allows_multiple_answersBooleanİsteğe bağlıBirden fazla cevaba izin ver
allows_revotingBooleanİsteğe bağlıYeniden oy vermeye izin ver (Bot API 9.6)
shuffle_optionsBooleanİsteğe bağlıSeçenekleri karıştır (Bot API 9.6)
allow_adding_optionsBooleanİsteğe bağlıSeçenek eklemeye izin ver (Bot API 9.6)
hide_results_until_closesBooleanİsteğe bağlıAnket kapanana kadar sonuçları gizle (Bot API 9.6)
members_onlyBooleanİsteğe bağlıYalnızca üyeler (Bot API 10.0)
country_codesArray of Stringİsteğe bağlıÜlke kodlarının JSON dizisi (Bot API 10.0)
correct_option_idsArray of Integerİsteğe bağlıDoğru seçenek ID'lerinin JSON dizisi (quiz için), ör. [0]
explanationStringİsteğe bağlıDoğru cevabın açıklaması (quiz için)
explanation_parse_modeStringİsteğe bağlıAçıklama biçimlendirme modu
explanation_entitiesArray of MessageEntityİsteğe bağlıAçıklama için JSON MessageEntity dizisi
explanation_mediaInputPollMediaİsteğe bağlıJSON InputPollMedia nesnesi (Bot API 10.0)
open_periodIntegerİsteğe bağlıAnketin açık kalma süresi (saniye, 5-2628000)
close_dateIntegerİsteğe bağlıAnketin kapanacağı Unix zaman damgası
is_closedBooleanİsteğe bağlıAnketi hemen kapat
descriptionStringİsteğe bağlıAnket açıklaması (0-1024 karakter, Bot API 9.6)
description_parse_modeStringİsteğe bağlıAçıklama biçimlendirme modu: HTML, Markdown, MarkdownV2
description_entitiesArray of MessageEntityİsteğe bağlıAçıklama için JSON MessageEntity dizisi
mediaInputPollMediaİsteğe bağlıJSON InputPollMedia nesnesi — anket medyası (Bot API 10.0)
disable_notificationBooleanİsteğe bağlıSessiz gönder
protect_contentBooleanİsteğe bağlıİçeriği koru
allow_paid_broadcastBooleanİsteğe bağlıÜcretli yayına izin ver
message_effect_idStringİsteğe bağlıMesaj efekti ID'si
reply_parametersReplyParametersİsteğe bağlıJSON ReplyParameters nesnesi
reply_markupInlineKeyboardMarkup or ReplyKeyboardMarkup or ReplyKeyboardRemove or ForceReplyİsteğe bağlıJSON: InlineKeyboardMarkup / ReplyKeyboardMarkup / ReplyKeyboardRemove / ForceReply

Parametre açıklamaları kısa özetlerdir; tam metin için resmi dokümantasyona bakın.

Örnek istek

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());

Adım adım rehber: Telegram bot nasıl yapılır? BotFather ile adım adım bot oluşturma