Natural Language
Just type normally—AI understands your intent
Voice & Photos
Send voice memos or snap receipts
Smart Routing
Auto-direct content to the right helper
Quick Start
1
Create Your Bot
Open @BotFather on Telegram and send
/newbot. Follow the prompts to name your bot and get your bot token.2
Connect to Peanuts
Go to Settings → Telegram in Peanuts, paste your bot token, and tap Validate.
3
Set Up Webhook
Copy the webhook URL shown and tap Configure Webhook. Peanuts handles the rest.
4
Start Chatting
Open your bot on Telegram and send
/start. You’re ready to go!Using Your Bot
Commands
Every helper you create gets a Telegram command. Use it to log entries or switch context: /expense 42.50 lunch with client /mood 😊 great meeting today /weight 75.2Natural Language
No need to remember commands—just describe what you want: “spent 25 euros on groceries” “feeling tired today, 6 hours sleep” “remind me to call mom tomorrow at 3pm” The AI figures out which helper to use and extracts the data automatically.Voice Messages
Record a voice memo and Peanuts transcribes it, then logs the entry to the appropriate helper.Voice transcription uses 1 credit per message.
Photos
Send photos of receipts, documents, or anything you want to track. Peanuts uses vision AI to extract relevant data.| Photo Type | What Happens |
|---|---|
| Receipt | Extracts amount, merchant, date, items |
| Document | OCR text extraction and summary |
| Food | Estimates calories and ingredients |
| Screenshot | Extracts visible text and data |
Links
Share a URL and Peanuts analyzes the page content:- Recipes → Extracts ingredients, prep time, instructions
- Products → Pulls price, name, description
- Articles → Summarizes key points
- Events → Captures date, location, details
Smart Routing
Smart Routing automatically sends your content to the right helper without you specifying which one.How It Works
- You send a photo, link, or voice message
- Peanuts analyzes the content
- If confident, it routes to the matching helper automatically
- If unsure, it asks you to confirm
Setting Up Rules
Go to Settings → Telegram → Smart Routing to configure:Photo Rules
Photo Rules
Route photos based on detected content:
- Receipts → Expense tracker
- Food → Meal log
- Documents → Notes
Link Rules
Link Rules
Route links by domain or content type:
allrecipes.com→ Recipe collectionamazon.com→ Wishlist- Any recipe page → Cooking helper
Voice Rules
Voice Rules
Route voice messages based on detected intent or set a default helper for all voice input.
Default Actions
For each content type, choose what happens when no specific rule matches:| Action | Description |
|---|---|
| Ask | Bot asks which helper to use |
| Route | Automatically send to a specific helper |
| Create New | Suggest creating a new helper |
| Ignore | Don’t process this content type |
Telegram Mini App
Access your full Peanuts dashboard directly inside Telegram:- Open your bot
- Tap the menu button or send
/start - Tap Open My Apps
- Full helper management
- Entry history and editing
- Charts and statistics
- All features from the web app
The Mini App adapts to Telegram’s theme (light/dark) automatically.
Digests & Reminders
Daily Digests
Get a summary of your tracked data delivered to Telegram:| Digest | Default Time | Content |
|---|---|---|
| Morning | 8:00 AM | Yesterday’s summary, today’s goals |
| Evening | 8:00 PM | Today’s entries, streaks, insights |
/settings to your bot.
Reminders
Set reminders using natural language: “remind me to take vitamins at 9am daily” “remind me about dentist appointment on Friday” “remind me to log weight every morning” Or configure per-helper reminders:- Daily reminder — “Don’t forget to log your mood today!”
- No-entry alert — Notifies you if you haven’t logged anything by a certain time
Bot Commands Reference
| Command | Description |
|---|---|
/start | Initialize bot and show welcome message |
/help | List available commands and helpers |
/apps | Show all your helpers with quick-log buttons |
/stats | View summary statistics |
/undo | Delete your last entry |
/today | Show today’s entries |
/settings | Configure timezone and digest preferences |
/timezone | Set your timezone (e.g., /timezone Europe/London) |
Each helper also gets its own command based on the command you set when creating it.
Troubleshooting
Bot doesn't respond
Bot doesn't respond
Check:
- Bot token is correct and active
- Webhook is configured (green status in Settings)
- You’ve sent
/startat least once
- Tap “Reconfigure Webhook” in Settings → Telegram
- Create a new bot with BotFather if token was compromised
Wrong helper selected
Wrong helper selected
The AI uses context to pick helpers. To be explicit:
- Use the command directly:
/expense 50 - Or specify: “log 50 to my expense tracker”
Voice messages not transcribing
Voice messages not transcribing
- Ensure you have credits available
- Check the audio is clear (minimal background noise)
- Voice messages must be under 5 minutes
Photos not processing
Photos not processing
- Image must be under 10MB
- Ensure good lighting and focus
- Some image types work better than others (receipts are well-supported)
Digests not arriving
Digests not arriving
- Verify your timezone is set correctly (
/timezone) - Check digest is enabled in Settings → Telegram
- Ensure bot hasn’t been blocked or deleted
Mini App won't load
Mini App won't load
- Update Telegram to the latest version
- Try closing and reopening the bot
- Clear Telegram cache in app settings
Privacy & Security
Your Bot, Your Data
Only you can access your bot. Messages are processed and not stored beyond what’s needed for your entries.
Token Security
Your bot token is encrypted and never exposed. You can revoke it anytime via BotFather.
Credit Usage
| Action | Credits |
|---|---|
| Text messages | 1 credit |
| Voice transcription | 1 credit |
| Photo analysis | 2 credits |
| Link analysis | 1 credit |
| Digests | Free |