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
Credentials
Set these per environment. See Connect an integration.Setup
- 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.
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.