@devries-cameron20 / composio Mirror · read-only
Fork 0

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

Mirrored from https://github.com/Camo67/composio.git

Synced Nov 21, 06:00 UTC

next
md 37 lines 2 KB
Rendered Raw
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 ![Telegram search results for @BotFather](/images/toolkits/telegram/botfather-search.webp)
10 2. Enter a display name for the bot, then a username that ends in `bot`, for example `composio_test_bot`.
11
12 ![BotFather chat after /newbot asking for the bot name and username](/images/toolkits/telegram/newbot.webp)
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 ![BotFather confirmation message with the bot token redacted](/images/toolkits/telegram/bot-token.webp)
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 ![Composio Auth Configs page with the Create Auth Config button](/images/toolkits/shared/wIAvY0hheAM7HQEF4kG2KTYATY.webp)
24
25 ![Composio toolkit picker with Telegram and its API_KEY badge](/images/toolkits/telegram/select-toolkit.webp)
26 2. Keep the authentication type as **API Key** and click **Create Auth Config**.
27
28 ![Telegram auth config form with API KEY as the authentication method](/images/toolkits/telegram/api-key-auth-method.webp)
29 3. Click **Connect Account**, paste the bot token, and confirm the account shows as **Active**.
30
31 ![Composio connect screen with the Bot Token field, value redacted](/images/toolkits/telegram/connect-bot-token.webp)
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.