# Connect your agent to Telegram

Source: https://kilat.host/docs/telegram-bot

Talk to your KilatBot agent on Telegram, without code and without a model key. You create the bot, paste its token, then decide who may talk to it.

## Before you start

- A KilatBot agent. If you don't have one yet, follow the [Quickstart](https://kilat.host/docs/quickstart).
- The Telegram app. Your agent starts on Kilat AI, so you don't need a model key.

## 1. Create a bot with BotFather

1. In Telegram, open **@BotFather** and send `/newbot`.
2. Choose a name and a username for your bot.
3. Copy the token BotFather sends you. Keep it private: anyone with it can control your bot.

## 2. Paste the token in Channels

1. Open your agent in the dashboard, then **Channels**.
2. Paste the token under **Bot token** and select **Save token**.
3. If Channels asks you to, start or restart the agent to apply it.

## 3. Message your bot and approve yourself

1. Send your bot any message. It replies with a pairing code.
2. In **Channels**, under **Who can talk to your agent**, select **Approve** next to your name, or type the code under **Or enter a pairing code**.
3. Send a test message and check that the reply is useful before you rely on it.

Nobody else can talk to your agent unless you approve them. Remove anyone later with **Remove access**.

## 4. In a team, choose whose Telegram it is

Only the workspace owner approves Telegram users. When you approve someone, choose their name under **Whose Telegram is it?**. Their role decides what that Telegram can do:

- The owner's Telegram can buy, after asking.
- An admin's can also save sign-ins.
- Anyone else's can chat and answer the agent's questions. Choose **Someone else (member rights)** for a person who isn't in the team.

Removing a person from the team takes their Telegram off the agent.

## 5. Or list who may talk to it

Under **Allowed Telegram users**, enter Telegram user IDs, one per line, up to 100. A person can find their ID by messaging **@userinfobot**. With IDs listed, strangers get no reply at all. The list applies to the next message, with no restart.

## What works on Telegram

- **Pictures and files** up to 20 MB, and **voice notes** up to 5 minutes.
- **Browsing.** Your agent browses in the background and replies with the result. When it needs a sign-in, it asks you to open the chat in the dashboard, where you take control.
- **Sleep.** Messages sent while your agent sleeps wait until it wakes.