> ## 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.

# Review syndication

> Connect Google, Facebook, Yelp, and custom platforms. Import your existing Google reviews into Winnerr.

Review syndication connects your Winnerr reviews to the broader review platforms your clients already use. It works in two directions:

* **Outbound** — when a happy client completes a survey, the thank-you screen (and Smart Review Composer) shows "leave us a review" links for each platform you have configured.
* **Inbound** — connect your Google Business Profile to pull your existing Google reviews into Winnerr as pending testimonials for approval.

Managed under **Marketing → Reputation → Profile**.

## Outbound: review-request links

Winnerr generates outbound review-request links for each platform you configure automatically once a happy client submits a survey — provided you have saved the corresponding keys on your profile.

Winnerr never posts a review on your behalf. The links let a satisfied client go directly to your Google, Facebook, Yelp, or custom review page to leave their own review.

### Supported platforms

| Platform     | Where to configure                            | Notes                                                                                                        |
| ------------ | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| **Google**   | Syndication keys card — **Google Place ID**   | Alphanumeric, starts with `ChIJ…`. Winnerr builds a `search.google.com/local/writereview?placeid=…` link.    |
| **Facebook** | Syndication keys card — **Facebook Page URL** | Full URL to your Facebook business page (e.g. `https://facebook.com/yourpage`). Winnerr appends `/reviews/`. |
| **Yelp**     | Review experience card — **Yelp page URL**    | Off by default. Requires acknowledging the compliance warning. See below.                                    |
| **Custom**   | Review experience card — **Custom platforms** | Up to 10 entries. Each has a label and a URL.                                                                |

Platforms render on the client's survey thank-you screen in the order: Google → Facebook → Yelp → custom.

### Yelp compliance

<Warning>
  Yelp's Terms of Service prohibit businesses from soliciting reviews. Directing clients specifically to your Yelp page to leave a review can result in your listing being filtered, flagged with a Consumer Alert, or penalized. Yelp is **off by default** in Winnerr. The app displays a warning before you can save a Yelp URL. Add Yelp only if you understand this risk. Note: switching to Compliant review gating mode does not make Yelp safe to solicit — this is a Yelp platform rule, not a Winnerr setting.
</Warning>

To enable Yelp: go to **Marketing → Reputation → Profile → Review experience**, enter your Yelp page URL, acknowledge the warning, and save.

### Set up syndication keys

1. Go to **Marketing → Reputation → Profile**.
2. In the **Syndication keys** card, enter:
   * **Google Place ID** — the alphanumeric Place ID for your business listing (starts with `ChIJ…`).
   * **Facebook Page URL** — the full URL to your Facebook business page.
3. Click **Save syndication keys**.

To add Yelp or a custom platform:

1. In the **Review experience** card, enter your Yelp URL and/or add custom platform entries (label + URL).
2. Click **Save review experience**.

Once saved, every happy survey response will include the configured platforms on the thank-you screen.

### Finding your Google Place ID

Your Google Place ID is available in the [Google Place Finder](https://developers.google.com/maps/documentation/javascript/examples/places-placeid-finder). Search for your business and copy the Place ID shown — it looks like `ChIJN1t_tDeuEmsRUsoyG83frY4`.

### Smart Review Composer

For happy clients (rating ≥ 4) who also wrote a comment, the thank-you screen upgrades to the **Smart Review Composer** — an editable text box pre-filled with the client's words, an optional "Polish with AI" button (rewrites their words, never fabricates), and per-platform **"Copy & open \[Platform]"** buttons that copy the review text and open the platform simultaneously. See [Review request setup](/reputation/surveys#smart-review-composer) for full details.

## Inbound: Google Business Profile import

Connecting your Google Business Profile lets Winnerr periodically pull your existing Google reviews in. Each imported review lands as a **pending, private testimonial** — it does not appear anywhere publicly until you approve and publish it.

### Connect your Google Business Profile

1. Go to **Marketing → Reputation → Profile**.
2. In the **Google Business Profile** card, click **Connect Google Business Profile**.
3. You will be redirected to Google's consent screen. Sign in and grant access.
4. Once connected, Winnerr saves your account credentials and begins pulling reviews on its regular schedule.

Connecting requires Google OAuth credentials to be provisioned for the platform. If the button is unavailable or returns an error, contact Winnerr support.

### What gets imported

For each Google review pulled in, Winnerr creates or updates a `Testimonial` row with:

* Source: `SYNDICATED_PULL`
* Status: `PENDING`
* Visibility: `PRIVATE`
* Rating and review text from the Google review
* Reviewer display name (if provided by Google)

Reviews are upserted — if a reviewer edits their Google review, the next pull updates the body and rating in Winnerr without creating a duplicate. The status and visibility you have set in Winnerr are not downgraded on a re-pull.

Each imported review also gets a `ConciergeProposal` of type `approve_and_publish_testimonial` so it surfaces in the AI review queue for your attention.

### Approval required

Imported Google reviews follow the same approval flow as any other testimonial:

```text theme={null}
PENDING (imported) → you approve → APPROVED → you publish → PUBLISHED
```

Nothing from the import is ever public until you explicitly publish it.

### Google Business location name

After connecting, the **Google Business location name** field on the syndication keys card is set automatically (format: `accounts/123/locations/456`). This is the location resource Winnerr uses when pulling reviews. You can view it but do not need to edit it manually.

### Why only Google for inbound?

Inbound import is **Google-only** today. Facebook is supported for **outbound** review-request links (the "leave us a review" path), but Winnerr cannot pull your existing Facebook reviews in.

<Note>
  Reading a Facebook Page's ratings and recommendations through Meta's Graph API requires the `Page Public Content Access` feature plus a completed App Review and Business Verification — permissions Meta grants only to approved apps for specific, reviewed use cases. Until that approval is in place, Facebook inbound import stays unavailable rather than silently failing. Your Facebook **outbound** link keeps working regardless. Yelp likewise offers no compliant inbound review API. When Facebook inbound becomes available it will follow the exact same pending-then-approve flow as Google.
</Note>

## Related

* [Review request setup](/reputation/surveys) — how sentiment style and gating interact with platform links.
* [Testimonials](/reputation/testimonials) — the approval flow that imported reviews move through.
* [Public profile](/reputation/public-profile) — where syndication keys and review experience settings live alongside your profile identity and the publish button.
* [Reputation overview](/reputation/overview) — the full Reputation Studio flywheel.