Telegram
Messaging integration · 7 node(s) including 1 trigger.
00Overview
Telegram Bot messaging operations
Every field below is exactly what you see in the Flomation editor. Fields marked ● live picker let you choose from a list pulled live from your account — no IDs to look up.
01Connecting Telegram
Add your credentials as a Flomation environment secret, then pick them in each node. The connection fields are:
| Field | Type | Details | |
|---|---|---|---|
| Telegram Bot Token | secret | Required | 123456:ABC-DEF... |
${secrets.your_secret}.02Send
Send Telegram Audio
messaging/telegram/send_audio · Action
Send a music/audio file (MP3, M4A, WAV) via Telegram. Use send_voice for spoken-word voice notes. NEVER use for video files (incl. Gemini/Veo output) — use send_video instead so the visual track is preserved.
| Field | Type | Details | |
|---|---|---|---|
| Telegram Bot Token | secret | Required | 123456:ABC-DEF... |
| Chat/Channel ID | string | Required | ${flow.channel_id} |
| Audio to send (flo:blob: token from an upstream action) | string | ||
| Audio bytes as base64 (alternative to file_blob) | string | ||
| Track title (optional) | string | ||
| Artist / performer (optional) | string | ||
| Duration in seconds (optional) | integer | ||
| Caption text shown alongside the audio | string |
Returns: tool_result, message_id, audio_size_bytes, success, error
Send Telegram Document
messaging/telegram/send_document · Action
Send a file via Telegram. Accepts a flo:blob token or base64.
| Field | Type | Details | |
|---|---|---|---|
| Telegram Bot Token | secret | Required | 123456:ABC-DEF... |
| Chat/Channel ID | string | Required | ${flow.channel_id} |
| File to send (flo:blob: token from an upstream action) | string | ||
| File bytes as base64 (alternative to file_blob) | string | ||
| Filename shown to recipient | string | document.pdf | |
| Caption text shown alongside the file | string |
Returns: tool_result, message_id, file_size_bytes, success, error
Send Telegram Message
messaging/telegram/send_message · Action
Send a message via the Telegram Bot API
| Field | Type | Details | |
|---|---|---|---|
| Bot Token | secret | Required | 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11 |
| Channel ID | string | Required | ${flow.channel_id} |
| Message | text | Required | Hello from Flomation! |
| Parse Mode | string | choices: None, HTML, MarkdownV2 | |
| Reply Markup (JSON) | text | {"inline_keyboard":[[{"text":"Approve","callback_data":"yes"}]]} |
Returns: tool_result, message_id, success, error
Send Telegram Photo
messaging/telegram/send_photo · Action
Send a photo via Telegram. Accepts a flo:blob image token or base64.
| Field | Type | Details | |
|---|---|---|---|
| Telegram Bot Token | secret | Required | 123456:ABC-DEF... |
| Chat/Channel ID | string | Required | ${flow.channel_id} |
| Image to send (flo:blob: token from an upstream action) | string | ||
| Image bytes as base64 (alternative to file_blob) | string | ||
| Caption text shown beneath the photo | string |
Returns: tool_result, message_id, photo_size_bytes, success, error
Send Telegram Video
messaging/telegram/send_video · Action
Send a video (MP4, with or without audio track) via Telegram. THE CORRECT CHOICE for output from Gemini Video / Veo and any other video file. Accepts a flo:blob token or base64. Do NOT use send_voice or send_audio for video files — those strip the visual track.
| Field | Type | Details | |
|---|---|---|---|
| Telegram Bot Token | secret | Required | 123456:ABC-DEF... |
| Chat/Channel ID | string | Required | ${flow.channel_id} |
| Video to send (flo:blob: token from an upstream action) | string | ||
| Video bytes as base64 (alternative to file_blob) | string | ||
| Caption text shown beneath the video | string | ||
| Video duration in seconds (optional) | integer | ||
| Video width (optional) | integer | ||
| Video height (optional) | integer |
Returns: tool_result, message_id, video_size_bytes, success, error
Send Telegram Voice
messaging/telegram/send_voice · Action
Send a SHORT AUDIO-ONLY voice note via Telegram (OGG/OPUS, like a WhatsApp voice message). NEVER use for video files — Telegram strips the video track and only the audio will play. For video files (incl. Gemini/Veo video output) use send_video. For music files use send_audio.
| Field | Type | Details | |
|---|---|---|---|
| Telegram Bot Token | secret | Required | 123456:ABC-DEF... |
| Chat/Channel ID | string | Required | ${flow.channel_id} |
| Audio data (base64). Wire from an upstream TTS or audio action. | string | Required | |
| Caption text shown alongside the voice message | string |
Returns: tool_result, message_id, audio_size_bytes, success, error
03Triggers
Telegram Trigger
trigger/telegram · Trigger
Triggers a flow when a Telegram message is received
| Field | Type | Details | |
|---|---|---|---|
| Bot Token | secret | Required | ${secrets.telegram_bot_token} |
| Allowed Chat IDs (optional, comma-separated) | string | 12345678, -100987654 |
Returns: chat_id, chat_type, chat_title, sender, sender_id, sender_username, sender_name, message_text, message_id, content, agent_id, channel_type, date
04Notes & Limitations
Behaviours and constraints worth knowing before you build with these nodes.
- Bots can only message a person or group after that chat has first started or added the bot, so you cannot send to an arbitrary user who has never interacted with it.
- Voice notes must be OGG/OPUS audio-only files; sending a video through the voice or audio nodes strips the visual track and only the sound will reach the recipient.
- Files sent through these nodes are capped at 50 MB each by the Bot API, regardless of the source blob's size.
- Message text is limited to 4096 characters and media captions to 1024 characters; longer content is rejected rather than truncated.