Skip to main content
Time: 10 minutes | Level: Intermediate
Prerequisites: Logging Like a Pro

​
What You’ll Learn

  • Connect your Telegram account to Peanuts
  • Log entries via text, voice, and photos in Telegram
  • Use bot commands to manage helpers
  • Forward messages to automatically log them
  • Share helpers with Telegram groups

​
Why Use Telegram with Peanuts?

Always Available

Log from your existing chat app—no need to switch apps.

Quick Input

Type or voice message like you’re texting a friend.

Photo Logging

Send photos directly for Smart Scan extraction.

Group Sharing

Collaborate with family or team in a Telegram group.

​
Connecting Telegram

1

Open Settings

Go to Settings → Integrations in Peanuts.
2

Find Telegram

Tap Telegram in the integrations list.
3

Tap Connect

Tap Connect Telegram to start the connection process.
4

Open Telegram

You’ll be redirected to Telegram (or shown a link to open).
5

Start the Bot

Tap Start in the Peanuts bot chat, or send /start.
6

Confirm Connection

The bot will confirm your account is linked. You’re ready to go!
After connecting, you’ll see a connection status indicator on your Helpers list in Peanuts.

​
Logging via Telegram

​
Text Messages

Simply send a message describing your entry: 
You: Spent $30 at Target on groceries

Peanuts Bot: ✅ Logged to Expense Tracker
             Amount: $30.00
             Category: Groceries
             Store: Target
Peanuts automatically routes your message to the right helper based on content.

​
Voice Messages

Send a voice message in Telegram—it’s transcribed and logged just like text:
  1. Hold the microphone button in Telegram
  2. Speak your entry naturally
  3. Release to send
  4. Peanuts transcribes and logs
Voice messages use 10 credits for transcription, same as in-app voice.

​
Photos

Send a photo with or without a caption: 
You: [Photo of receipt]

Peanuts Bot: 📷 Processing receipt...
             ✅ Logged to Expense Tracker
             Amount: $47.32
             Store: Whole Foods
             Date: Today
Photos with receipts/documents are automatically Smart Scanned (5 credits).

​
Bot Commands

Use these commands to manage your Peanuts experience in Telegram:
CommandWhat It Does
/startActivate the bot and connect your account
/helpersList all your helpers
/switch [name]Switch your active helper for logging
/ask [question]Ask Peanuts about your data
/statsQuick stats for your active helper
/settingsBot preferences and notification settings
/helpShow all available commands

​
Example: Switching Helpers

You: /switch workout

Peanuts Bot: ✅ Switched to Workout Tracker
             Now logging exercise entries.

You: Ran 5k in 28 minutes

Peanuts Bot: ✅ Logged to Workout Tracker
             Distance: 5 km
             Duration: 28 min

​
Example: Asking Questions

You: /ask How much did I spend on food this week?

Peanuts Bot: 📊 Food spending this week: $127.50
             - Groceries: $85.00
             - Restaurants: $42.50
             
             That's 15% less than last week!

​
Smart Routing

Peanuts automatically routes your messages to the most appropriate helper:
You SendRouted To
”Coffee $4.50”Expense Tracker
”Ran 3 miles”Workout Tracker
”Finished reading Atomic Habits”Reading Log
”Dentist appointment next Tuesday”Calendar/Schedule
If Peanuts isn’t sure, it will ask you to clarify or use /switch to set a default.
Mention your helper name explicitly for guaranteed routing: “Log to expenses: lunch $15”

​
Forwarding Messages

You can forward messages from other chats to log them:
1

Find the Message

In any Telegram chat, find a message you want to log (e.g., a receipt from a delivery service).
2

Forward to Peanuts

Long-press the message and tap Forward → select Peanuts Bot.
3

Confirm or Add Context

The bot will process the forwarded message. Add a note if needed.
This works great for:
  • Email confirmations forwarded to Telegram
  • Screenshots from other apps
  • Messages with receipts or booking confirmations

​
Group Sharing

Share a helper with a Telegram group for collaborative logging.

​
Setting Up Group Logging

1

Add Bot to Group

Add the Peanuts bot to your Telegram group.
2

Link a Helper

In the group, send /link and select which helper to connect.
3

Start Logging

Any group member can now log entries. Each entry is attributed to who sent it.

​
Group Commands

CommandWhat It Does
/linkConnect a helper to this group
/unlinkDisconnect the helper
/groupstatsShow group statistics
/whoShow who logged each entry

​
Use Cases

Family Expenses

Everyone logs shared household expenses. See who spent what.

Team Mileage

Sales team logs travel mileage in a shared tracker.

Group Fitness

Fitness buddies log workouts together with friendly competition.

Shared Shopping List

Family adds items; anyone can check them off when purchased.

​
Notification Settings

Control what notifications you receive from the Peanuts bot: Access via /settings in Telegram or Settings → Integrations → Telegram in the app:
  • Entry confirmations: On/Off
  • Daily summaries: Morning/Evening/Off
  • Reminders: Enable helper reminders via Telegram
  • Group notifications: All entries / Mentions only / Off

​
Exercise

Practice: Log from Telegram

Set up and test Telegram integration:
  1. Connect Telegram (if not already connected)
    • Settings → Integrations → Telegram → Connect
  2. Send a text entry
    • Message the bot: “Lunch today, $12, grabbed a sandwich”
    • Verify it appears in your expense tracker
  3. Try a voice message
    • Send a voice message: “Coffee this morning, four dollars fifty”
    • Check the transcription accuracy
  4. Send a photo (if you have a receipt)
    • Photo of any receipt
    • Verify Smart Scan extraction
  5. Use a command
    • Send /helpers to see your helpers list
    • Send /ask How much did I spend today?
Bonus: Forward a confirmation email or message to the bot!

​
Key Takeaways

Remember:
  • Connect once, log forever from Telegram
  • Messages auto-route to the right helper
  • Voice messages work just like in-app voice (10 credits)
  • Photos are Smart Scanned automatically (5 credits)
  • Use /switch to change your active helper
  • Groups enable collaborative logging with attribution

​
Troubleshooting

  • Make sure you’ve started the bot with /start
  • Check your internet connection
  • Try sending /help to test
Use /switch [helper name] to explicitly set your default helper, or mention the helper name in your message.
  • Voice transcription requires credits
  • Check your credit balance in Settings → Usage
  • Ensure you have a Starter plan or higher
  • You need admin permissions in the group
  • The group must allow bots
  • Try removing and re-adding the bot
Go to Settings → Integrations → Telegram and tap Reconnect to re-authorize.

​
Next Steps

Sharing and Collaboration

More ways to share and collaborate

Telegram Reference

Complete integration documentation