What you’ll get: A personal Telegram bot that understands your helpers. Send a message, photo, or voice note—Peanuts figures out where it belongs and saves it.
What You’ll Need
- A Telegram account
- 5 minutes to set up
- (Optional) A phone with Telegram installed
You’ll create your own personal bot. This bot is private to you—no one else can access your data through it.
Step 1: Create Your Bot
1
Open BotFather
In Telegram, search for @BotFather or tap this link. This is Telegram’s official bot for creating new bots.
2
Start a new bot
Send the command:
3
Name your bot
BotFather asks for a display name. Choose something like:
- “My Peanuts”
- “Personal Tracker”
- “Life Log”
4
Choose a username
BotFather needs a unique username ending in
bot. Examples:mylife_peanuts_botjsmith_tracker_botpersonal_log_2024_bot
5
Copy your token
BotFather responds with your bot token—a long string like:Copy this token. You’ll need it in the next step.
Step 2: Connect to Peanuts
1
Go to Telegram Settings
In Peanuts, navigate to Settings → Integrations → Telegram.
2
Enter your bot token
Paste the token from BotFather into the token field.
3
Click Connect
Peanuts verifies your bot and sets up the connection.
4
Start chatting
Open your new bot in Telegram and send
/start to activate it.Once connected, you’ll see a confirmation with your bot’s username. The bot is now ready to receive messages.
Step 3: Authorize Your Chat
For security, your bot only responds to authorized chats.1
Send /start to your bot
Open your bot in Telegram and send:
2
Bot sends authorization code
Your bot responds with a 6-digit code.
3
Enter code in Peanuts
Back in Peanuts Telegram Settings, enter the code to authorize this chat.
4
You're connected!
The bot confirms: ”✅ Authorized! You can now send entries.”
Your First Entry
Try sending a message to your bot: Spent €12.50 on lunch What happens:- Bot receives your message
- AI identifies it as an expense
- Bot asks: “Save to /expenses?” (or auto-routes if you have a rule)
- You confirm
- Entry is saved with amount, category, and timestamp
Text Messages
Voice Notes
Record a voice note describing your entry. Peanuts transcribes and parses it automatically.
Send Photos
Photos are automatically analyzed:| Photo Type | What Happens |
|---|---|
| Receipt | Extracts merchant, amount, date |
| Document | OCR extracts text content |
| Product | Identifies item for collections |
| Screenshot | Reads text from the image |
Bot Commands
| Command | What It Does |
|---|---|
/start | Initialize or re-authorize the bot |
/help | Show available commands |
/apps | List your helpers |
/today | See today’s entries |
/stats | Quick summary of recent activity |
/routing | Manage auto-routing rules |
Smart Routing
Tired of confirming where to save each message? Set up automatic routing.How It Works
- Pattern matching — “allrecipes.com links → /recipes”
- Content type — “All photos → /receipts”
- Learning — After 3 manual selections, bot suggests a rule
Set Up a Rule
Via Telegram: /routing Or in the web app: Settings → Telegram → Smart Routing| Rule Type | Example |
|---|---|
| Domain | Links from netflix.com → /watchlist |
| Keyword | Messages with “workout” → /exercise |
| Content | All voice notes → /journal |
| Time | Morning messages → /morning-routine |
Smart routing learns from your behavior. If you manually select the same helper 3 times for similar content, the bot suggests creating an automatic rule.
The Mini App
Your bot includes a full web interface accessible from Telegram:1
Tap 'Open My Apps'
In any bot message, tap the button or send
/start.2
Full interface opens
A mini app appears with your dashboard, helpers, and full editing capabilities.
3
Use just like the web app
Add entries, edit helpers, view stats—all without leaving Telegram.
Reminders & Digests
Set Reminders
Via Telegram: /remind Take vitamins at 8am daily /remind Check expenses every Sunday at 6pmDaily Digests
Get morning and evening summaries:- Morning digest — Yesterday’s summary, today’s agenda
- Evening digest — Today’s entries, streaks, and stats
/settings to your bot.
Troubleshooting
Bot doesn't respond
Bot doesn't respond
- Check that the bot is connected in Peanuts Settings
- Verify you’ve authorized the chat with
/start - Ensure your Peanuts account is active
Messages aren't being saved
Messages aren't being saved
- Check if you have an active helper that matches the content
- Try specifying the helper:
/expenses 15 coffee - Make sure the helper has appropriate fields
Voice notes aren't transcribed
Voice notes aren't transcribed
Voice transcription requires Starter plan or higher. Check your subscription in Settings.
Photos aren't analyzed
Photos aren't analyzed
Image analysis uses credits. Ensure you have available credits in your account.
Want to reset the connection
Want to reset the connection
- Go to Settings → Telegram
- Click “Disconnect”
- In Telegram, send
/startto your bot - Reconnect with the same or a new token
Security Notes
Your Data
- Bot token is encrypted
- Messages processed on secure servers
- Data belongs to you
- Export anytime
Access Control
- Only authorized chats work
- You control which helpers the bot can access
- Revoke access anytime
- Delete bot to remove connection
Credit Usage
| Action | Credits |
|---|---|
| Text messages | Free (AI routing uses 1 credit) |
| Photo analysis | 5 credits |
| Voice transcription | 10 credits |
| Link analysis | 1 credit |
| Reminders | Free |
| Digests | Free |