Integrations / Telegram Bot

Your Budget,
Just a Message Away.

Log transactions in seconds using natural language or receipt photos. Secure, serverless, and 100% database-free.

S
Smerio Bot
bot
spent $15 at Subway
📝 Yes, I am glad that you had a sandwich at Subway. I will add this as transaction:
• Category: Food
• Subcategory: FastFood
• Amount: 15.00
• Currency: USD
Is this correct?

A budget tracker that adapts to you.

No spreadsheets. No complex forms. Just snap and go.

Natural Chatting

Stop opening manual logsheets. Mention "spent $20 on coffee at Starbucks" in plain text and let our integrated LLM model handle categorization.

Photo Receipt OCR

Snap a picture of your ticket. Multimodal AI parses the store, totals, items, and tax rules, preparing a transaction draft instantly.

100% Database-Free

Runs entirely stateless on AWS Lambda. Bot state is encoded in zero-width invisible HTML payloads (`\u200d`) right in your chat, for absolute zero ($0.00) AWS hosting costs.

Zero-Trust Isolation

Restricts usage strictly to your unique numeric Telegram User ID. Unrecognized usernames are immediately dropped, keeping your gateway locked.

Stateless Inline PayloadsTech Detail

How does a database-free bot store transaction confirmations? By hiding serialised JSON string records inside the Telegram Inline Keyboard response text using invisible zero-width unicode spaces (\u200d\u200c).

// Invisible State Payload Schema {"c":"Food","s":"FastFood","a":15.00,"u":"USD"}
No SQLite, Postgres, or DynamoDB needed
Instant callback parsing upon tapping confirmation button
Zero database footprint and zero maintenance

Simulate the Interactive Sandbox.

Play around with the live chat simulator widget above. Alternate between text entries or snaps, and tap the active button layouts to verify how Smerio resolves parameters before syncing them directly to your backend REST endpoints.

The bot behaves exactly like standard messenger chats, allowing high-performance, real-world expense logging in seconds.

Premium Integration Specifications

Under the hood of Smerio's custom Telegram gateway.

FeatureTechnical BlueprintUser Value
Multimodal Receipt OCRGemini 2.5 Flash / Claude 3.5 Haiku pipeline structureTake a photo of your paper bills to extract price tables automatically.
Stateless Inline ControlsZero-width invisible HTML unicode encapsulation (`\u200d`)Zero architecture cost; no operational storage database overhead.
Strict User IsolationAuthorized Telegram user-id validation matchesTotal private locking against unauthorized usage or random logging attempts.
Dynamic TaxonomyGateway REST endpoint synchronization Bot automatically inherits your exact bank accounts, budgets, and categories.
AWS Terraform BlueprintAWS Lambda + API Gateway Terraform deployment moduleHost multiple isolated instances securely inside standard AWS free tier.

One-Click Deployment Blueprint

Follow these steps to connect and deploy your private serverless Telegram budget companion.

01

Register Your Bot

Open Telegram, initiate a chat with @BotFather , and execute the /newbot command. Complete the onboarding steps to receive your **HTTP API Token**.

02

Configure Smerio Integration

Find your Telegram user id using @userinfobot . Navigate to **Smerio Settings → Telegram Bot Integration**, input your user id, and copy the generated secure **Gateway Token**.

03

Deploy with Terraform

Clone the repository and configure your credentials.

bash command
git clone https://github.com/smerio/smerio-tg-bot.git
cd smerio-tg-bot/terraform
cp terraform.tfvars.example terraform.tfvars

Populate your parameters inside terraform.tfvars:

terraform.tfvars
bot_id                   = "my-personal-bot"
allowed_telegram_user_id = 123456789        # Your numeric User ID
smerio_api_url           = "https://smerio.yourdomain.com"
smerio_telegram_token    = "smerio_tg_secret_gateway_token_here"
telegram_bot_token       = "123456789:ABCdefGh..."
llm_provider             = "gemini"
llm_api_key              = "AIzaSy..."       # Google AI Studio / Gemini Key

Run Terraform to deploy to your AWS cloud account instantly:

bash deploy
terraform init
terraform apply
💡 Once deployment completes, copy the generated AWS URL output, paste it into your Smerio Bot integration panel, and your webhook will activate automatically!