Telegram
Arcade.dev LLM tools for Telegram
1.0.1Telegram toolkit provides Arcade tools for interacting with Telegram via a bot, enabling LLMs to send messages, retrieve chat data, and deliver AI-generated audio in Telegram chats, groups, and channels.
Capabilities
- Bot identity & chat metadata — Retrieve the bot's own profile and capabilities, and look up metadata (type, title, description, member count) for any chat the bot belongs to.
- Message retrieval — Fetch pending private-chat messages delivered to the bot via Telegram's
getUpdatesAPI; group/channel messages are excluded by design. Offset handling permanently acknowledges earlier updates. - Messaging — Send text messages to any chat, group, or channel where the bot has send permissions.
- Text-to-speech audio — Convert text to an MP3 using OpenAI TTS and deliver it as an audio message to a Telegram chat.
Secrets
This toolkit requires two secrets:
-
TELEGRAM_BOT_TOKEN— The API token that authenticates your Telegram bot. Create a bot and obtain its token by messaging @BotFather on Telegram, using the/newbotcommand (or/tokenfor an existing bot). BotFather returns a token in the format123456789:ABC-.... No special account tier is required. See Telegram Bot API docs for details. -
OPENAI_API_KEY— An OpenAI API key used to call the TTS endpoint forTelegram.SendTtsAudio. Generate one in the OpenAI platform dashboard under API keys. The key needs access to thetts-1ortts-1-hdmodel; ensure your account has an active billing plan, as TTS is not available on the free tier.
Configure secrets in Arcade at https://docs.arcade.dev/en/guides/create-tools/tool-basics/create-tool-secrets or via the dashboard at https://api.arcade.dev/dashboard/auth/secrets.
Available tools(5)
| Tool name | Description | Secrets | |
|---|---|---|---|
Get metadata about a Telegram chat, group, or channel.
Returns information including the chat type, title, description, and member count.
The bot must be a member of the chat to retrieve its information. | 1 | ||
Get recent private-chat messages sent to the bot via Telegram's getUpdates API.
Returns messages from private (1:1) chats only. Group and channel messages are
excluded for security — any group member could inject content into the response.
Only pending (unacknowledged) updates are returned.
The limit parameter controls how many raw Telegram updates are fetched, not how
many messages are returned. After filtering to private-chat messages for the
requested chat_id, the result may contain fewer items. has_more indicates whether
more updates exist on the server, not whether more messages exist for this chat.
Note: This retrieves updates delivered to the bot, not the full history of a chat.
Passing a non-zero offset permanently confirms all earlier updates — they cannot be
retrieved again. Returns newest messages last. | 1 | ||
Send a text message to a Telegram chat, group, or channel.
The bot must be a member of the target chat or have permission to send messages
to the specified channel. | 1 | ||
Convert text to speech using OpenAI TTS and send it as an audio message on Telegram.
Generates an MP3 audio file from the provided text using OpenAI's text-to-speech API,
then sends it to the specified Telegram chat. | 2 | ||
Get information about the Telegram bot.
Returns the bot's identity including its ID, username, and capabilities. | 1 |