sendGift
Gửi quà tặng cho người dùng hoặc chat.
Giá trị trả về: Nếu thành công, trả về True.
Tham số
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
user_id | Integer | Tùy chọn | ID người dùng (user_id hoặc chat_id) |
chat_id | Integer or String | Tùy chọn | ID chat hoặc @username (thay cho user_id) |
gift_id | String | Có | ID quà tặng |
pay_for_upgrade | Boolean | Tùy chọn | Trả phí nâng cấp quà tặng |
text | String | Tùy chọn | Lời nhắn kèm quà tặng (0-255) |
text_parse_mode | String | Tùy chọn | Chế độ định dạng văn bản: HTML, Markdown, MarkdownV2 |
text_entities | Array of MessageEntity | Tùy chọn | Mảng JSON MessageEntity |
Ví dụ request
curl
curl -s -X POST "https://api.telegram.org/bot$TOKEN/sendGift" \
-H "Content-Type: application/json" \
-d '{"gift_id":"GIFT_ID"}'
Python
import requests
TOKEN = "123456789:AAEexampleTokenReplaceWithYours"
resp = requests.post(
f"https://api.telegram.org/bot{TOKEN}/sendGift",
json={
"gift_id": "GIFT_ID"
},
timeout=30,
)
print(resp.json())
JavaScript
const TOKEN = "123456789:AAEexampleTokenReplaceWithYours";
const res = await fetch(`https://api.telegram.org/bot${TOKEN}/sendGift`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"gift_id": "GIFT_ID"
}),
});
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
sendInvoiceGửi hóa đơn thanh toán.createInvoiceLinkTạo liên kết thanh toán.refundStarPaymentHoàn tiền một khoản thanh toán bằng Telegram Stars.getMyStarBalanceTrả về số dư Telegram Stars của bot.getStarTransactionsTrả về các giao dịch Telegram Stars của bot.editUserStarSubscriptionHủy hoặc gia hạn gói đăng ký Telegram Stars.giftPremiumSubscriptionTặng gói đăng ký Telegram Premium.answerShippingQueryTrả lời truy vấn giao hàng.answerPreCheckoutQueryTrả lời truy vấn pre-checkout.getAvailableGiftsTrả về các quà tặng mà bot có thể gửi.getUserGiftsTrả về quà tặng của người dùng.getChatGiftsTrả về quà tặng của chat.