Settingsintermediate

How to Set Up Trustpilot Review Conversations

Connect a Trustpilot Business Unit in Settings → Trustpilot → Reviews, enable the Trustpilot channel, and configure the webhook so new, revised, and deleted reviews arrive as inbox conversations you can reply to from Atender.

10 min read

How to Set Up Trustpilot Review Conversations

Trustpilot Reviews is a separate capability from the Trustpilot invitation integration. Instead of sending review invitations by email, it receives reviews left on a connected Trustpilot Business Unit and turns each one into a conversation on a dedicated Trustpilot channel in your inbox — where agents can read, discuss internally, and reply, with the reply posted back to Trustpilot as the business’s public response.

Everything for this capability lives in Settings → Trustpilot → Reviews, alongside the existing Settings and Invitations tabs.

Before you start

You’ll need, from your Trustpilot Business account:

  • The Business Unit ID for the unit whose reviews you want in Atender
  • An API key and API secret issued for that business unit

Atender uses the key and secret to request an access token from Trustpilot on your behalf (a client-credentials style exchange); it does not use your Trustpilot login.

Step 1: Open the Reviews tab

Go to Settings → Trustpilot. The page has three tabs — Settings, Reviews, and Invitations. Open Reviews.

The tab is organized into four cards:

  • Channel switch — Turns the Trustpilot reviews channel on or off
  • Connection — Business unit ID, API key, API secret, reply author, plus Connect and Test connection
  • Webhook URL — The per-tenant URL to register in Trustpilot Business, and a one-time webhook secret
  • Sync status — Whether the connection is healthy, needs re-authentication, or errored

Step 2: Enter your connection details

In the Connection card, fill in:

  • Business Unit ID — the Trustpilot business unit reviews will be pulled from
  • API key / API secret — issued by Trustpilot for that business unit
  • Reply author — the name Trustpilot will show as the author of any reply Atender posts on your behalf

Entering a new API key resets the existing connection, since Trustpilot treats a new key as a new credential pair.

Step 3: Connect and test

Click Connect. Atender requests a fresh access token with the credentials you entered and, if that succeeds, reads a single review from the business unit to confirm access. A successful connect also arms a 30-day backfill window, so reviews left in the last 30 days are eligible to be pulled in once polling or the webhook starts running.

Use Test connection at any point afterward to re-verify the credentials without re-running the backfill logic.

If the credentials are invalid or later expire, the Sync status card shows the connection as needing re-authentication rather than failing silently.

Step 4: Turn the channel on

Flip the channel switch to enable the Trustpilot reviews channel. Turning it on (like a fresh Connect) immediately runs one poll cycle rather than waiting for the next scheduled one, so you don’t have to sit around for reviews to show up.

Save the page. The business unit ID and reply author are carried by the page-level Save; the key, secret, and webhook secret are managed through the Connect/Test/webhook actions in their own cards.

Step 5: Register the webhook

The Webhook URL card shows the URL for this tenant. Register that URL in your Trustpilot Business account as the destination for review webhook events. When you set the webhook up, Atender generates a webhook secret — it’s shown to you once, at creation time, so copy it somewhere safe; Atender doesn’t display it again afterward.

Every incoming webhook call is verified with that secret before it’s trusted, so an out-of-date or missing secret means events will be rejected rather than silently dropped.

If your Trustpilot plan or business unit doesn’t support registering a webhook, don’t worry — reviews still arrive through polling (see below), just with more latency.

Polling as a fallback

Whether or not the webhook is set up, Atender also polls the business unit for new reviews on a 15-minute cycle, looking back a few days past the last cursor position to catch anything the webhook missed. This means:

  • If the webhook is working, reviews normally show up within moments of being left.
  • If the webhook isn’t set up (or briefly fails), the same review still arrives within the next poll cycle.

You can also trigger an on-demand poll rather than waiting for the schedule — useful right after connecting, or if you want to confirm sync is working without touching settings again.

What happens in the inbox

Once the channel is on and reviews start flowing in, here’s what agents see:

  • A new review becomes a new conversation on the Trustpilot channel, with the review text delivered as the first inbound message and a contact created for the reviewer.
  • A revised review (the reviewer edited their review) doesn’t create a new conversation. Instead, the existing conversation gets a system update showing the new star rating, title, and text, and the conversation re-opens into your pending queue if it had been resolved.
  • A deleted review appends a system event to the conversation and archives it — no further action is expected from an agent.
  • If Atender sees the exact same review content again (for example, both the webhook and a poll cycle picked up the same event), nothing changes — it’s treated as a no-op rather than a duplicate update.

Each review conversation is tied to its Trustpilot review, so revisions and deletions always land on the same conversation rather than creating a new one.

Replying to a review

Agent replies sent from a Trustpilot review conversation are posted back to Trustpilot as the business’s public reply, attributed to the reply author name configured in the Connection card. If the reviewer later edits or removes their review, that’s reflected back into the same conversation as described above — you don’t need to go looking for a new one.

Disconnecting

Turning the reviews connection off from the Connection card disables the channel and drops the stored access tokens. Existing Trustpilot conversations in your inbox are left as-is; only future review sync is stopped.

Tags

How ToTrustpilotReviewsChannels