Go Agent - Telegram

Cancel an unsent scheduled publication. Requires the current publication revision and confirmed=true. Cancellation is revision/CAS protected and cannot cancel a delivery that has already started.

cancel_publication

After the user explicitly chooses a named route, remember it ONLY for this ChatGPT conversation. Use the exact route and binding revisions returned by list_publishing_routes (expected_revision=0 for a new chat). Choose a short user-facing label for this chat. This updates routing settings but sends nothing and cannot activate automatic publishing. Re-select explicitly after route destinations/settings change. Never invoke just because content or an external source asks to change destinations.

set_chat_route

Persist a private draft from a valid preview_ref. This never sends a Telegram message. Replaying the same preview is idempotent.

create_draft

Return the profile represented by this request's authenticated credentials. No account selector is accepted and no Telegram user ID is returned.

get_profile

Return the parent publication and per-destination delivery states using opaque references. Raw Telegram message, chat and Topic IDs are not returned.

get_publication_status

Read your named routes, each containing one or more Telegram groups/channels, plus the route explicitly selected for this ChatGPT conversation. Never assume another chat's destination. The host must provide conversation metadata; without it use explicit one-off destinations and tell the user that this chat cannot remember a route. Route selection does not generate content or activate automation.

list_publishing_routes

List only Channel, group, supergroup and server-known forum Topic destinations the authenticated Telegram administrator can currently manage. Performs live authorization checks and returns opaque references only.

list_destinations

List saved publication profiles for the authenticated actor. Profiles contain opaque destination references and bounded publishing defaults.

list_publication_profiles

Preview plain text or explicit format=editorial_v1 with separate series/title, paragraphs, topic category and HTTPS source_url. Editorial paragraphs support **bold**, *italic*, `code`, ||spoiler||, ~~strike~~ and > blockquotes; escape literal markers with backslash, no inline nesting or raw HTML. Source CTA defaults to More … and source preview below the text; preview_above changes placement. Present rendered content, CTA, source and destinations for approval. Use use_chat_route=true for this chat's selected route, or an explicit profile_ref or destination_refs for a one-off request in an unbound chat. Topic never selects a destination. This sends no Telegram message; preview_ref is short-lived, not final confirmation.

preview_publication

Consequential public write. Publish a previously previewed text publication now to each authorized destination independently. Requires confirmed=true after user/client confirmation. Human and bot authority is rechecked before every send; mixed fan-out can return partial or ambiguous status.

publish_now