sendSharedWidget
ویجت اشتراکی ساختهشده توسط ربات را دوباره ارسال میکند (Bot API 10.4).
مقدار بازگشتی: در صورت موفقیت، Message برمیگرداند.
پارامترها
| پارامتر | نوع | الزامی | توضیحات |
|---|---|---|---|
chat_id | Integer or String | بله | شناسه چت یا @username |
message_thread_id | Integer | اختیاری | شناسه تاپیک انجمن |
widget_id | String | بله | شناسه ویجت اشتراکی (widget.id از پیام ارسالشده) |
chat_data | String | اختیاری | وضعیت ویجت در این چت (chat_data)، 0-1024 بایت |
caption | String | اختیاری | کپشن (0-1024) |
parse_mode | String | اختیاری | HTML، Markdown یا MarkdownV2 |
caption_entities | Array of MessageEntity | اختیاری | آرایه JSON از نوع MessageEntity برای کپشن |
show_caption_above_media | Boolean | اختیاری | نمایش کپشن بالای ویجت |
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/sendSharedWidget" \
-H "Content-Type: application/json" \
-d '{"chat_id":123456789,"widget_id":"WIDGET_ID"}'
Python
import requests
TOKEN = "123456789:AAEexampleTokenReplaceWithYours"
resp = requests.post(
f"https://api.telegram.org/bot{TOKEN}/sendSharedWidget",
json={
"chat_id": 123456789,
"widget_id": "WIDGET_ID"
},
timeout=30,
)
print(resp.json())
JavaScript
const TOKEN = "123456789:AAEexampleTokenReplaceWithYours";
const res = await fetch(`https://api.telegram.org/bot${TOKEN}/sendSharedWidget`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"chat_id": 123456789,
"widget_id": "WIDGET_ID"
}),
});
console.log(await res.json());
راهنمای گامبهگام: مثال ویجت تلگرام: کد کامل HTML و ربات پایتون
متدهای مرتبط
sendWidgetپیامی حاوی ویجت HTML ارسال میکند (Bot API 10.4).answerWidgetQueryبه کوئری ویجت پاسخ میدهد (Bot API 10.4).editMessageWidgetDataدادههای ویجت در پیام را ویرایش میکند (Bot API 10.4).editSharedWidgetDataدادههای عمومی ویجت اشتراکی را ویرایش میکند (Bot API 10.4).