SendStarGiftOfferRequest

Both users and bots may be able to use this request. See code examples.

---functions---
payments.sendStarGiftOffer#8fb86b41 flags:# peer:InputPeer slug:string price:StarsAmount duration:int random_id:long allow_paid_stars:flags.0?long = Updates

Returns

Updates

This type can be an instance of either:

UpdateShortUpdateShortChatMessage
UpdateShortMessageUpdateShortSentMessage
UpdatesUpdatesCombined
UpdatesTooLong

Parameters

peerInputPeerAnything entity-like will work if the library can find its Input version (e.g., usernames, Peer, User or Channel objects, etc.).
slugstring
priceStarsAmount
durationint
random_idlongIf left unspecified, it will be inferred automatically.
allow_paid_starslongThis argument defaults to None and can be omitted.

Known RPC errors

This request can't cause any RPC error as far as we know.

Example

from telethon.sync import TelegramClient
from telethon import functions, types

with TelegramClient(name, api_id, api_hash) as client:
    result = client(functions.payments.SendStarGiftOfferRequest(
        peer='username',
        slug='some string here',
        price=types.StarsAmount(
            amount=-12398745604826,
            nanos=42
        ),
        duration=42,
        allow_paid_stars=-12398745604826
    ))
    print(result.stringify())