> ## Documentation Index
> Fetch the complete documentation index at: https://help.bots.lt/llms.txt
> Use this file to discover all available pages before exploring further.

# Business & Gifts

> Manage Telegram Business accounts, Gifts, and Stars (Paid Media).

This section covers features introduced in recent Bot API updates tailored for **Telegram Business**, **Gifts**, and monetization via **Telegram Stars**.

***

## Telegram Business

Bots can be connected to Telegram Business accounts to reply on behalf of users.

### getBusinessConnection

Gets information about the connection of the bot with a business account.

| Parameter                | Type   | Required | Description                                   |
| ------------------------ | ------ | -------- | --------------------------------------------- |
| `business_connection_id` | String | Yes      | Unique identifier of the business connection. |

***

### setBusinessAccountBio

Changes the bio of a connected business account.

| Parameter                | Type   | Required | Description                                       |
| ------------------------ | ------ | -------- | ------------------------------------------------- |
| `business_connection_id` | String | Yes      | Unique identifier of the business connection.     |
| `bio`                    | String | Yes      | New bio of the business account, 0-70 characters. |

*(Similar methods exist for `setBusinessAccountName`, `setBusinessAccountUsername`, `setBusinessAccountProfilePhoto`, `removeBusinessAccountProfilePhoto`, etc.)*

***

### deleteBusinessMessages

Deletes messages in a connected business account.

| Parameter                | Type              | Required | Description                                                    |
| ------------------------ | ----------------- | -------- | -------------------------------------------------------------- |
| `business_connection_id` | String            | Yes      | Unique identifier of the business connection.                  |
| `chat_id`                | Integer or String | Yes      | Target chat ID.                                                |
| `message_ids`            | Array of Integer  | Yes      | A JSON-serialized list of 1-100 message identifiers to delete. |

***

## Gifts

Bots can interact with Telegram Gifts, querying available gifts and sending them to users.

### getAvailableGifts

Returns the list of gifts that can be sent by the bot to users.

***

### getUserGifts

Returns the list of gifts that were received by a specific user.

| Parameter | Type    | Required | Description                                     |
| --------- | ------- | -------- | ----------------------------------------------- |
| `user_id` | Integer | Yes      | Telegram user ID.                               |
| `offset`  | Integer | No       | Offset of the first entry to return.            |
| `limit`   | Integer | No       | Maximum number of gifts to be returned (1-100). |

***

### sendGift

Sends a gift to the given user. The bot must have enough Telegram Stars to send the gift.

| Parameter         | Type    | Required | Description                                                     |
| ----------------- | ------- | -------- | --------------------------------------------------------------- |
| `user_id`         | Integer | Yes      | Target Telegram user ID.                                        |
| `gift_id`         | String  | Yes      | Identifier of the gift.                                         |
| `pay_for_upgrade` | Boolean | No       | Pass `True` to pay for the gift upgrade from the bot's balance. |
| `text`            | String  | No       | Text shown along with the gift (0-255 characters).              |

```python BLP Example theme={null}
Bot.sendGift(
    user_id=u,
    gift_id="GIFT_ID_HERE",
    text="Thanks for being a loyal user!"
)
```

***

## Stars and Payments

### sendPaidMedia

Sends paid media to a chat. Users must pay the specified amount of Telegram Stars to view it.

| Parameter    | Type              | Required | Description                                                                         |
| ------------ | ----------------- | -------- | ----------------------------------------------------------------------------------- |
| `chat_id`    | Integer or String | Yes      | Target chat ID.                                                                     |
| `star_count` | Integer           | Yes      | The number of Telegram Stars that must be paid to buy access to the media (1-2500). |
| `media`      | Array of Object   | Yes      | A JSON-serialized array describing the media to be sent (up to 10 items).           |

```python BLP Example theme={null}
media = [{"type": "photo", "media": "AgACAgIAAxkBAAMrZN..."}]
Bot.sendPaidMedia(
    chat_id=u,
    star_count=50,
    media=jsondumps(media)
)
```

***

### getStarTransactions

Returns the bot's Telegram Star transactions.

| Parameter | Type    | Required | Description                                            |
| --------- | ------- | -------- | ------------------------------------------------------ |
| `offset`  | Integer | No       | Number of transactions to skip.                        |
| `limit`   | Integer | No       | Maximum number of transactions to be returned (1-100). |

***

### refundStarPayment

Refunds a successful payment in Telegram Stars.

| Parameter                    | Type    | Required | Description                                            |
| ---------------------------- | ------- | -------- | ------------------------------------------------------ |
| `user_id`                    | Integer | Yes      | Identifier of the user whose payment will be refunded. |
| `telegram_payment_charge_id` | String  | Yes      | Telegram payment identifier.                           |

```python BLP Example theme={null}
Bot.refundStarPayment(
    user_id=u,
    telegram_payment_charge_id="CHARGE_ID_HERE"
)
```

***

### getBusinessAccountGifts

Returns the list of gifts that were received by a business account.

| Parameter                | Type    | Required | Description                                   |
| ------------------------ | ------- | -------- | --------------------------------------------- |
| `business_connection_id` | String  | Yes      | Unique identifier of the business connection. |
| `offset`                 | Integer | No       | Offset of the first entry to return.          |
| `limit`                  | Integer | No       | Maximum number of gifts to be returned.       |

***

### getBusinessAccountStarBalance

Gets the Telegram Star balance of a connected business account.

| Parameter                | Type   | Required | Description                                   |
| ------------------------ | ------ | -------- | --------------------------------------------- |
| `business_connection_id` | String | Yes      | Unique identifier of the business connection. |

***

### getChatGifts

Returns the list of gifts that were received by a chat.

| Parameter | Type              | Required | Description                             |
| --------- | ----------------- | -------- | --------------------------------------- |
| `chat_id` | Integer or String | Yes      | Target chat ID.                         |
| `offset`  | Integer           | No       | Offset of the first entry to return.    |
| `limit`   | Integer           | No       | Maximum number of gifts to be returned. |

***

### getMyStarBalance

Gets the bot's own Telegram Star balance.

| Parameter | Type | Required | Description             |
| --------- | ---- | -------- | ----------------------- |
| *(none)*  | —    | —        | No parameters required. |

***

### editUserStarSubscription

Edits a user's star subscription (e.g. cancels it).

| Parameter                    | Type    | Required | Description                             |
| ---------------------------- | ------- | -------- | --------------------------------------- |
| `user_id`                    | Integer | Yes      | User ID.                                |
| `telegram_payment_charge_id` | String  | Yes      | Telegram payment identifier.            |
| `is_canceled`                | Boolean | Yes      | Pass `True` to cancel the subscription. |

***

### removeBusinessAccountProfilePhoto

Removes the profile photo of a connected business account.

| Parameter                | Type   | Required | Description                                   |
| ------------------------ | ------ | -------- | --------------------------------------------- |
| `business_connection_id` | String | Yes      | Unique identifier of the business connection. |

***

### setBusinessAccountGiftSettings

Changes gift settings of a connected business account.

| Parameter                | Type    | Required | Description                                   |
| ------------------------ | ------- | -------- | --------------------------------------------- |
| `business_connection_id` | String  | Yes      | Unique identifier of the business connection. |
| `is_enabled`             | Boolean | No       | True if the business allows receiving gifts.  |

***

### setBusinessAccountName

Changes the name of a connected business account.

| Parameter                | Type   | Required | Description                                   |
| ------------------------ | ------ | -------- | --------------------------------------------- |
| `business_connection_id` | String | Yes      | Unique identifier of the business connection. |
| `name`                   | String | Yes      | New name of the business account.             |

***

### setBusinessAccountProfilePhoto

Changes the profile photo of a connected business account.

| Parameter                | Type   | Required | Description                                   |
| ------------------------ | ------ | -------- | --------------------------------------------- |
| `business_connection_id` | String | Yes      | Unique identifier of the business connection. |
| `photo`                  | String | Yes      | File ID of the new photo.                     |

***

### setBusinessAccountUsername

Changes the username of a connected business account.

| Parameter                | Type   | Required | Description                                   |
| ------------------------ | ------ | -------- | --------------------------------------------- |
| `business_connection_id` | String | Yes      | Unique identifier of the business connection. |
| `username`               | String | Yes      | New username of the business account.         |

***

### transferBusinessAccountStars

Transfers Telegram Stars from a business account to the bot.

| Parameter                | Type    | Required | Description                                   |
| ------------------------ | ------- | -------- | --------------------------------------------- |
| `business_connection_id` | String  | Yes      | Unique identifier of the business connection. |
| `star_count`             | Integer | Yes      | Number of stars to transfer.                  |

***

### transferGift

Transfers a gift from the bot to another user.

| Parameter | Type    | Required | Description             |
| --------- | ------- | -------- | ----------------------- |
| `user_id` | Integer | Yes      | Target user ID.         |
| `gift_id` | String  | Yes      | Identifier of the gift. |