Manage the Telegram Business account
manage_telegram_businessManage a Telegram Business account: post, edit, delete and repost stories, update the profile, handle gifts, check stars balance and transfer stars, with a preview step before anything is sent.
Instructions
A Telegram Business account (the user's own Telegram account) connected to the profile's bot. Fields go in params with the API's names; business_connection_id picks the connection when the bot has several. connections (rights and whether each is enabled); get_profile; update_profile (first_name, last_name, username, bio, media_url for the photo with is_public, remove_photo, gift_settings); stories posted as the account: post_story (media_url: photo 1080x1920 up to 10 MB or video 720x1280 up to 30 MB and 60 s; active_period, caption, areas, post_to_chat_page, protect_content), edit_story (story_id and the fields), delete_story (story_id), repost_story (from_chat_id, from_story_id, active_period); gifts (the account's gifts), manage_gift (action convert|upgrade|transfer|delete, owned_gift_id, idempotency_key; irreversible, needs confirm); stars_balance, transfer_stars (star_count 1-10000 to the bot, idempotency_key; needs confirm). Needs the user's approval: call it first without confirmed to get a preview (nothing is sent), show the user exactly what will go out, and repeat the call with confirmed: true only after they approve.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"action": "<action>",
"user": "<user>"
},
"name": "manage_telegram_business"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| user | Yes | Upload-Post profile name with Telegram connected. | |
| action | Yes | ||
| params | No | Other API fields for this action, with the REST API's own names (snake_case) and shapes. See the description for each action's fields. Leave out what you do not want to change. | |
| confirm | No | The API's own confirmation for deletions and other changes that cannot be undone. Set it to true only after the user has approved that exact change; without it those actions are refused and nothing changes. | |
| confirmed | No | Set to true only after the user has seen the preview this tool returns without it and approved it. Without it nothing is sent. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | No |