agent_space

Setup guide

Telegram: bot token & user ID

Two short tasks. Five minutes total. The first gives you a token so your agent can send messages; the second gives you a user ID so the agent knows who's allowed to talk to it.

Opens your browser's print dialog — pick Save as PDF as the destination.

Part A — Get a bot token from @BotFather

BotFather is Telegram's official bot for creating other bots. It's verified — look for the blue check.

1

Open Telegram and search @BotFather

In the search bar at the top of the Telegram app, type @BotFather. Tap the result with the blue verified checkmark — that's the only official one. Open the chat.

Search @BotFather GLOBAL SEARCH BF BotFather bot BF Bot_Father_Official bot · fake Blue check = official bot Tap the verified result to open the chat.
2

Tap the Open button at the bottom-left

Once you're in the BotFather chat, look at the bottom-left corner of the screen — there's a blue pill labelled Open with a small square icon. Tap it. This launches the BotFather mini-app inside Telegram (the modern way to manage bots; you no longer need to type slash commands).

BF BotFather 9,699,479 monthly users OK. Send me the new description when they can use this bot do? Choose a bot from the list: @hermes_mg_bot @friday_msg_bot /start 9:08 PM Open Write a message… Tap "Open" to launch the app
3

Tap + Create a New Bot

The mini-app opens to your existing bots list. At the top of that list is a + Create a New Bot row — tap it. The app will then prompt you for two things:

  • A display name — anything readable, e.g. "Mark's Assistant".
  • A username — must end in bot, e.g. marks_assistant_bot. Must be globally unique on Telegram. If it's taken, pick another.
× BF BotFather ⋯ BF BotFather BotFather is the one bot to rule them all. Use it to create new bot accounts and manage your existing bots. Learn more › Search My bots Create a New Bot H Hermes @hermes_mg_bot › M Merlin @merlin_mg_bot › Tap to start
4

Tap Copy to grab the token

Once the bot is created, the mini-app drops you on the bot's profile page. The token is shown as a masked row of dots (Telegram hides it for privacy). Tap the big blue Copy button just below — the full token (something like 7891234567:AAH-Z_xx12...) is copied to your clipboard.

Treat the token like a password. Anyone with it can post as your bot. Paste it into the TELEGRAM_BOT_TOKEN field on your settings page and don't share it anywhere else. If it ever leaks, hit Revoke on this same screen and you'll get a fresh one.
BF BotFather ⋯ M Mark's Assistant @marks_assistant_bot Copy Revoke Access the API using this token. Keep your token secure and store it safely, anyone can use it to control your bot. Read more › Settings Edit Info › Commands › Mini Apps › Masked for privacy — tap Copy to grab it
5

Start a chat with your new bot

This step is essential — your bot can't message you until you message it first.

  • Click on your bot's name below the profile picture. It will pull up options for messaging your bot.
  • Select message on the left.
  • /start should already show in the chat window. Send it once.

That's it for Part A. The bot is now saved in your Telegram chat list, and your agent can DM you.

Message your bot once Token text is intentionally blurred. Your real token should never be visible in the guide. A Your Assistant @your_assistant_bot Copy Revoke Settings Edit Info Commands 1 Tap the bot name A Your Assistant bot message mute more username @your_assistant_bot Add to Group or Channel 2 Tap Message Your Assistant bot A Today /start 2:32 PM Menu Message 3 Send /start

Part B — Get your user ID from @userinfobot

Your Telegram user ID is a number. The official @userinfobot will tell it to you in one tap.

6

Search @userinfobot

Back in the Telegram search bar, type @userinfobot. Pick the result with the blue verified checkmark. (Several copycats exist — only open the verified one.)

Search @userinfobot GLOBAL SEARCH UI Get My ID @userinfobot · bot Look for the verified one Many copycats exist — only the verified bot returns correct info.
7

Press Start

The bot replies instantly with your details. The line that says Id: is the number you want — usually 9–10 digits. Copy it.

UI Get My ID bot /start Your information: First name: Mark Last name: Goh Username: @markgoh Id: 987654321 This number is your user ID Copy this number. It is your Telegram user ID.

Recap — fields to fill in

  • TELEGRAM_BOT_TOKEN — the long token from step 4.
  • TELEGRAM_HOME_CHANNEL / TELEGRAM_HOME_CHANNEL_NAME — optional. Set these only if the agent should post into a group/channel by default.