> ## Documentation Index
> Fetch the complete documentation index at: https://docs.peanutsapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# WhatsApp

> Log entries via WhatsApp messages

## Overview

Connect Peanuts to WhatsApp to log entries directly from your chat app.

## Setup

1. Go to **Settings → Integrations → WhatsApp**
2. Click "Connect WhatsApp" to generate a linking code
3. Send the code to the Peanuts WhatsApp number
4. You're connected!

## Features

### Text Logging

Send plain text messages to log entries. Peanuts uses a 4-tier matching system:

1. **Affinity** - Learned patterns from your previous messages (0 credits)
2. **Local Matching** - Keyword and field detection (0 credits)
3. **AI Parse** - Smart intent understanding (1 credit)
4. **Fallback** - Saves to Shoebox if no match found

### Smart Clarification

When Peanuts isn't 100% sure where to save your message, it asks:

**Medium confidence (multiple possible helpers):**

```
🤔 I think this goes to *Sleep Tracker 😴*

"slept 8 hours"

Reply:
1️⃣ Yes, save here
2️⃣ Choose different helper
3️⃣ Cancel
```

**Low confidence (unclear intent):**

```
📝 Where should I save this?

"slept 8 hours"

Reply with a number:
1️⃣ Sleep Tracker 😴
2️⃣ Daily Checkin ✅
3️⃣ Wellness Log 💚
4️⃣ Cancel
```

Just reply with a number (1, 2, 3, etc.) to confirm your choice.

### Affinity Learning

When you confirm a helper choice, Peanuts learns your preference. Next time you send a similar message, it routes automatically without asking.

### Link Analysis

Share URLs to automatically extract structured data:

* Recipe links → Recipe helper with ingredients, instructions
* Product links → Wishlist with price, description
* Article links → Reading list with summary

Links are pre-analyzed to detect content type before using AI, saving credits when possible.

### Voice Notes

Send voice messages for hands-free logging:

* Transcription costs **8 credits**
* Transcribed text routes through the 4-tier matching system
* Matched to the right helper automatically

### Photo Capture

Send photos for Smart Scan analysis:

* Receipts → Extracted and logged with amounts
* Documents → Analyzed and saved
* Plants, food, products → Identified and categorized
* Costs **5 credits** per image

### Helper Creation via Chat

Create new helpers conversationally:

* "I need a tracker for my water intake"
* "Create a helper for logging client meetings"

Peanuts designs the helper and asks for confirmation. Reply **yes** to create it instantly.

### Commands

| Command                       | What it does                                         |
| ----------------------------- | ---------------------------------------------------- |
| **help**                      | Show usage guide                                     |
| **log**                       | Guided entry — pick a helper, fill fields one by one |
| **tour**                      | Interactive feature tour                             |
| **settings** or **/settings** | View your account status (plan, credits, timezone)   |
| **credits** or **/credits**   | Check your credit balance instantly                  |
| **goals** or **/goals**       | View your goals with progress charts                 |
| **apps** or **helpers**       | List your active helpers                             |
| **undo**                      | Delete your last entry                               |
| **move**                      | Reroute your last entry to a different helper        |
| **shoebox**                   | Browse your Shoebox and move entries to helpers      |
| **I'm in \[city]**            | Set your timezone                                    |

### Inline Editing

Made a mistake? Just correct it naturally:

* "Actually 35" → Updates the amount
* "Change that to dinner" → Updates the note
* "It was yesterday" → Updates the date

Corrections work within 30 minutes of the original entry.

### Confirmation Commands

Reply to confirm pending actions:

* **yes**, **ok**, **confirm**, **done** - Confirm the pending action
* **👍**, **✅** - Also works as confirmation
* **1**, **2**, **3** - Select numbered options

Use these to:

* Create a new helper designed by AI
* Confirm a pending entry that needs clarification
* Choose from a list of helpers

### Move to Different Helper

Made a mistake? Say **move** to reroute your last entry:

```
📂 Move last entry to which helper?

1️⃣ Expenses 💰
2️⃣ Work Log 💼
3️⃣ Personal Notes 📝
4️⃣ Cancel
```

### Reminders

Send "remind me to \[task] at \[time]" to create reminders delivered via WhatsApp.

Examples:

* "remind me to call mom at 3pm"
* "remind me about the meeting in 30 minutes"
* "remind me tomorrow at 9am to submit report"

### Ask Peanuts

Ask questions about your data:

* "How much did I spend this week?"
* "What did I track yesterday?"
* "Show me my recent entries"
* "Summarize my workouts this month"

## Rate Limits

WhatsApp has per-tier rate limits to prevent abuse:

| Tier    | Messages/Hour | AI Ops/Day |
| ------- | ------------- | ---------- |
| Free    | 15            | 10         |
| Starter | 75            | 50         |
| Pro     | 300           | 200        |
| Team    | 750           | 500        |

## Credit Usage

| Action                         | Credits |
| ------------------------------ | ------- |
| Text matching (Affinity/Local) | 0       |
| Text matching (AI Parse)       | 1       |
| Voice transcription            | 8       |
| Photo analysis                 | 5       |
| Ask Peanuts question           | 1       |
| Credit balance check           | 0       |

## Tips

1. **Be specific** - "Coffee $5" routes better than just "$5"
2. **Use consistent patterns** - Helps the affinity system learn your style
3. **Check credits first** - Send "credits" before heavy usage
4. **Voice for speed** - Voice notes are great for detailed entries on the go
5. **Confirm to learn** - When asked to confirm, doing so teaches Peanuts your preferences

## Limitations

* No group chat support currently
* Template messages required for proactive reminders (24-hour window)
* One phone number per account