> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agenium.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Telegram

> An agent's access to a personal Telegram account.

Telegram works over a personal Telegram account: read and search a chat, list a forum's topics, send text, media and reactions into a chat or one of its topics, export history, and transcribe voice and audio. It has an assistant service that answers in Telegram for the agent.

## In Agenium

* **Setup** asks once per Mac for your own Telegram app, its `api_id` and `api_hash` from my.telegram.org, and shows whether Telegram accepts it.
* **Add** links an account by a QR code scanned from the Telegram app, then the two-step password if the account has one; logging in by phone number and code is the second way.
* Its settings, each agent's own, show in four tabs: **Chats**, **Roles**, **Defaults & prompts** and **JSON**.
* Voice transcription uses the Mac's Deepgram key from [Settings > Transcription](https://docs.agenium.io/app/settings.md#transcription).

See [Connect a Telegram account](https://docs.agenium.io/recipes/connect-telegram-account.md).

## Reference

`telegram help` gives every command, and `telegram doctor` checks it is ready; `telegram guide` lists its guides.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.