Insights

The insights system analyzes your top conversations, finds patterns in what makes subscribers convert, and turns those patterns into reusable playbooks. It's how Whisper gets smarter about your specific account over time.

You Might Not Need to Run This

Whisper now handles the basics automatically:

• Auto-seeding: On your first startup, Whisper builds initial scoring data in the background from your transaction history. You don't need to run whisper insights just to get conversion scores working.
• Continuous learning: Every time a subscriber makes a purchase, Whisper automatically analyzes the conversation that led to it and adds it to the scoring system. The data grows with every sale, no manual runs needed.

So when should you run whisper insights manually? When you want the full package: deep strategy extraction, segment analysis, and playbook generation for campaigns. The auto-seeding gives you scoring. Insights gives you strategy.

Running Insights

Exit Whisper if you're in interactive mode (/quit), then run:

whisper insights

If you manage multiple accounts:

whisper insights myaccount

What Happens

Insights runs through several stages. Each one shows progress so you know what's going on:

Whisper Insights

Account: @sunshinevibes
Mode: standard | Top 30 spenders

✓ Synced 4,521 transactions (3s)
✓ Collected 30 subscribers (12s)
✓ Attributed 187 purchases, 42 conversion windows (5s)
✓ 4 segments [vip:8, regular:12, casual:6, new:4] (1s)
✓ Extracted 4 strategies (45s)
✓ Created 42 embeddings (8s)
✓ Generated 4 playbooks (15s)
✓ Report saved (1s)

Pipeline complete!
Duration: 90s
Subscribers: 30 | Transactions: 4,521
Conversions attributed: 42
Strategies: 4 | Playbooks: 4

Insights feeds into playbooks, which power campaigns, which generate better conversations.

What You Get

Strategies

Whisper analyzes what worked in your best conversations and extracts strategies per subscriber segment. For example: "VIP subscribers respond well to exclusive early access offers" or "New subscribers convert best when asked about their preferences first."

Playbooks

Strategies become playbooks, which are step-by-step conversation templates. Playbooks are used by the campaign system to run personalized outreach at scale.

Conversion Scoring Data

Insights enriches the scoring data that powers the conversion scores in /unreads and /review. While auto-seeding and continuous learning handle the basics, running insights adds richer strategy context and more detailed segment analysis.

Options

Option	What it does
--deep	Syncs more conversation history per subscriber (slower but more thorough)
--top 50	Analyze more than the default 30 top spenders
--force	Re-run even if data is still fresh from a recent run

Deep Mode

Standard mode syncs recent messages for each subscriber. Deep mode goes further back, giving the AI more conversation history to analyze. It takes longer but produces better strategies, better scoring, and better personalization.

whisper insights --deep

We recommend running deep mode at least once for each account, especially established accounts with months of conversation history. The more data the system has, the better it gets at scoring conversations and recommending content.

If you work on a team, only one person needs to run --deep. The conversation history and scoring data sync automatically to all operators on the same account. Think of it as a one-time investment that benefits the whole team.

Earnings History Window

Whisper fetches all available earnings data within a lookback window. By default, this covers the last 90 days of transactions across all types (tips, messages, subscriptions, purchases). There's no per-type limit, so even high-volume accounts get complete data within that window.

For most accounts, 90 days is plenty. But if you're onboarding a creator with a long history and want the full picture for strategy and scoring, you can expand the window. Ask your account admin to update the earnings lookback in the dashboard, or make the API call yourself:

PUT https://whisper.fans/api/connections/{connection-id}/config

{ "earnings": { "lookbackDays": 365 } }

Replace {connection-id} with the account's connection ID (visible in the dashboard URL when viewing that account). The next time Whisper syncs, it will automatically pull the expanded history. This is a one-time backfill. After that, syncs stay fast because they only fetch new data.

If you work on a team, only one operator needs to trigger this. The earnings data syncs to all operators on the same account automatically.

Start with a bigger window when onboarding

If you're setting up a new creator account and want the best possible scoring and recommendations from day one, increase the lookback window before your first session. More historical data means better conversion attribution, more accurate segment analysis, and smarter playbook generation.

When to Run Insights

• For playbooks and campaigns: If you want to use the campaign system, you need to run insights first to generate playbooks.
• Weekly or biweekly: Run it periodically to keep your strategies fresh as your audience evolves.
• After big changes: If you shifted your content strategy or had a big influx of new subscribers, run insights to recalibrate.

You don't need insights for basic scoring

Conversion scores in /unreads and /review work without running insights. Whisper seeds scoring data automatically on first startup and learns from every purchase after that. Run insights when you want deeper strategy analysis or need playbooks for campaigns.