Telegram

Telegram tools let your AI assistant work with your own bot (bring your own token from @BotFather): send text and media, save notes to yourself, read what people sent the bot, and reply in threads.

You describe what you want in plain language. Sending and replying happen only after you confirm.

Setup

  1. Create a bot with @BotFather and copy the token.
  2. On your tenant’s Credentials tab in the app, add Telegram and paste the bot token. Optionally set your numeric Telegram user id as Owner user id.
  3. Enable the Telegram tools on the Tools tab.
  4. Open the bot in Telegram and press Start once (needed for “save to myself” and private replies).
  5. For groups: add the bot. By default bots only see commands and mentions; to read all group messages, disable privacy mode in BotFather (/setprivacy).

Saving the credential registers the hub webhook automatically when the server has a public https URL. You never paste the bot token into chat.

The tools

Tool Purpose
Resolve chat Turn @username, a title, or an id into a reusable chat_id
Send message Send text, optionally with buttons
Send media Send one photo, video, audio, document, or voice
Send rich Send a media album (and optional follow-up buttons)
Save to self DM yourself via the bot
Get updates Read what people sent the bot
Ack updates Mark updates as handled
Reply Reply in a thread to an inbound message

How they work together

Resolve chat     →  turn @channel into chat_id
Send message     →  post text (after you confirm)
Send media/rich  →  post photos or an album
Get updates      →  read new inbound messages
Reply            →  answer one of them (after you confirm)
Ack updates      →  mark those messages handled
Save to self     →  keep a result in your personal bot chat

What you need

Requirement Required?
Metraclick connection Yes
Telegram tools enabled Yes
Telegram bot token credential Yes
Pressed /start on the bot For save-to-self and private DMs

Related