Skip to main content

Use Telegram with SmythOS

Enable your agents to communicate directly through Telegram channels or chats using message or audio formats.

INFO

TL;DR: Connect your Telegram bot via API token, choose a message or audio component, and trigger delivery from your agent.

Why Use Telegram With Your Agent?

Telegram offers broad reach, high delivery rates, and a frictionless messaging UX. It's ideal for:

  • Pushing alerts or content to a known user base
  • Sending automated updates from agents
  • Audio-based interactions via agent-generated voice
  • Building brand presence in community channels

With SmythOS, you can either connect directly via components or use the Model Context Protocol (MCP) to serve your agent over a webhook server, which Telegram bots can poll for messages.

Prerequisites

To use Telegram integrations, you'll need:

  • A Telegram bot (created via BotFather)
  • Your bot's API token
  • A chat ID or channel username (@handle)
  • Optionally, Vault access for securely storing tokens

Deploy Options

1. Use Telegram Components Directly

This works well if your agent pushes notifications, answers predefined requests, or sends scheduled updates.

  • Send Message: For short text replies or updates
  • Send Audio: To deliver voice responses (e.g., paired with ElevenLabs)

Follow the configuration steps below to connect these components to your workflows.

2. Deploy Agent via MCP and Connect to Telegram Bot

If you want Telegram to receive user messages and trigger agent replies, deploy your agent with MCP:

  • Deploy your agent as an MCP webhook
  • Use a Telegram bot that calls this webhook on each message
  • Relay response back to Telegram via your bot code or SmythOS component

This setup enables fully conversational agents inside Telegram.

Send Message

Component Setup

  1. Create a Telegram bot via BotFather
  2. Copy the API token
  3. Paste it into the Send Message component settings
  4. Optionally store it in Vault → API Keys

Inputs

{
"chat_id": "@channelusername",
"text": "Hello from SmythOS!"
}
  • chat_id: Telegram chat or channel identifier
  • text: Message content (max 4096 characters)

Outputs

  • response: Telegram response object
  • headers: HTTP headers from the request
  • messageId: Unique ID of the sent message

Send Audio

Component Setup

Same setup as above; reuse your Telegram bot API token.

Inputs

{
"chat_id": "@channelusername",
"audio_url": "https://example.com/audio.mp3"
}
  • chat_id: Target Telegram chat or channel
  • audio_url: Direct URL to an audio file

Tip: You can use ElevenLabs to generate voice from text and pass the result here.

Outputs

  • response: Result of audio delivery
  • headers: HTTP response metadata
  • messageId: Telegram-generated message ID

What’s Next?

  • Monitor your message or audio delivery in Agent Logs
  • Use this with Deploy as API to send Telegram messages on external events
  • Chain outputs to other systems or notifications
  • Deploy over Custom Domain to enable branded responses
Set up a Telegram bot and connect it to your SmythOS agent using either direct components or MCP deployment.