Telegram

Connect a Telegram bot to your Magus agent so you can send messages and receive responses directly inside Telegram. This is useful for staying connected to your agents on mobile, sharing access with specific people, or building lightweight bots for your team.

How It Works

You create a Telegram bot via BotFather (Telegram’s official bot creation tool), then connect it to a Magus agent using the bot token. Once connected, anyone who messages your bot will go through an approval flow before they can interact with your agent. You control exactly who has access.

Step 1: Create a Bot in Telegram

1. Open Telegram and search for @BotFather
2. Send the command /newbot
3. Follow the prompts: choose a display name and then a username (must end in bot, e.g., myassistant_bot)
4. BotFather will reply with your bot token, a long string like 123456789:ABCdefGhijKlmnopQrsTuvwxyz

Copy this token and keep it somewhere safe. You’ll need it in the next step.

Step 2: Connect the Bot to Your Agent

1. Go to Agents and open the agent you want to connect
2. Navigate to the Integrations tab
3. Click Add Integration and select Telegram
4. Paste your bot token into the field
5. Save and activate the integration

Magus will verify the token and register a webhook with Telegram. Your bot is now live.

Step 3: The Approval System

When someone sends your bot a message for the first time, Magus does not route it to your agent immediately. Instead, you receive a notification asking whether to approve or deny that person’s access.

Approving a chat: Click Approve in the notification. The person’s message is forwarded to your agent, and they can continue the conversation normally. Their chat is now on the allowed list.

Denying a chat: Click Deny. The person receives a message saying their request was not approved, and no further messages from that chat are processed.

This approval step protects your agent from unexpected access. If your bot username is public, anyone could find it and try to message it. The approval system ensures only the people you’ve allowed can interact with your agent.

Managing Allowed Chats

You can view and manage all approved chats from the integration settings:

1. Open your agent’s Integrations tab
2. Click on the Telegram integration
3. The Allowed Chats section lists every approved user or group

From here you can:

• See when each chat was approved
• Remove a chat’s access by clicking Revoke

Removing Chat Access

To revoke someone’s access, find their chat in the Allowed Chats list and click Revoke. Their future messages will be silently ignored. They won’t receive a notification that their access was removed unless you tell them.

Tips

• Group chats: You can add your bot to a Telegram group. When someone in the group messages the bot, the same approval process applies.
• Bot privacy mode: By default, Telegram bots in groups only see messages that mention the bot directly. This is controlled by BotFather’s privacy settings, not by Magus.
• Rotating the token: If your bot token is compromised, generate a new one in BotFather (/mybots → select your bot → API Token → Revoke current token) and update it in the integration settings.
• Disconnecting: To remove the Telegram integration entirely, delete it from the Integrations tab. Magus will unregister the webhook and the bot will stop responding.