Post to Telegram
post_to_telegramPublish text, images, videos, albums, buttons, or files directly to a Telegram channel, group, or chat as the brand's own bot.
Instructions
Use this when the user wants to post to a Telegram channel or group. Publishing costs no credits. Publish to a Telegram channel, group or chat as the brand's own bot. WHICH CHAT IS ALWAYS REQUIRED AND IS NEVER GUESSED: pass chatId as the public channel's @username (e.g. @yourchannel) or its numeric id (a group is negative; a supergroup or channel starts with -100). THE BOT MUST BE IN THE CHAT — an administrator with Post Messages for a channel, an unrestricted member for a group; if it is not, Telegram refuses and the error says to add it rather than to reconnect. 0 credits. Connect at Connectors > Telegram. Full rules: get_instructions({topic:'post_to_telegram'}).
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": {
"chatId": "<chatId>"
},
"name": "post_to_telegram"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hook | No | the post's angle — a list_hooks id or your own wording, reused exactly | |
| text | No | the message. ≤4096 characters on its own; ≤1024 once any image or video is attached. | |
| brand | No | WHICH PROFILE this post belongs to — id or exact name from list_brands (a shared workspace: its profile id). Beats the connection's pin for THIS CALL ONLY; a name that matches no profile, or two, is REFUSED and nothing is posted. | |
| chatId | Yes | REQUIRED — the destination: a public channel's @username, or the numeric chat id. Never guessed; ask the user, or use list_telegram_chats. | |
| ideaId | No | short id of the content-plan idea this post came from | |
| recipe | No | the post's FORMAT id, e.g. "slideshow" or "imessage_chat" — post_performance groups by it, so reuse one id per format | |
| silent | No | deliver without a notification sound (Telegram’s silent-delivery setting). This is NOT a visibility setting — the message is just as visible. | |
| account | No | WHICH connected account of this channel to post as — its @handle or id from list_connector_accounts. Needed only when the profile has more than one telegram account connected (several and none named is refused by name, never guessed); omit when there is one. | |
| buttons | No | URL BUTTONS under the post, Telegram's call to action: [{text:'Shop now', url:'https://…'}] one per row, or rows [[a,b],[c]]. URL buttons only (https://, http:// or tg://), optional style danger|success|primary. A single photo, a video or a text post can carry them; an ALBUM cannot (Telegram's sendMediaGroup takes no buttons), so that combination is refused. | |
| subject | No | what the post is about | |
| imageUrl | No | one image (≤10MB after upload); a URL, not a local file path; use upload_file for local files | |
| videoUrl | No | one video (≤50MB). Passed alongside imageUrls it joins the album as one more item; a URL, not a local file path; use upload_file for local files | |
| coverAtMs | No | THE VIDEO COVER in the chat, as ONE frame: milliseconds from the start (7000 = the frame at 7s). Sent as Telegram’s cover image; beats platformCover. | |
| imageUrls | No | an ALBUM of 2–10 media, in order. Photos and videos may be mixed — Telegram allows it. | |
| parseMode | No | 'HTML' to format the text with Telegram's HTML: <b>, <i>, <u>, <s>, <a href="…">, <code>, <pre>, <blockquote>, <tg-spoiler>. Omit for plain text (the default). In HTML mode a literal <, > or & in the copy must be written < > &, which is why it is never turned on by itself. Markdown (**bold**) is NOT parsed; convert it to HTML tags. | |
| documentUrl | No | send a FILE (≤50 MB) as the post, text as caption; not with image/video | |
| platformCover | No | VIDEO COVER. Omit it (the default) and Hermoso sets the video’s best frame — the same frame as its Library thumbnail — as the cover (Telegram’s in-chat video cover). true = send no cover and let the platform pick (usually the first frame). A cover you pass yourself always wins. | |
| allowDuplicate | No | post it even though an identical post was just made | |
| disablePreview | No | suppress the link-preview card on a text-only post. Default is Telegram’s own behaviour (previews on). | |
| idempotencyKey | No | any stable string: a repeat within 24h returns the original post instead of posting again | |
| protectContent | No | no forwarding or saving |