Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.buildbetter.ai/llms.txt

Use this file to discover all available pages before exploring further.

Success is BuildBetter’s Customer Success workspace. It pulls contracts from Salesbricks, billing state from Stripe, usage from PostHog, and signals from your customer conversations into one place — so a CSM can answer “who’s at risk?”, “who’s about to convert?”, “who needs an outreach?” without leaving a single screen.
Success is gated by the success feature flag. Without access, you’ll land on /success-unlock with a request-access form. Every page also supports Preview with demo data (Pied Piper sample dataset) so you can explore before connecting integrations.

The Six Pages

Health

The renewal-and-risk queue. Health scores, ARR distribution, accounts approaching renewal, payment state.

Customer Detail

Per-account hub. Score, metrics, activity feed, revenue sources, HubSpot enrichment, risk factor breakdown.

Convert

Prioritize trial and prospect accounts by conversion likelihood and urgency. Sync from Salesbricks + Stripe.

Contracts

Contract listings with renewal dates, payment state, MRR/ARR — across Salesbricks and Stripe.

Pipeline

Kanban + table views of deal pipeline, enriched with Health and Convert context.

Re-engage

Closed-lost revival queue. AI-scored re-engagement likelihood, lost-value totals, prioritized outreach.
Plus:

Close the Loop

Match customer feature requests against shipped releases (GitHub / RSS / changelog) and send “we shipped your request” emails.

Settings & Data

Integrations (Salesbricks, Stripe, PostHog, Attio, HubSpot), demo mode, the route-accounts model.

Core Concepts

ConceptWhat It Means
Health score0–100, computed per account from adoption, payment state, renewal pressure, and signals. Color-coded: green (healthy), amber (at risk), red (critical).
Risk factorsThe specific reasons behind a score (e.g., “−8 Low product adoption (PostHog)”, “−5 Payment failed (Stripe)”). Visible on every account row and detail page.
Routed accountsAn account you’ve moved from one Success section to another (e.g., from Health → Convert). Shows up at the top of the destination with a “Routed from Health” badge.
Revenue sourceA Salesbricks contract or Stripe subscription linked to an account. An account can have multiple.
Untracked accountAn account you’ve explicitly excluded from health monitoring. Hidden by default; toggle to show.
Demo modePer-page sample dataset (Pied Piper) you can preview without live integrations.

How Success Plugs into BuildBetter

  • Signals drive the Risk factors breakdown — every score has cited evidence from calls, support, surveys
  • Calls and projects show up in the per-customer activity feed
  • Projects’ Close-the-Loop is the per-project view; Success’s Close-the-Loop is the per-account view across all projects
  • Floating Chat is available on every customer page for ad-hoc questions (“why is this account critical?”)
  • Settings → Integrations is where you connect Salesbricks, Stripe, PostHog, Attio, HubSpot

The Route-Accounts Model

The six Success pages aren’t isolated tabs — they’re stages of a workflow you can flow accounts through. Each account row has a Route to menu that moves the account to:
  • Convert — when a trial account looks ready to upgrade
  • Pipeline — when an account becomes a real expansion opportunity
  • Contracts — when you need to review the renewal in detail
  • Re-engage — when an account has churned and is worth a winback
The destination shows a “Routed from Health” (or similar) badge so you can see the origin and stage transitions.

Data Sources at a Glance

SourceWhat It Powers
SalesbricksContracts, orders, trial metadata, deal stages, closed-lost reasons
StripeSubscriptions, invoices, payment state, MRR/ARR calculations
PostHogActive-user counts, feature adoption, weekly trends
AttioOptional CRM source for Pipeline (alternative to Salesbricks)
HubSpotOptional enrichment — industry, size, location, custom fields
BuildBetterSignals, calls, projects, requests — feed risk factors and Close-the-Loop
GitHub / RSS / changelogShipped feature catalog for Close-the-Loop matching
See Settings & Data for connection setup.
If you’re new to Success, start on Health — it’s the highest-signal page for spotting accounts that need attention this week. Once you’ve triaged the critical ones, work down to Convert (trials to chase), then Contracts (renewals in 30 days).