Telegram Publisher

Get a link to connect your Telegram account to this extension — open it in Telegram and tap Start. Needed once before you can link any channel.

Check whether the user has linked their Telegram account to this extension yet, and whether a photo is already attached and waiting for the next post.

List the Telegram channels/groups you've linked — where the bot has been added as admin after you connected your Telegram account.

Link a Telegram channel the bot is ALREADY an admin of, by its @username or numeric chat id. Only needed as a fallback: channels are normally picked up automatically when you add the bot as admin — in either order, before or after connecting your Telegram account. Use this when a channel still doesn't appear in list_telegram_channels, e.g. the bot was added to it long before this extension was set up, so Telegram never delivered the event.

Publish a post to one of your linked Telegram channels. Optionally attach a photo by URL, or leave photo_url empty to use the photo the user uploaded in the panel — a pending photo is picked up automatically and cleared once the post goes out. IMPORTANT: when the user says they attached a photo, just write the post and call this tool — the photo is already on Telegram's side and is attached by reference. You do NOT need to see, read or receive the image file, and you cannot: no tool returns image content. Never refuse or stall a post because the file is not visible to you; check get_telegram_connection_status if you want to confirm one is pending. Requires the bot to have 'Post messages' permission on that channel. ALWAYS a two-step flow: call it first WITHOUT confirm to produce a draft (shown in chat and DM'd to the author by the publishing bot itself), and only call it again with confirm=true after the author has approved that specific draft. Never publish on the first call — 'post it' authorises the draft, not the publication.

Unlink a Telegram channel from Imperal. Does NOT remove the bot from the channel on Telegram's side — do that manually if you also want the bot gone. Just makes Imperal forget about it.

Read recent posts from a linked PUBLIC channel via its public t.me/s/ preview page. Only works for channels with a public @username — private channels have no such page (Telegram's Bot API has no history-fetch method at all, this is the only backfill path).

Generate a draft post for a linked Telegram channel from a brief/topic — written within Telegram's own posting limits (character cap, limited HTML subset), and optionally matched to the channel's own tone by sampling its recent public posts. Does not post anything — hand the returned text straight to post_to_channel (confirm=false first) to preview and then publish it.

Attach an image to the NEXT post — upload it from the Telegram panel's photo picker. The file is sent to Telegram and kept as the pending photo until you publish a post or clear it. Only one photo can be pending at a time; uploading another replaces it. Files can ONLY arrive through the panel's upload widget — a file attached to a chat message never reaches this extension, so never invent the 'files' argument or claim a chat attachment was received.

Remove the pending photo so the next post goes out as text only. Does not delete anything already published.

Analyse a linked PUBLIC channel's post history in batches — walks back through the channel's posts page by page (not just the latest 20), then caches a digest: how many posts, typical/median post length, longest and shortest, recurring words, and the most recent post previews. Use when the user asks to analyse a channel, study its style, or asks how long its posts usually are. A deep scan runs in the background and reports back on its own. The cached digest is what makes the channel's style available as ambient context afterwards.