Minds · Guides · Integrations
Link your Mind with Telegram.
Two steps — link your Telegram account once, then point a fresh bot at your Mind. Anyone who messages that bot is talking directly to your Mind — memory, tools, and personality intact.
Meet users where they already are
Your Mind lives inside Telegram. No app to install, no account to create, users just message the bot.
Full memory across surfaces
Every Telegram conversation feeds the same long-term memory as the web chat. Your Mind knows the history regardless of which surface it last heard from a user.
Proactive by default
Once linked, your Mind can send messages on a schedule or trigger, not just wait to be asked. Configure triggers and schedules inside the Mind's tool config.
Before you start
What you'll need.
A Mind on hellominds.ai
Any Mind works, it just needs to exist. Don't have one yet? Start with the Build Guide
A Telegram account
Mobile, desktop, or web, any client works. You'll also use BotFather, Telegram's official bot for creating bots.
About 10 minutes
The actual linking takes ~2 minutes once you know the steps. Budget a little extra the first time.
Popups allowed for hellominds.ai
Critical. The Telegram account link opens in a separate popup window. If your browser blocks it, the page silently hangs.
Important, two different steps
Account link and Bot link are not the same thing.
1 · Account link (once per user)
Connects your Minds account to your personal Telegram identity via OAuth. Done once, applies to every Mind you own.
2 · Bot link (once per Mind)
Wires a specific Telegram bot to a specific Mind by pasting a BotFather API token. The Bot section is grey-locked until the Account link is complete.
Link your Telegram account
Tell Minds who you are on Telegram.
This is an OAuth step — you're authorising Minds to verify your Telegram identity. It opens a popup window, so make sure popups are allowed for hellominds.ai before you start.Open /profile and find the "Telegram Link Account" button.
Go to hellominds.ai/profile. The top of the page shows your account card with two integration buttons side-by-side: "X / Twitter Link Account" and "Telegram Link Account". Click the Telegram one.
A popup window appears, confirm your Telegram identity.
Telegram's official Login Widget opens in a separate browser window. It asks "Log in to Minds?" with your Telegram handle shown. Confirm. If you are not already logged into Telegram in this browser, it will ask for your phone number first.
The popup closes on its own.
After you confirm, the popup closes automatically and the profile card updates to show your Telegram handle. The "Telegram Link Account" button is replaced by your handle (e.g. @YourTelegramHandle). The Bot section on every Mind you own is now unlocked.
Stuck on "Linking…" forever?
Your browser blocked the OAuth popup. The profile page is waiting on a message from a window that was never allowed to open. To fix it: allow popups for hellominds.ai in your browser settings, then refresh the page and click Link Account again. There is no in-page retry button, a full page refresh is the only recovery.
Create a bot with BotFather
Get a bot token from Telegram.
BotFather is Telegram's official bot for creating and managing other bots. You'll have a short conversation with it and it will give you a token — a string that Minds uses to control the bot on your behalf.Open BotFather directly.
Go to t.me/BotFather and click OPEN IN WEB. Do not search "BotFather" in Telegram's left-pane search, BotFather is invisible there until you've chatted with it at least once. The direct link always works.
Click the "START" button at the bottom of the chat.
BotFather sends its full command list. You can ignore most of it, you only need /newbot for this guide.
Send /newbot.
Type /newbot in the message box and click the paper-plane send button. BotFather replies: "Alright, a new bot. How are we going to call it? Please choose a name for your bot."
Send the display name.
This is the name users see at the top of the chat. Spaces and most characters are allowed. Example: "Acme Support Bot". BotFather confirms and asks for a username next.
Send the username.
Bot usernames must end in bot, contain only letters, numbers, and underscores, and be globally unique across all of Telegram. Example: acme_support_bot. If your first choice is taken, BotFather says so and asks again, no need to restart.
Copy the token BotFather gives you.
On success, BotFather replies: "Done! Congratulations on your new bot." and includes a line starting with "Use this token to access the HTTP API:" followed by a string in the form numeric_id:35-character-string. Copy that entire string, you'll paste it into Minds in Step 3.
Keep your token private.
Anyone with the token can drive your bot, send messages, change its name, read its
conversations. Treat it like a password. If you accidentally share it, open BotFather, send
/revoke, select the
bot, and paste the new token into Minds using the Update
button.
Using Telegram Web?
Use web.telegram.org/k/#@BotFather , the /k/ client follows the deep link directly into the BotFather chat. The /a/ client silently ignores the hash and lands on your chat list instead. Also: if your message appears as "Draft" rather than sending, click into the input field explicitly and use the send button rather than pressing Enter.
Connect the bot to your Mind
Paste the token. Done.
Back on Minds, you'll paste the token into a single field. The platform registers a webhook with Telegram in a few seconds and the bot is live.Open your Mind's detail page.
From hellominds.ai/profile, click the Mind you want to wire up. You land on the Mind detail page.
Find the "Telegram Integration" panel.
It has two columns: Account and Bot. The Account column already shows your Telegram handle from Step 1. The Bot column now has an active "Link Bot" button.
Click "Link Bot".
A modal titled "Link Telegram Bot" opens with a single Bot Token field and placeholder text "Enter Telegram Bot Token".
Paste the token and click Link Bot.
Paste the token you copied from BotFather. Click Link Bot. The button briefly shows Linking… while the platform registers a webhook with Telegram.
Confirm the green Linked badge.
The modal closes and the Bot column shows a green Linked badge alongside two new buttons: Update (swap to a new token) and Unlink (disconnect the bot).
Send your Mind a message on Telegram.
Open your bot, t.me/your_bot_username, press START, and send a message. Your Mind responds. Make sure the Mind's status is set to Online on the detail page, and that it has Cognition credits available.
What "Linked" means.
From this moment, every message any user sends to that bot is routed to your Mind. Replies use the same memory, tools, and persona as the web chat, it's one Mind, multiple surfaces. The bot belongs to your Telegram account; the connection belongs to this Mind. One bot can only be linked to one Mind at a time.
UI reference, what each state looks like
Before account link
Link Account (button)
Disabled, greyed out with helper text
After account link
@YourTelegramHandle
Link Bot (active button)
After bot link
@YourTelegramHandle
✓ Linked · Update · Unlink
Troubleshooting
"Linking…" never finishes.
Almost always a popup blocker. The Telegram OAuth window opened and was killed by your browser, the profile page is still waiting on a message that will never arrive. Allow popups for hellominds.ai, refresh /profile, and click Link Account again. There is no in-app retry, only a page refresh recovers you.
BotFather doesn't appear in Telegram search.
Telegram global search excludes bots you have never chatted with before. Open BotFather directly at t.me/BotFather or use the deep link web.telegram.org/k/#@BotFather. Once you have chatted with it at least once, you’d be able to search for it on the left pane search.
My message to BotFather is stuck as Draft.
A quirk of Telegram Web's /k/ client. Click directly into the message input field first, then type your command, then click the paper-plane send button. Pressing Enter alone sometimes leaves the message in a Draft state.
Username already taken.
Bot usernames are globally unique across all of Telegram. Try adding a descriptor, project initial, or year, for example my_support_bot_2026. BotFather tells you immediately if a name is taken and lets you try again without restarting the /newbot flow.
Bot replies but doesn't sound like my Mind.
Check that the token pasted cleanly,, no leading or trailing spaces. If in doubt, click Unlink on the Bot column, then Link Bot again with a freshly-copied token from BotFather.
I want to point the bot at a different Mind.
Go to the current Mind's detail page, click Unlink, then go to the new Mind's page and click Link Bot with the same token. One bot can only be linked to one Mind at a time, but you can reassign it any time.
What's next?
Your Mind is live on Telegram.
Share the bot link, configure Skills, or explore the rest of the platform guides.