Create your account

Go to app.mappapro.co and click Sign Up. You'll enter your name, agency name, email, and password. Your account is created as an Owner — the highest access level with full control over your workspace.

First-time setup checklist

How it works

Mappa Pro uses Fanvue's official OAuth authorization flow — the same secure method used by major platforms. When you connect an account, you're redirected to Fanvue's official login page. After you authorize, Fanvue sends a token back which we encrypt and store securely. Your password never touches our servers.

Connecting an account

Account health monitoring

The Accounts tab shows a System Health card per account with:

• Token status (valid / expired)
• Last sync timestamp
• Unread message count
• Follow-up needed count
• Pending outbound messages

Reconnecting after expiry

If a Fanvue account's password changes, the token is invalidated. You'll see a red reconnect banner at the top of the app. Click Reconnect on the affected account to go through the OAuth flow again.

Pending invites

The Accounts tab also shows Pending Invites — Fanvue account invites you've sent but that haven't been accepted yet. You can cancel or track expiry dates from this table.

Sending an invite

Managing team members

• View all members with their current Live / Offline status
• Edit role or remove a member at any time
• Reassign accounts without removing the member
• Resend invite if the email wasn't received
• Copy the temp password from the Team tab if a new member needs it

How to assign

For owners

• Sign up → name your agency → connect Fanvue accounts → invite team → assign → set commission
• Use the Overview tab as your home base — it shows total revenue, subscriber counts, and top spenders across all accounts
• Use Earnings & Payouts to see per-chatter performance and configure commission rates

For chatters

• You'll receive an invite email — click the link to set your password
• Log in and you'll land on the Inbox — your assigned accounts' conversations are already here
• Click the clock icon in the sidebar to clock in and start tracking your shift
• Reply to fans, send PPV, and use scripts/vault to work efficiently
• Clock out when your shift ends — your KPIs are saved automatically

For managers

• You have access to the inbox, analytics, and team management for your assigned accounts
• Use the Earnings & Payouts tab to monitor chatter performance across your team
• You can invite and assign new chatters without needing owner approval

How it works

The inbox syncs all fan conversations from every account assigned to you. Messages appear sorted by most recent. Each thread shows the fan's name, avatar, which creator account it belongs to, the last message, and an unread indicator.

Filtering & sorting

Use the controls at the top of the inbox to:

• Sort by: Most recent, Oldest first, Alphabetical, Most spent, Least spent
• Filter by: All conversations, Mine (your assigned only), or a saved custom filter
• Search by fan name across all conversations
• Save filter presets — create named rule sets and apply them with one click

The conversation view

Inside a conversation you can see the full message thread with timestamps and PPV indicators. The right panel shows the fan's profile — spend history, subscription status, and notes — without leaving the conversation.

The fan detail panel

The right sidebar inside every conversation shows:

• Fan avatar, display name, and handle
• Lifetime spend and last purchase date
• Total PPV revenue and average PPV price
• Total tips and average tip amount
• Subscription status, cost, duration, and auto-renewal
• PPV purchase history (full list in modal)
• Custom nickname and saved notes
• Follow-up flag

How to send PPV

PPV tracking

Every PPV sent and purchased is automatically logged. You can see per-chatter PPV stats in the Earnings & Payouts tab, and per-fan PPV history in the inbox detail panel.

What are scripts?

Scripts are reusable message templates saved per Fanvue account. They let chatters send consistent, on-brand messages without writing from scratch every time. Templates are organized into folders for easy browsing.

Using a script in the inbox

Managing scripts

Owners and managers can create, edit, and delete scripts. Scripts are scoped per account, so each creator can have their own voice and content library.

What is the Vault?

The Vault is the creator's media library stored on Fanvue. Mappa Pro lets chatters browse this library and attach content to messages or PPV without needing to download and re-upload anything.

Using the Vault in inbox

How mass messages work

Mass messages let you send one message to a large segment of fans at once. You can target smart lists (built from fan behavior like subscription status or spend tier) or custom lists you've created manually.

Sending a mass message

Enabling notifications

Inbox badge

The Inbox nav button shows a live unread count badge that updates in real time as new messages arrive. Per-account unread counts are also visible in the Accounts tab.

Overview tab

The Overview tab is your agency command center. It shows aggregate data across all connected accounts:

Time periods

Insights tab

The Insights tab goes deeper with three sub-tabs:

• Earnings — transaction-level breakdown with charts, source split (subscriptions / PPV / tips), and top spenders
• Monthly Earnings — month-over-month comparison chart
• Subscribers — subscriber growth over time with daily breakdown

Earnings tab features

• KPI cards — total earnings, current month earnings with month-vs-year badge, sparkline charts
• Gross / Net toggle — switch between pre-fee and post-fee revenue view
• Time-series line chart — earnings over your selected period
• Daily bar chart — revenue broken down by day
• Source donut chart — percentage split between Subscriptions, PPV, and Tips
• Breakdown table — sortable transaction list with date, type, gross, net, and fees
• Top spenders list — expandable list of fans by gross spend with percentages

Account selector

Use the account dropdown to filter all charts and data to a specific Fanvue creator account, or view all accounts combined.

Subscribers tab

In Insights → Subscribers, you can view:

• Subscriber count as a line chart over your selected period
• Daily subscriber gains and losses
• Net growth for the period
• Comparison across periods to identify trends

Key metrics

• Total Subscribers — active subscriber count right now
• New Subscribers — new subs added in the period
• Both available on the Overview dashboard and Subscribers sub-tab

What can be exported

• Earnings CSV — all transactions for the selected period and account (date, type, gross, net, fees)
• Chatter breakdown CSV — per-chatter performance data from the Earnings & Payouts tab
• Activity log CSV — team audit log (owners only)

How to export

Click the Export CSV button in the Insights tab or Earnings & Payouts tab. The file downloads immediately to your device. Export is available to owners and managers only — chatters do not have access to this feature.

Role overview

Permissions table

Clocking in and out

Chatters click the clock icon in the sidebar to start and end shifts. The system records:

• Shift duration — total minutes worked per session
• Messages sent — every message logged automatically in the background
• PPV sent & revenue — count and dollar value of PPV content sent this shift
• Fans messaged — unique fan count per shift
• Average response time — seconds to first reply on each inbound message

Performance cards (owners/managers)

In Earnings & Payouts, each chatter gets a card with two groups:

• Revenue: Gross · Net · Commission · PPV Revenue
• Activity: PPV Sent · Hours Worked · Shifts · Messages Sent

A Live / Offline badge shows whether the chatter is currently clocked in.

Chatter's own view

Chatters can see their personal KPIs in the Earnings & Payouts tab — their own stats only. No revenue figures or other team members' data is visible to them.

Filtering by period

Performance stats can be filtered by: 7 days, 30 days, this month, this year, or all time.

Configuring your commission rate

In Earnings & Payouts, click the ⚙️ gear icon on the Commission card:

• Base toggle — choose Gross (before Fanvue's platform fee) or Net (after fee)
• Rate slider — 0% to 100%

Settings are saved per-device and apply immediately to all calculations on the screen.

How commission is calculated

For each chatter: Commission = PPV Revenue (gross or net) × Rate

The result is shown on their performance card and updates live when you adjust the rate or change the period.

Top KPI cards

By account section

Below the KPIs, each connected account gets a row showing its own gross, net, commission, and chatter activity. You can also click Request Payout on Fanvue to go directly to Fanvue's wallet page.

Chatter performance cards

Every chatter in your agency gets a card showing their Revenue group and Activity group stats. See Chatter clock-in & performance for full details.

What's in a fan profile

Visible inside every inbox conversation (right panel) and in the fan detail view:

• Lifetime spend — total gross spend on the creator
• Last purchase — date and amount of most recent transaction
• Days since last active
• PPV stats — total PPV revenue, average price, full purchase history
• Tip stats — total tips and average tip
• Subscription info — status (Active/Expired/None), cost, duration, auto-renewal
• Fan type badge — Subscriber, Free Follower, Supporter, etc.

Where to find it

• Overview tab — Top Spenders widget showing the highest-spending fans across all accounts for the selected period, with avatar, name, handle, and amount
• Insights → Earnings tab — expandable top spenders list with percentage of total revenue per fan

How to use top spenders data

• Prioritize these fans for personal, high-effort outreach
• Identify fans most likely to purchase premium PPV
• Track whether your top spenders are staying engaged over time
• Use the per-account dropdown to see top fans for a specific creator

Custom nicknames

In the fan detail panel inside any conversation, you can set a custom nickname for the fan. This is a private label visible only to your team — not to the fan. It's useful for remembering who's who without relying on Fanvue display names.

Notes

The Notes field in the fan panel is a free-text area for anything your team needs to remember about that fan — their preferences, what content they like, when they last bought PPV, etc. Notes auto-save as you type.

Follow-up flags

Mark any fan with a follow-up flag to surface them in your filter presets. This ensures high-priority fans don't get lost in a full inbox. You can create inbox filter presets that show only flagged conversations.

Profile tab

• Display name — edit your name shown across the platform
• Email — display only, cannot be changed from the app
• Role badge — your current role in the organization
• Team digest emails (managers/owners) — enable scheduled digest emails at 8am, 11am, 2pm, 5pm, 8pm, 11pm. Send a test email anytime.

Organization tab (managers/owners)

• Agency name — editable, updates across the dashboard
• Plan badge — shows current subscription tier

Changing your password

How we protect your data

• Secure Fanvue connection — Account connections use Fanvue's official authorization flow. Your creator passwords never reach Mappa Pro servers.
• Encrypted token storage — All Fanvue access tokens are encrypted before being stored.
• Authenticated requests — Every request between your browser and our backend is authenticated and verified.
• Organization-level data isolation — Users can only access data belonging to their own organization.
• Server-side role enforcement — Permissions are enforced on the server. Access cannot be escalated from the browser.

Accessing billing

Go to Settings → Billing (visible to owners only). Here you'll see your current plan, the features included, and an upgrade option if you're on a lower tier.

Plans

Mappa Pro offers tiered plans — Starter, Growth, Pro, and Agency — each with increasing account limits, team member seats, and feature access. Current plan details are shown in the Billing tab and as a badge in the Organization tab.

What's logged

• Team member invites and removals
• Account connections and disconnections
• Role changes
• Settings updates
• Mass message sends
• Commission rate changes

Using the activity log

Go to Settings → Activity Log (owners only). You can filter by team member or action type, and export the full log as a CSV for your records.