Documentation
Voicebox is two things: a widget your users write into, and an analysis layer that turns what they write into a ranked list of things to fix. Getting the first part running takes one line.
<script async
src="https://www.usevoicebox.dev/widget.js"
data-project="pk_live_your_key"></script>That is the whole installation. Your project key is on the Widget page in the dashboard, where the snippet comes pre-filled. Not using plain HTML? Every framework and site builder is one page over.
Nothing to install first
How it fits together
- 01The widget collects
A button in the corner of your site, or your own button. Renders in a shadow root so your CSS and ours can never collide, around 11KB over the wire, loaded on idle, and it never blocks your page.
- 02Ingest validates
Submissions are checked against your project key and domain allowlist, rate-limited per IP, and screened for bots without making anyone solve a captcha.
- 03Analysis enriches
Each one gets a sentiment score, an intent category, and a one-line summary, usually within seconds of arriving. Only the message, type, and rating are sent to the model.
- 04Clustering groups
Feedback describing the same underlying problem is merged into a named theme, ranked by volume, sentiment and recency, so the top of the list is the thing worth fixing next.
Where to go next
HTML, Next.js, React, Vue, Svelte, Astro, WordPress, Shopify, Webflow, GTM
Your own button, keyboard shortcuts, and attaching who the user is
Colors, copy, position, which questions to ask
Keys, domain allowlist, CSP, and exactly what data leaves the page
When the widget isn't showing up, in order of likelihood
Read your feedback and themes, or push events to your stack