sendWidget
Mengirim pesan dengan widget HTML (Bot API 10.4).
Nilai kembalian: Jika berhasil, mengembalikan Message.
Parameter
| Parameter | Tipe | Wajib | Deskripsi |
|---|---|---|---|
chat_id | Integer or String | Ya | ID chat atau @username |
message_thread_id | Integer | Opsional | ID topik forum |
html | String | Ya | Kode HTML widget: 1-32768 byte, maks. 4096 byte setelah kompresi zlib |
width | Integer | Opsional | Lebar widget dalam piksel logis (kosongkan untuk lebar penuh pesan) |
height | Integer | Opsional | Tinggi widget dalam piksel logis, 50-600 (kosongkan untuk menyesuaikan konten) |
public_data | String | Opsional | Status publik widget (public_data), 0-1024 byte — terlihat di mana pun widget ditampilkan |
chat_data | String | Opsional | Status widget di chat ini (chat_data), 0-1024 byte |
caption | String | Opsional | Keterangan (0-1024) |
parse_mode | String | Opsional | HTML, Markdown, MarkdownV2 |
caption_entities | Array of MessageEntity | Opsional | Array JSON MessageEntity untuk keterangan |
show_caption_above_media | Boolean | Opsional | Tampilkan keterangan di atas widget |
allow_queries | Boolean | Opsional | Izinkan widget mengirim query ke bot (widget_query) |
is_shared | Boolean | Opsional | Buat widget bersama — dapat dikirim ulang dengan sendSharedWidget |
disable_notification | Boolean | Opsional | Kirim tanpa suara |
protect_content | Boolean | Opsional | Lindungi konten |
allow_paid_broadcast | Boolean | Opsional | Izinkan siaran berbayar |
message_effect_id | String | Opsional | ID efek pesan |
reply_parameters | ReplyParameters | Opsional | Objek JSON ReplyParameters |
reply_markup | InlineKeyboardMarkup or ReplyKeyboardMarkup or ReplyKeyboardRemove or ForceReply | Opsional | Objek JSON: InlineKeyboardMarkup / ReplyKeyboardMarkup / ReplyKeyboardRemove / ForceReply |
Contoh permintaan
curl
curl -s -X POST "https://api.telegram.org/bot$TOKEN/sendWidget" \
-H "Content-Type: application/json" \
-d '{
"chat_id": 123456789,
"html": "<h3>Order #1042</h3><p>2 × Margherita</p><button>Track the order</button>"
}'
Python
import requests
TOKEN = "123456789:AAEexampleTokenReplaceWithYours"
resp = requests.post(
f"https://api.telegram.org/bot{TOKEN}/sendWidget",
json={
"chat_id": 123456789,
"html": "<h3>Order #1042</h3><p>2 × Margherita</p><button>Track the order</button>"
},
timeout=30,
)
print(resp.json())
JavaScript
const TOKEN = "123456789:AAEexampleTokenReplaceWithYours";
const res = await fetch(`https://api.telegram.org/bot${TOKEN}/sendWidget`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"chat_id": 123456789,
"html": "<h3>Order #1042</h3><p>2 × Margherita</p><button>Track the order</button>"
}),
});
console.log(await res.json());
Panduan langkah demi langkah: Widget Telegram: HTML Interaktif di Dalam Pesan Bot
Metode terkait
sendSharedWidgetMengirim ulang widget bersama yang dibuat oleh bot (Bot API 10.4).answerWidgetQueryMenjawab query dari widget (Bot API 10.4).editMessageWidgetDataMengedit data widget dalam pesan (Bot API 10.4).editSharedWidgetDataMengedit data publik widget bersama (Bot API 10.4).