Widget overview

The Voicegram widget is a single embeddable script that drops a floating microphone bubble into the bottom-right corner of any web page. Visitors click it, verify their email, and leave you a voice message right from your site. You receive the recording as an email notification, a signed webhook to your own server, or a Zap into 7,000+ apps. No phone numbers, no app installs, no third-party call-handling service.

The widget is a one-line install: a single <script> tag. Everything else (theme colors, button position, welcome and success copy, branding) is configured in the Voicegram dashboard and pulled by the widget at load time, so you can rebrand the experience without redeploying your site.

What you get out of the box

With just the script tag and no other code:

• A floating bubble button (FAB) in the bottom-right corner of every page where the script loads.
• Click the bubble. A modal opens with an email field.
• Visitor submits an email. A 6-digit verification code is emailed to them.
• Visitor enters the code. The browser prompts for microphone permission, then the recording UI appears.
• Visitor records (up to 3 minutes by default), reviews their take, and submits.
• The voicegram is transcribed and summarized with AI.
• You receive an email notification with the audio, the transcript, and the summary.

All theming (colors, position, gradient, shadow, custom welcome and success messages, branding) is configured in the Voicegram dashboard and pulled by the widget at load time. No JavaScript configuration needed.

The widget validates the public key plus page domain against the customer's registered domain allowlist before allowing recording. A mismatched domain hides the widget on that page automatically.

How it fits with the rest of Voicegram

The widget is one of three ways to collect voicegrams:

• Widget (this section). Embed on your existing site.
• Campaigns. Hosted landing pages on your own subdomain, no embedding required.
• Custom REST API. Build your own recorder against the public API.

Voicegrams arrive in your dashboard regardless of which source they came from, and any delivery integration works for any source:

• Email notifications. On by default. Configure recipients per widget under Dashboard > Widgets > (select your widget).
• Custom webhooks. Signed HTTP POST to your own server every time a voicegram completes.
• Zapier. Push voicegrams into Slack, HubSpot, Salesforce, Notion, or 7,000+ other apps.

Next steps

• Quickstart. The one-line install plus a four-step smoke test.
• Customization. Wire the recorder to your own button, suppress the bubble on specific pages.
• Programmatic API. Open, close, and toggle the widget from JavaScript.
• Framework recipes. Drop-in snippets for React, Next.js, WordPress, Webflow, Squarespace, Wix, and Shopify.
• Mobile and native apps. WebView support, hybrid app caveats, native-app gaps.
• Troubleshooting. Common issues and their fixes.