sendGift
Надсилає подарунок користувачеві або в чат.
Повертає: У разі успіху повертає True.
Параметри
| Параметр | Тип | Обов’язковий | Опис |
|---|---|---|---|
user_id | Integer | Ні | ID користувача (user_id або chat_id) |
chat_id | Integer or String | Ні | ID чату або @username (альтернатива user_id) |
gift_id | String | Так | ID подарунка |
pay_for_upgrade | Boolean | Ні | Оплатити покращення подарунка |
text | String | Ні | Текст до подарунка (0-255) |
text_parse_mode | String | Ні | Режим розмітки тексту: HTML, Markdown, MarkdownV2 |
text_entities | Array of MessageEntity | Ні | JSON-масив MessageEntity |
Приклад запиту
curl
curl -s -X POST "https://api.telegram.org/bot$TOKEN/sendGift" \
-H "Content-Type: application/json" \
-d '{"chat_id":123456789,"gift_id":"GIFT_ID"}'
Python
import requests
TOKEN = "123456789:AAEexampleTokenReplaceWithYours"
resp = requests.post(
f"https://api.telegram.org/bot{TOKEN}/sendGift",
json={
"chat_id": 123456789,
"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({
"chat_id": 123456789,
"gift_id": "GIFT_ID"
}),
});
console.log(await res.json());
Покроковий посібник: Як створити бота в Телеграм: від @BotFather до першого повідомлення
Схожі методи
sendInvoiceНадсилає рахунок на оплату.createInvoiceLinkСтворює посилання на оплату.refundStarPaymentПовертає платіж у Telegram Stars.getMyStarBalanceПовертає баланс Telegram Stars бота.getStarTransactionsПовертає транзакції Telegram Stars бота.editUserStarSubscriptionСкасовує або поновлює підписку в Telegram Stars.giftPremiumSubscriptionДарує підписку Telegram Premium.answerShippingQueryВідповідає на запит щодо доставки.answerPreCheckoutQueryВідповідає на запит перед оплатою (pre-checkout).getAvailableGiftsПовертає подарунки, які бот може надіслати.getUserGiftsПовертає подарунки користувача.getChatGiftsПовертає подарунки чату.