Bifrost Send — Telegram Messaging

What is it?

Bifrost Send is Yukkai's dedicated tool for delivering messages and media to Telegram. It acts as a bridge between your Yukkai assistant and your Telegram account, so anything Yukkai produces — a summary, a generated image, a document, a voice note — can be pushed straight to your phone or any Telegram chat.

It is the only supported method for sending Telegram messages from within Yukkai. External scripts or alternative libraries are not used; everything flows through Bifrost Send for security and reliability.

How it works

Bifrost Send connects to the Telegram Bot API using credentials configured during Yukkai setup. When you ask Yukkai to send something to Telegram, it calls the appropriate Bifrost Send action with your content, and the message appears in the target chat within seconds.

Key concepts:

• Owner chat — By default, messages go to the owner chat, which is the first Telegram user who authorised the bot. You don't need to specify a chat ID for normal use.
• Chat ID — If you want to send to a different chat (a group, a channel, or another user), you provide a chat_id. Yukkai can look up or remember chat IDs for you.
• Transport — All messages use the telegram transport. This is set automatically; you never need to configure it manually.

How to use it

Simply ask Yukkai in natural language:

• "Send this summary to my Telegram."
• "Send the photo you just generated to Telegram."
• "Forward this document to my work group on Telegram."

Yukkai will pick the right action and deliver the content. Below are the six actions Bifrost Send supports.

Available actions

Action	What it sends	Key parameters
send_text	Plain text message	text
send_photo	Image (PNG, JPG, etc.)	file_path or url, optional caption
send_document	Any file (PDF, ZIP, etc.)	file_path or url, optional file_name, caption
send_audio	Audio file (MP3, etc.)	file_path or url, optional caption
send_video	Video file (MP4, etc.)	file_path or url, optional caption
send_voice	Voice message (OGG/OPUS)	file_path or url
status	Connection status and active chats	none

All actions accept an optional chat_id to target a specific chat. If omitted, the message goes to your owner chat by default.

Examples

Send a text message

Ask Yukkai:

"Send a message to my Telegram saying 'The build finished successfully.'"

Internally, Yukkai calls:

bifrost_send → send_text
  text: "The build finished successfully."

Send a generated image

"Generate a sunset wallpaper and send it to Telegram."

Yukkai generates the image, then:

bifrost_send → send_photo
  file_path: /path/to/sunset.png
  caption: "Here's your sunset wallpaper 🌅"

Send a document

"Send the weekly report PDF to my work group."

bifrost_send → send_document
  chat_id: -1001234567890
  file_path: /path/to/report.pdf
  file_name: "weekly-report.pdf"
  caption: "Weekly report — Week 42"

Send a voice note

"Record a voice summary and send it to Telegram."

bifrost_send → send_voice
  file_path: /path/to/summary.ogg

Check connection status

"Is my Telegram still connected?"

bifrost_send → status

Yukkai will report whether the connection is active and list your available chats.

Tips & best practices

• No chat ID needed for personal use. If you just want messages on your own phone, Yukkai defaults to your owner chat. You only need a chat_id when sending to groups, channels, or other people.
• Captions are optional but useful. For photos, documents, audio, and video, adding a short caption helps provide context — especially when sending to groups where multiple people receive the message.
• Use local files or URLs. Every media action accepts either a local file_path or a remote url. If Yukkai just generated or downloaded a file, it will use the local path automatically.
• Status check when in doubt. If messages aren't arriving, ask Yukkai to check the Telegram connection status. This verifies the bot is reachable and lists your active chats.
• One tool, one channel. Bifrost Send is purpose-built for Telegram. If you need to send messages on other platforms (Slack, Discord, etc.), those are separate integrations — Telegram always goes through Bifrost Send.
• Large files. Telegram has a 50 MB limit for bot API uploads. If you need to send something larger, consider sharing a download link instead of the file itself.