Home / Use case / Inside Telegram
Inside Telegram
What a Telegram expense bot actually does — end to end
If you've never used a Telegram bot for finance, the model can sound vague. Here's exactly what happens between the moment you type "Swiggy 350" and the moment your monthly summary lands.
Free tier · 20 messages and 2 questions per day
Telegram bots are messaging accounts run by software instead of people. You talk to them like any other contact, and they respond programmatically. For expense tracking, this turns out to be a remarkably good fit: it's the lowest-friction surface that already exists on every phone.
Hisaab is a Telegram bot at @hisaab_finance_bot. This page walks through what it does, end-to-end.
Step 1 — Logging an expense
You open Telegram, find @hisaab_finance_bot, and type something like "Spent 1200 on dinner". Hit send. Within a second or two, the bot replies with a structured receipt: ₹1,200 · food · Dinner.
Behind the scenes: your message goes to a Vercel serverless function, which forwards the text to a small language model (Anthropic's Claude Haiku via fal.ai) for parsing. The model returns amount + category + merchant. The function writes one row to a Postgres ledger and replies. The whole round trip takes about a second.
Step 2 — Asking questions
Once you have a few weeks of expenses logged, the /ask command lets you query in plain English. Examples that work:
/ask how much on food this month/ask top 5 merchants last 30 days/ask did I spend more on transport in March or April?/ask what's my biggest category this week?
The bot writes a SQL query against your private ledger, runs it, and returns the answer in a sentence. This counts against your daily /ask limit (2 per day on free tier).
Step 3 — Sharing with a partner
If you want a household partner on the same ledger, send /invite. The bot returns an 8-character code. Your partner sends /join CODE from their own Telegram. Both of you now write into and read from one ledger.
Step 4 — Getting your data out
Send /export. The bot replies with a CSV file — every expense, every column, ready to drop into Excel. Send /delete if you want everything gone instead. Both work in a single command.
What the bot does not do
- It doesn't read your SMS. No SMS permission, no notification listening.
- It doesn't link to your bank. No account aggregation, no UPI receipts.
- It doesn't push notifications. The only messages the bot sends are responses to your messages, plus a weekly summary on Sundays.
- It doesn't track investments. Pure expense tracking only.