Rosi
All guides Telegram bot
Setup Guide

Create your
Telegram bot.

This is the first Telegram step for Rosi. You create the bot in Telegram, choose the final username, copy the bot token, then paste that token into Rosi onboarding.

You need One normal Telegram account and BotFather.
Important Telegram only shows the full bot token once when you create or rotate it.
Next step After saving the token in Rosi, you still need to finish owner and group binding.
Open BotFather Official Telegram bot docs
Overview

What happens in this step

Bot creation

You create the Telegram bot itself through BotFather.

Final username

The username you choose here is the same one Rosi will use later for binding and groups.

Token

The token proves Rosi is allowed to run this bot on your Mac.

What comes next

Once Rosi has the token, you still need the first DM and first group message to finish Telegram binding.

You do not need to manually type numeric Telegram user ids or group ids into Rosi. Rosi learns those from real Telegram activity later.
Step by step

How to create the bot and token

1

Open BotFather

In Telegram, search for @BotFather and open that chat.

2

Create the bot

Send /newbot to BotFather and follow the prompts.

  • The first prompt is the display name people see in Telegram.
  • The second prompt is the username. It must end in bot.
3

Choose the final username carefully

Keep the username stable. Rosi uses that exact username later when it verifies the owner DM and group binding.

Examples: rosi_assistant_bot, helloassistant_bot
4

Copy the bot token

BotFather returns a token immediately after creation. Copy the full token and keep it somewhere safe until you paste it into Rosi.

If you lose the token, go back to BotFather later and use /token to generate or reveal a fresh one for the same bot.
5

Paste both fields into Rosi

Back in the Rosi Mac app, paste the bot username and the bot token into the Telegram step of onboarding, then continue.

Verification

How to know this part worked

Once the username and token are saved, Rosi should stop complaining about missing Telegram access details. The next Telegram state should be about binding, not token setup.

The normal next state is: waiting for your first Telegram message or waiting to bind. That means the bot token step is done and you are ready for the next guide.
Common issues

What to check if this fails

The username is rejected

Telegram usernames for bots must end in bot and must still be available.

You lost the token

Return to BotFather and use /token for that bot. Then paste the fresh token into Rosi.

Rosi still says the token is missing

Make sure you pasted the full token and did not accidentally paste the display name or username instead.

You finished this page

Go to the binding guide next. Saving the token alone does not finish Telegram setup for Rosi.