Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
| 1 | ## How do I connect Telegram with a bot token? |
| 2 | |
| 3 | Telegram doesn't support OAuth. Composio connects to a Telegram bot using the bot token from BotFather. The connection acts as the bot, not your personal Telegram account. |
| 4 | |
| 5 | ### Create the Telegram bot |
| 6 | |
| 7 | 1. In Telegram, start a chat with [@BotFather](https://t.me/BotFather) and send `/newbot`. |
| 8 | |
| 9 |  |
| 10 | 2. Enter a display name for the bot, then a username that ends in `bot`, for example `composio_test_bot`. |
| 11 | |
| 12 |  |
| 13 | 3. Copy the bot token BotFather returns. It looks like `123456:ABC-DEF1234ghIkl`. For an existing bot, send `/token` to BotFather to get it. |
| 14 | |
| 15 |  |
| 16 | |
| 17 | The token gives full control of the bot, so store it securely. |
| 18 | |
| 19 | ### Create the auth config in Composio |
| 20 | |
| 21 | 1. In the Composio dashboard, go to **Auth Configs**, click **Create Auth Config**, and select **Telegram**. |
| 22 | |
| 23 |  |
| 24 | |
| 25 |  |
| 26 | 2. Keep the authentication type as **API Key** and click **Create Auth Config**. |
| 27 | |
| 28 |  |
| 29 | 3. Click **Connect Account**, paste the bot token, and confirm the account shows as **Active**. |
| 30 | |
| 31 |  |
| 32 | |
| 33 | See [Custom auth configs](/docs/auth-configuration/custom-auth-configs) for the general flow. |
| 34 | |
| 35 | ### Permissions |
| 36 | |
| 37 | Telegram bots don't use scopes. What the bot can do depends on which chats, groups, and channels you add it to, and on the admin rights you give it there. |