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, enter their email (confirmed with a one-time code by default), 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 9,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 popup 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.

Email/SMS verification

By default, visitors confirm their email address or phone number with a one-time code before they record, as in the steps above.

On a paid plan you can turn the code off in the Email/SMS Verification section. Set the default for all your widgets on the Widget Defaults tab of Global Configurations. A widget follows that default until you click Customize for This Domain on its page under Dashboard > Widgets > (select your widget) and choose Required or Off. Reset to Global Defaults makes it follow the default again. Free plans always require the code.

With the code off, visitors still enter an email address or phone number, then go straight to recording. What that means for you:

• The contact is not confirmed. It is exactly what the visitor typed, so it may be mistyped or belong to someone else.
• The message is marked "Not verified" in your inbox, in the notification email, and on the playback page. Webhooks and the API carry data.sender.contact_verified: false (see the webhook payload reference).
• The sender gets no delivery confirmation email.
• It counts toward your plan's monthly Voicegrams, exactly like a verified message.
• The code can come back. During unusual volume, visitors are asked for the code for a while, and an email address or phone number used to send many messages within an hour is asked for it too.

Visitors can also enter a phone number instead of an email address, on paid plans. It is on by default. To ask for an email address only, turn off Let visitors use a phone number in the same Email/SMS Verification section: visitors then see only the email field. Like the code, it follows the default on the Widget Defaults tab of Global Configurations until you customize the widget.

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 9,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.