# Telegram bot

> For AI assistants: this is the BitHut template `telegram-bot` (always on). Ask the person only for what is listed under "What you'll need", then set it up with the BitHut tools connected to you. If BitHut is not connected yet, start at https://bithut.app/llms.txt.

A bot in Telegram that stays online and answers your team's commands, even when your laptop is closed.

## Tell your AI

1. Connect BitHut to your AI (Claude, ChatGPT or Codex): add the address `https://api.bithut.app/mcp`. How: https://bithut.app/connect.md BitHut is invite-only for now. Signing in works for the Google account we invited.
2. Then tell it:

```
Put a Telegram bot on BitHut using the telegram-bot template. It should answer /today with today's orders from my Google Sheet. Ask me for the bot token and the sheet.
```

## What you get

A bot in your Telegram that replies to commands like /today with the answer you asked for.

## Who it's for

Teams that want quick answers in a chat: today's orders, a lookup in a table, a reminder.

## What you'll need

- A Telegram bot token from @BotFather.
- What the bot should answer, in your own words.
- Access to the data it answers from, if it needs any.

## What's included

- **Runs all the time.** Starts again on its own if it stops.
- **A safe place for the bot token.** Kept apart from the code.
- **A disk for what the bot remembers.** It survives restarts and updates.
- **Logs in plain words.** When something goes wrong, you see what happened.

## Your data and privacy

The bot answers only in the chats where you add it. What it remembers stays on the project's own disk.

## Limits

- One bot per project. A second bot is a second project.
- Answers when someone writes to it. To send messages on a schedule, use the daily report template.
- Files people send to the bot count toward the project's disk.

## After you start it

1. Your AI starts the bot and checks that it answers.
2. Write /start to your bot in Telegram to try it.
3. When you want it to do more, tell your AI. It updates the bot without losing what it remembers.

## Questions

### Will the bot stop when I close my laptop?

No. It runs on BitHut, not on your computer.

### Can several people use the bot?

Yes. Anyone in the chats where you add it can use it. Your AI can limit it to certain people.

## Technical details

- Language: Python
- Parts: Always-on worker, Disk

## Similar templates

- [Daily report to Telegram](https://bithut.app/templates/daily-report-to-telegram.md): Every morning it takes yesterday's numbers and sends a short summary to your Telegram chat.
- [n8n](https://bithut.app/templates/n8n.md): Your own n8n for workflows and automations, kept online and backed up.
