Trusted Shops

At a glance

Availability: Experimental (how to enable).
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

Set these per environment. See Connect an integration.

Variable	Required	Description
`ETRUSTED_CLIENT_ID`	Yes	eTrusted API client ID Docs.
`ETRUSTED_CLIENT_SECRET`	Yes	eTrusted API client secret Docs.

Get an eTrusted account: You need a Trusted Shops membership with access to the eTrusted Control Centre at https://app.etrusted.com/.
Generate API credentials: Follow 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.
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 via the OAuth2 client_credentials grant with audience https://api.etrusted.com.
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 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.

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

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.