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

# Reputation Studio

> Turn every closed deal into a governed review, a public reputation profile, and the next referral.

Reputation Studio is Winnerr's post-transaction reputation and referral engine. It captures client reviews from real closings, governs them through an approval lifecycle, publishes them to a premium public agent profile and an embeddable widget, and harvests the referral that re-enters the pipeline as a new lead.

It sits alongside [Marketing](/marketing/overview) as a sibling growth surface: where Marketing is the outbound workspace, Reputation Studio is the post-transaction trust workspace. Both reuse the same Brand Kit, so an agent's headshot, colors, disclaimers, and approved testimonials are authored once and consumed everywhere.

## The flywheel

```text theme={null}
Close (Deal won)
  ↓
Post-transaction survey (auto-launched on DEAL_WON)
  ↓
Client rates with your chosen sentiment style (Stars, Thumbs, Faces, NPS, or Number)
  ↓
Happy client → Smart Review Composer → Copy & open Google / Facebook / Yelp / custom
Unhappy client → Private feedback channel → Agent alerted (in-app + email)
  ↓
Agent approves + publishes testimonial
  ↓
Public reputation profile + embeddable widget + Growth Studio reviews block + syndication
  ↓
Referral CTA → new Person (lead source: REFERRAL)
  ↓
New lead re-enters the pipeline at the top
```

Every closing produces a review, every review produces social proof, and every piece of social proof produces a referral that becomes the next lead.

## What's in Reputation Studio

<CardGroup cols={2}>
  <Card title="Review request setup" icon="clipboard-question" href="/reputation/surveys">
    Configure the post-transaction survey: sentiment style (Stars, Thumbs, Faces, NPS, Number), review experience (Compliant vs. Strict), platform connections, and the Smart Review Composer.
  </Card>

  <Card title="Testimonials" icon="quote-right" href="/reputation/testimonials">
    Pending to Approved to Published lifecycle with explicit consent and visibility controls.
  </Card>

  <Card title="Public profile" icon="user-tag" href="/reputation/public-profile">
    Publish your reputation page, get a shareable link at `/r/your-slug`, and manage your profile identity.
  </Card>

  <Card title="Reviews widget" icon="code" href="/reputation/widgets">
    Embed your published reviews on your own website with a one-line snippet. Configure layout, colors, and an origin allowlist.
  </Card>

  <Card title="Reviews on your Winnerr site" icon="star" href="/reputation/growth-studio-reviews">
    Add the Growth Studio `agentReviews` block to any site you build — renders published reviews with star-rating structured data.
  </Card>

  <Card title="Referrals" icon="share-nodes" href="/reputation/referrals">
    Per-referral ledger captured from the public profile CTA and tied back to the resulting deal.
  </Card>

  <Card title="Referral rewards" icon="gift" href="/reputation/rewards">
    Mark a reward sent when a referral converts and Winnerr auto-thanks the referrer by email or SMS.
  </Card>

  <Card title="Review syndication" icon="arrow-right-arrow-left" href="/reputation/syndication">
    Google Place ID, Facebook Page URL, Yelp (opt-in with compliance warning), and custom platforms. Import existing Google reviews.
  </Card>
</CardGroup>

## Core principles

* **Transaction-triggered.** A survey is never a manual blast — it is scheduled from a real `Deal` reaching the won stage.
* **Agent-governed.** Nothing becomes public on its own. Every public action passes through an explicit approve and publish step.
* **Sentiment-aware routing.** Regardless of which style (Stars, Thumbs, Faces, NPS, Number) the client uses, the rating is normalized to a 1-5 scale. Ratings below 4 route to the private feedback channel.
* **CRM-closed-loop.** Referrals captured on the public profile create a `Person` with lead source `REFERRAL` and re-enter the same pipeline.
* **Consent-first.** The client's permission to use their name, photo, and quote publicly is captured as part of the survey and stored alongside the testimonial.

## Lifecycle at a glance

| Stage                     | Object                | Status path                                      |
| ------------------------- | --------------------- | ------------------------------------------------ |
| Survey scheduled          | `Survey`              | `SCHEDULED` to `SENT` to `OPENED` to `COMPLETED` |
| Response captured         | `SurveyResponse`      | Submitted via the public tokenized page          |
| Testimonial drafted       | `Testimonial`         | `PENDING` (private)                              |
| Agent approves            | `Testimonial`         | `APPROVED` (still private)                       |
| Agent publishes           | `Testimonial`         | `PUBLISHED` + visibility `PUBLIC`                |
| Aggregate recomputed      | `ReputationAggregate` | Rating, NPS, response rate, velocity refreshed   |
| Referral captured         | `Referral`            | `RECEIVED` to linked resulting `Deal`            |
| Deal closes from referral | `Referral`            | Agent notified; reward marked `PENDING`          |
| Agent marks reward sent   | `Referral`            | `rewardStatus: SENT` — referrer auto-thanked     |

## Related

* [Review request setup](/reputation/surveys) — sentiment style, review experience, platform connections, and the Smart Review Composer.
* [Testimonials](/reputation/testimonials) — approval inbox, consent, and visibility.
* [Public profile](/reputation/public-profile) — slug, publish button, shareable link, draft/published lifecycle.
* [Reviews widget](/reputation/widgets) — one-line embed for your own website.
* [Reviews on your Winnerr site](/reputation/growth-studio-reviews) — Growth Studio `agentReviews` block with structured data.
* [Referrals](/reputation/referrals) — capture and pipeline re-entry.
* [Referral rewards](/reputation/rewards) — reward queue and auto-thank policy.
* [Review syndication](/reputation/syndication) — outbound links, Yelp compliance, and Google Business import.
* [Reputation API](/api-reference/reputation) — authenticated and public endpoints.
* [Marketing](/marketing/overview) — sibling Growth Studio surface that shares the same Brand Kit.