transferGift
Передає унікальний подарунок іншому користувачеві.
Повертає: У разі успіху повертає True.
Параметри
| Параметр | Тип | Обов’язковий | Опис |
|---|---|---|---|
business_connection_id | String | Так | ID бізнес-підключення |
owned_gift_id | String | Так | ID отриманого подарунка |
new_owner_chat_id | Integer | Так | ID чату нового власника |
star_count | Integer | Ні | Кількість Stars за передавання |
Приклад запиту
curl
curl -s -X POST "https://api.telegram.org/bot$TOKEN/transferGift" \
-H "Content-Type: application/json" \
-d '{
"business_connection_id": "BUSINESS_CONNECTION_ID",
"owned_gift_id": "OWNED_GIFT_ID",
"new_owner_chat_id": 123456789
}'
Python
import requests
TOKEN = "123456789:AAEexampleTokenReplaceWithYours"
resp = requests.post(
f"https://api.telegram.org/bot{TOKEN}/transferGift",
json={
"business_connection_id": "BUSINESS_CONNECTION_ID",
"owned_gift_id": "OWNED_GIFT_ID",
"new_owner_chat_id": 123456789
},
timeout=30,
)
print(resp.json())
JavaScript
const TOKEN = "123456789:AAEexampleTokenReplaceWithYours";
const res = await fetch(`https://api.telegram.org/bot${TOKEN}/transferGift`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"business_connection_id": "BUSINESS_CONNECTION_ID",
"owned_gift_id": "OWNED_GIFT_ID",
"new_owner_chat_id": 123456789
}),
});
console.log(await res.json());
Покроковий посібник: Як створити бота в Телеграм: від @BotFather до першого повідомлення
Схожі методи
sendInvoiceНадсилає рахунок на оплату.createInvoiceLinkСтворює посилання на оплату.refundStarPaymentПовертає платіж у Telegram Stars.sendGiftНадсилає подарунок користувачеві або в чат.getMyStarBalanceПовертає баланс Telegram Stars бота.getStarTransactionsПовертає транзакції Telegram Stars бота.editUserStarSubscriptionСкасовує або поновлює підписку в Telegram Stars.giftPremiumSubscriptionДарує підписку Telegram Premium.answerShippingQueryВідповідає на запит щодо доставки.answerPreCheckoutQueryВідповідає на запит перед оплатою (pre-checkout).getAvailableGiftsПовертає подарунки, які бот може надіслати.getUserGiftsПовертає подарунки користувача.