Collecting video reviews
Customers who bought the same product each record a short video review, one after another, into the same container. You read them back afterwards — gallery mode, as many messages as the container collects.
Prerequisites
The difference between single and gallery containers — see Container modes: single and gallery.
Create the container in gallery mode
mode is ignored if the container already exists, so it must be set on this very first call. A review-collection container started in single mode cannot be switched to gallery afterwards — you would need a new crid.
curl -X POST https://client-api.v5.livstick.com/api/v3/containers \
-H "Authorization: Bearer {ACCESS_TOKEN}" \
-H "Content-Type: application/json" \
-d '{ "crid": "PRODUCT-42-REVIEWS", "mode": "gallery", "language": "en_us" }'Let each customer record into it
Mount the Recorder against the container’s urid for each customer who reviews. Every recording lands as its own message inside the same gallery container.
<LivstickWidget uid="code" domain="example.com" />List the collected messages
GET /messages filtered by crid returns every message recorded into this container so far — the N reviews collected to date.
curl "https://client-api.v5.livstick.com/api/v3/messages?crid=PRODUCT-42-REVIEWS" \
-H "Authorization: Bearer {ACCESS_TOKEN}"Play a review back
Mount the Viewer with the container’s urid to play any one of the collected reviews on your own page.
import { LivstickViewer } from "@livstick/widget-viewer";
<LivstickViewer uid="code" domain="example.com" />Next steps
This page covers collection and playback through the API only. A dashboard for browsing reviews, or any moderation step before a review is shown, is part of the Insight product and is not yet settled — it is intentionally left out here.