sendGift
متدهدیهای را به کاربر یا کانال مشخصشده میفرستد. گیرنده نمیتواند هدیه را به ستارهٔ تلگرام تبدیل کند. در صورت موفقیت True برمیگرداند.
خروجی: Boolean
پارامترها
| نام | نوع | الزام | توضیحات |
|---|---|---|---|
| user_id | Integer | اختیاری | اگر chat_id مشخص نشده باشد الزامی است. شناسهٔ یکتای کاربر هدفی که هدیه را دریافت میکند. |
| chat_id | Integer or String | اختیاری | اگر user_id مشخص نشده باشد الزامی است. شناسهٔ یکتای گفتگو یا نامکاربری کانال (با قالب @username) که هدیه را دریافت میکند. |
| gift_id | String | الزامی | شناسهٔ هدیه؛ هدیههای محدود را نمیتوان به کانالها فرستاد. |
| pay_for_upgrade | Boolean | اختیاری | برای پرداخت هزینهٔ ارتقای هدیه از موجودی ربات (و در نتیجه رایگانشدن ارتقا برای گیرنده)، True بدهید. |
| text | String | اختیاری | متنی که همراه هدیه نمایش داده میشود؛ ۰ تا ۱۲۸ نویسه |
| text_parse_mode | String | اختیاری | حالت تجزیهٔ موجودیتها در متن. جزئیات بیشتر را در گزینههای قالببندی ببینید. موجودیتهایی غیر از «bold»، «italic»، «underline»، «strikethrough»، «spoiler»، «custom_emoji» و «date_time» نادیده گرفته میشوند. |
| text_entities | Array of MessageEntity | اختیاری | فهرست JSON از موجودیتهای ویژهای که در متن هدیه آمدهاند. میتوان آن را بهجای text_parse_mode داد. موجودیتهایی غیر از «bold»، «italic»، «underline»، «strikethrough»، «spoiler»، «custom_emoji» و «date_time» نادیده گرفته میشوند. |