How Telegram Mini Apps Send Gifts with Stars: Achievement Rewards, In-Game Milestones & Profile Showcases

In traditional mobile gaming, when users spend real currency on in-app items, the value is locked inside the game database. If a player achieves a world-first record or wins an esports cup, they rarely receive tangible assets recognized outside the application. Telegram transforms this paradigm with Bot-to-User Gift Rewards. Because Mini Apps generate revenue in Telegram Stars, developers can reinvest their Star balances directly into official Telegram Gifts. When a player wins a tournament, the bot triggers an automated Star transaction, purchasing an animated gift and transferring it directly to the player's personal Telegram account.

Bots and Mini Apps issue gifts through the official Bot API sendGift endpoint, deducting Stars directly from the bot's developer balance:

// POST https://api.telegram.org/bot<token>/sendGift
{
  "user_id": 948102841,
  "gift_id": "5284019284192",
  "text": "Congratulations on winning Season 4 Championship! 🏆",
  "text_parse_mode": "HTML"
}

// Successful Response Payload
{
  "ok": true,
  "result": {
    "gift": {
      "id": "5284019284192",
      "sticker": { ... },
      "star_count": 250,
      "total_count": 10000,
      "remaining_count": 4120
    }
  }
}