Set Up the Voice AI Chat Widget in Sparkforge

By Sparkforge Support Team ·Last reviewed May 3, 2026

The Voice AI Chat Widget lets website visitors talk to your Sparkforge AI agent directly in the browser — no phone call, no app. Enable it in Labs, configure an agent, and embed the widget script.

The Voice AI Chat Widget adds a browser-based voice channel to your existing chat widget. Visitors click a microphone icon, grant permission, and talk to your AI agent in real time. No outbound calls, no phone numbers, no downloads. The feature is currently in Labs while it stabilizes for general availability.

What it does

Voice AI is a voice-only mode that runs inside the existing chat widget. Visitors can:

  • Start or end a voice conversation.
  • Mute and unmute the session.
  • Provide contact info verbally.
  • Restart by disconnecting and reconnecting.

The agent uses your configured Voice AI automations. Every Voice AI action is supported except Call Transfer, which is currently unavailable.

Capabilities

  • Browser-based voice calling from the chat widget.
  • No outbound call or phone number required.
  • Configurable AI agent name to match your brand.
  • Automatic non-recording notice for transparency.
  • Built-in reCAPTCHA to prevent rapid connect/disconnect abuse.
  • Compatible with existing Voice AI actions and workflows.
  • Up to 100 Voice AI agents per account.

Enable the widget

Step 1: Turn it on in Labs

  1. Go to Settings → Labs → Sub-Account tab.
  2. Find Voice AI Chat Widget.
  3. Toggle it on.

Once enabled, the Voice AI chat type appears in the Chat Widget builder. With multiple sub-accounts, enable it per location as needed.

Step 2: Configure the widget

  1. Go to Sites → Chat Widgets.
  2. Open an existing widget or create a new one.
  3. Under the Agent tab, pick Voice AI Agent.
  4. Enter the agent name visitors will see (e.g., Sales Assistant, SupportBot).
  5. Click Save.

You cannot create a Voice AI chat widget unless your Voice AI agent already exists.

Step 3: Embed on your site

  1. In the Chat Widget builder, click Get Code.
  2. Copy the generated <script> tag.
  3. Paste it into the Tracking Code section of your site or funnel header or footer.
  4. Publish the page.

Step 4: How visitors interact

  • The widget shows a microphone icon when voice is enabled.
  • Clicking it requests browser microphone access.
  • The AI agent responds conversationally in real time.
  • Visitors can start, mute, or end calls freely.
  • If a visitor connects and disconnects 10+ times in 60 seconds, reCAPTCHA triggers.

Best practices

  • Pick a clear, friendly agent name that fits your brand.
  • Add the widget to high-intent pages: Contact, Pricing, Demo Request.
  • Test microphone permissions across browsers.
  • Keep background noise minimal during agent training.
  • Tell users calls are not recorded for transparency.
  • Monitor early Labs usage and tune the agent based on real interactions.

Security and compliance

  • reCAPTCHA blocks rapid connect/disconnect abuse.
  • A non-recording notice displays automatically.
  • Conversations stay in the browser for privacy.
  • Microphone access follows standard browser permission prompts.

Troubleshooting

IssueCauseFix
Voice session won't startMic permission deniedAsk the visitor to allow microphone access.
No audio outputSpeakers muted or disconnectedCheck device output and browser audio settings.
Widget not showingScript not installed correctlyRe-copy the script tag from the builder and paste again.
Frequent reCAPTCHA promptsRapid reconnectsSlow reconnection frequency.
Can't record sessionsNot supportedRecording isn't available for this feature.

Example: Voice lead capture

Convert visitors into qualified leads through voice.

  1. Enable the Voice AI Chat Widget in Labs.
  2. Create or open a Chat Widget and pick Voice AI Agent.
  3. Name the agent Sales Assistant.
  4. Configure the Voice AI flow to greet, collect name and business details, confirm interest type, save the lead in CRM, and end politely.
  5. Embed the widget on Contact Us or Pricing.

The visitor clicks the mic, the agent asks questions, answers are captured automatically, and the lead lands in your CRM without a form submission.

Frequently Asked Questions

Do visitors need a phone number or app?
No. Voice conversations happen entirely in the browser using the visitor's microphone and speakers.
Can I create a Voice AI chat widget without a Voice AI agent?
No. The Voice AI agent must exist first. The widget refuses to save without one configured in AI Agents → Voice AI.
Are calls recorded?
No. The widget shows a non-recording notice, and call recording isn't supported for this feature.
How do I configure the bot's responses?
Open AI Agents → Voice AI in your sub-account and edit the agent settings — greeting, prompts, behavior, and any actions or workflows you've defined.
What happens if visitors abuse the widget?
If the same user connects and disconnects 10+ times in 60 seconds, reCAPTCHA triggers to verify legitimate use.

Was this article helpful?