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

# Trusted Shops

> Read Trusted Shops (eTrusted) reviews, channels, and aggregate ratings, and schedule review invites

## At a glance

* **Availability**: Experimental ([how to enable](/cloud/integrations)).
* **Auth**: OAuth 2.0 (client credentials).
* **Connection**: Veryfront mints machine-to-machine tokens from the client ID and secret in the project's environment variables.
* **Docs**: [https://developers.etrusted.com/docs/authentication](https://developers.etrusted.com/docs/authentication)

## Credentials

Set these per environment. See [Connect an integration](/cloud/integrations).

| Variable                 | Required | Description                                                                                         |
| ------------------------ | -------- | --------------------------------------------------------------------------------------------------- |
| `ETRUSTED_CLIENT_ID`     | Yes      | eTrusted API client ID [Docs](https://developers.etrusted.com/docs/generating-api-credentials).     |
| `ETRUSTED_CLIENT_SECRET` | Yes      | eTrusted API client secret [Docs](https://developers.etrusted.com/docs/generating-api-credentials). |

## Setup

1. **Get an eTrusted account**: You need a Trusted Shops membership with access to the eTrusted Control Centre at [https://app.etrusted.com/](https://app.etrusted.com/).
2. **Generate API credentials**: Follow [https://developers.etrusted.com/docs/generating-api-credentials](https://developers.etrusted.com/docs/generating-api-credentials) to create an API client in the Control Centre. You receive a client ID and a client secret.
3. **Set environment variables**: Add ETRUSTED\_CLIENT\_ID and ETRUSTED\_CLIENT\_SECRET to your .env. Access tokens are minted automatically from [https://login.etrusted.com/oauth/token](https://login.etrusted.com/oauth/token) via the OAuth2 client\_credentials grant with audience [https://api.etrusted.com](https://api.etrusted.com).
4. **Verify access**: Run List Channels - it requires no parameters and returns the channels (chl-.... IDs) you will use to filter reviews and send invites.

* Access tokens expire after 300 seconds (5 minutes); they are refreshed automatically per request session.
* The token request must include audience=[https://api.etrusted.com](https://api.etrusted.com) alongside client\_id, client\_secret, and grant\_type=client\_credentials.
* Review invites require an invite template and questionnaire template configured in the Control Centre; every invite must include both template.id and questionnaireTemplate.id.

Provider API reference: [https://developers.etrusted.com/](https://developers.etrusted.com/)

## Tools

| Tool                         | Access | Description                                                                                                                                |
| ---------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------ |
| List Reviews                 | Read   | List service and product reviews for the whole account or specific channels, with filters and cursor pagination                            |
| Get Review                   | Read   | Get a single review with full comment, customer, transaction, product, and reply details                                                   |
| List Channels                | Read   | List all review channels (shops/touchpoints) of the account with their IDs, names, URLs, and locales                                       |
| Get Channel Aggregate Rating | Read   | Get aggregate service review ratings for a channel across 7-day, 30-day, 90-day, 365-day, and overall periods, including star distribution |
| Create Review Invites        | Write  | Schedule review invite emails for one or more customers of a channel after a transaction                                                   |
| Get Reviews Count            | Read   | Get the total number of reviews matching a filter - cheap KPI queries without paging through review lists                                  |
| Reply to Review              | Write  | Save a public reply on a review - the natural follow-up to negative reviews                                                                |

## Example prompts

* List my most recent Trusted Shops reviews and summarize ratings and common themes.
* Show Trusted Shops reviews with 1 or 2 stars from the last 30 days that have no reply yet.
* List my Trusted Shops channels and show the 365-day aggregate rating for each.