HG Hulo Global

Review Requests — User Manual

Overview

Review Requests automatically invites customers to review you after they buy, timed off the order date. An hourly worker finds orders that reached a milestone (Delivered / Payment settled / Shipped) a set number of days ago and emails a branded, Trustpilot-style invitation.

It uses the free Trustpilot review page for the link — no paid Automatic Feedback Service — and can optionally read your live TrustScore from the free Trustpilot API to show as social proof. The whole thing is per-channel, deduped, and respectful: exclusions, a per-customer cooldown, a minimum order value, and one-click unsubscribe.

Install

One package, one config block. Tables are created on boot; emails go via your SMTP.

# 1. Install yarn add @huloglobal/vendure-plugin-review-requests # 2. Register in vendure-config.ts import { ReviewRequestPlugin } from '@huloglobal/vendure-plugin-review-requests'; export const config: VendureConfig = { plugins: [ ReviewRequestPlugin.init({ publicBaseUrl: 'https://shop.example.com', // for unsubscribe links licenceKey: process.env.HULO_LICENCE_KEY_REVIEW_REQUESTS, }), ], }; # 3. Admin UI — add to your compileUiExtensions extensions array: ReviewRequestPlugin.uiExtensions

Then open Review requests in the admin, set your Trustpilot domain, timing and email, hit Send test, and switch the channel on.

Free Trustpilot setup

Everything here is free — no paid Trustpilot plan.

  • Review link — nothing to set up. The button links to https://www.trustpilot.com/evaluate/<your-domain>, which opens a Service Review form. These land as organic reviews.
  • Live rating (optional) — register a free developer app at developers.trustpilot.com for an API key, paste it into Settings and click Check rating. The plugin finds your business-unit id from the domain and shows your TrustScore + review count in the email.
  • Google reviews live rating — pick Google in the platform selector, add a Google Maps API key (Places API enabled) and your Place ID, then Connect. The email shows your live Google star rating the same way, and the review button drops customers straight on Google's "write a review" box.
  • Point elsewhere — the review-link template is configurable, so you can send customers to Google reviews or any URL instead.

Timing & rules

SettingDefaultWhat it does
Trigger stateDeliveredThe order milestone that starts the clock (Delivered / Payment settled / Shipped).
Delay (days)14How long after the order date to send.
Min order value0Skip orders below this value.
Cooldown (days)120Never invite the same customer more often than this.
Max per run200Safety throttle per hourly run.

Every invitation is deduped per order, and the plain-English status line at the top of the admin page always tells you exactly what the current settings will do.

Exclusions & opt-out

Exclude any email or whole domain in the Exclusions tab — wholesale accounts, staff, VIPs. Every invitation carries a signed one-click unsubscribe link; anyone who clicks it is added to the opt-out list automatically and never emailed again. The full send history (sent / skipped / failed, with reasons) is in the Activity tab.

The email

The invitation subject and HTML body are fully editable per channel, with variables {{firstName}}, {{orderCode}}, {{businessName}}, {{reviewUrl}} and a {{ratingBlock}} that renders your live stars when available. Use Preview to see it with sample data and Send test to email a copy to yourself before going live.

Product reviews. Under What to ask for in Settings, choose Store review, Product reviews, or Both. In product (or both) mode the email lists the actual products from the customer's order, each with its own "Review this" button linking to your storefront's product-review page — set the link template (with {slug}, {name}, {orderCode}) in Settings. Two extra template variables, {{reviewButton}} and {{productList}}, control where the store button and the product list appear.

Licensing

Free tier: configure, preview and test-send. Scheduled sending requires a licence from the plugin page — monthly with a 7-day free trial, or lifetime. Set the key as HULO_LICENCE_KEY_REVIEW_REQUESTS.