Reviews · Features
Reviews Customer API and webhooks
Integrate provider-neutral Reviews through a separate Customer API module with scoped access and shared signed webhooks.
PENDING-RELEASE — Availability is limited. This article does not describe the feature as generally available.
Verified 2026-09-04 · Source da3f301 · Requires product verification
What this does
Authoritative API reference: https://developer.smartq.tv/reviews. This implementation is pending review and deployment. Reviews has its own module, not ShiftQ. Provider capabilities differ from Customer API permissions: Google documents reply update/delete but SmartQ does not expose Google publishing through customer credentials. Reporting is manual through Google's official flow; there is no report API. No summary or widget/settings API is exposed. Existing Reviews product notifications remain separate from Customer API webhook destinations.
Steps
- After release, open Settings > API Access and select Reviews for an application authorized for the required locations.
- Use reviews:read for eligible provider reads and metadata-only Reviews webhooks; Google content reads currently return 409.
- Grant reply permission separately only when needed; Google Customer API publishing is currently unavailable under provider-project policy.
- Configure the existing Customer API webhook destination, choose Reviews events, and copy its one-time signing secret into your server-side secret manager.
- Verify a synthetic test using the shared HMAC signature, then deduplicate eventId; Google resource links remain policy-gated.
What happens next
Your change is available within the scope you selected.
Warnings
- Do not interpret a reply scope as Google authorization or permission to automate publishing.
- Google Customer API reads and reply writes are disabled pending provider-policy authorization; SmartQ interactive replies remain available to authorized merchants.