How to set up and use the Voice AI Chat Widget

Modified on: Mon, 13 Oct, 2025 at 6:43 PM

This guide explains what the Voice AI Chat Widget does, how to set it up, and how to use it effectively for both new and existing accounts.


TABLE OF CONTENTS




Overview


  • The Voice AI Chat Widget allows visitors to communicate with your AI agent using real-time voice conversations directly inside the chat widget.
  • This feature enables users to talk through their browser’s microphone and speakers without requiring a phone number, download or call setup.
  • It is currently available under Labs, allowing you to enable and test the feature before it becomes generally available.

What the Voice AI Chat Widget does


The Voice AI Chat Widget works as a voice-only interaction mode within the existing chat widget framework.
Visitors can initiate a live voice session by clicking a microphone icon, and the AI agent responds conversationally in real time.

During the session, visitors can:

  • Start or end a voice conversation.

  • Mute or unmute the session as needed.

  • Provide contact information and details verbally.

  • Restart a conversation at any time by disconnecting and calling again.

The AI agent uses your configured Voice AI automations to handle interactions.
All existing Voice AI actions are supported, except Call Transfer, which is currently unavailable.


Key Capabilities

  • Browser-based voice calling directly from the chat widget.

  • No outbound call or phone number required.

  • Configurable AI Agent Name to match your brand or business.

  • Automatic call recording notice displayed for transparency.

  • Built-in reCAPTCHA protection to prevent automated or repeated misuse.

  • Full compatibility with existing Voice AI actions and workflows.


Enabling the Voice AI Chat Widget

Step 1: Enable from Labs

  1. Navigate to Settings > Labs > sub-account tab.

  2. Find the Voice AI Chat Widget option.

  3. Toggle the feature ON to enable it.

Once enabled, the Voice AI chat type becomes available in the Chat Widget builder.
If you manage multiple accounts, you can choose to enable or disable it for specific sub-accounts.


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, select Voice AI Agent.


  4. In the Voice AI Agent Name field, enter the name that will be displayed to visitors (for example: “Sales Assistant” or “SupportBot”).


  5. Click Save to apply your settings.


Note: You will not be allowed to create a voice AI chat widget unless your Voice AI setup along with agent creation is completed.

Learn how to create a voice AI agent by referring this help article.





Step 3: Add the widget to a website or funnel

  1. In the Chat Widget builder, click Get Code.


  2. Copy the generated <script> tag.

  3. Paste this code into the body or footer section of your website or funnel where you want the widget to appear.

  4. Publish or update the page.

Once published, the Voice AI Chat Widget will appear on your site.


Step 4: How visitors interact

When a visitor opens the chat widget:

  1. They’ll see a microphone icon indicating voice chat capability.

  2. Clicking the icon starts the live voice session.

  3. The browser requests microphone access (visitors must grant permission).

  4. The AI agent responds conversationally in real time.

  5. Visitors can start, mute or end calls as they prefer.


  6. If the same user rapidly connects and disconnects multiple times (10 times within 60 seconds), the system triggers a reCAPTCHA challenge to ensure legitimate use.


Best Practices

  • Choose a clear, friendly agent name that fits your brand tone.

  • Add the Voice AI widget to high-intent pages, such as “Contact”, “Pricing” or “Demo Request”.

  • Test microphone permissions in different browsers to ensure smooth functionality.

  • Keep background noise minimal when training or testing your agent.

  • Remind users that calls are not recorded to maintain transparency.

  • Monitor early usage during the Labs phase to understand user behavior and make configuration adjustments as needed to your agent and widget.


Security and Compliance

The Voice AI Chat Widget includes built-in security and compliance mechanisms:

  • reCAPTCHA protection prevents misuse through repeated connect/disconnect activity.

  • A non-recording notice is displayed automatically to ensure transparency.

  • All conversations are handled within the browser, ensuring user privacy.

  • The feature follows standard browser permission protocols for microphone and speaker access.


Troubleshooting


IssuePossible CauseResolution
Voice session not startingMicrophone permission not grantedAsk the user to allow microphone access when prompted.
No audio outputSpeakers muted or disconnectedCheck audio settings and ensure device output is active.
Widget not appearingScript not installed correctlyRe-copy and reinsert the <script> tag from the builder.
Frequent reCAPTCHA promptsRapid connection attempts detectedSlow down reconnection frequency to avoid triggering the system.
Unable to record sessionsFeature not supportedInform users that call recording is currently unavailable.

Example: Setting up for lead capture


This example explains how to use the Voice AI Chat Widget to capture leads through voice.

Objective:
Convert website visitors into qualified leads using voice interaction.

Setup Steps:

  1. Enable Voice AI Chat Widget in Labs.

  2. Create or open a Chat Widget and select Voice AI Agent Type.

  3. Name the agent “Sales Assistant.”

  4. Configure your Voice AI flow to:

    • Greet the visitor.

    • Collect name and business details.

    • Confirm interest type (e.g., service inquiry, demo request).

    • Save the lead in your CRM.

    • End the session politely.

  5. Embed the widget on your Contact Us or Pricing page.

Expected Experience:

  • A visitor clicks the microphone icon.

  • The AI agent greets them and begins asking questions.

  • The visitor provides answers verbally.

  • The system captures and stores their details automatically.

Result:
The lead information is collected without requiring form submissions or manual input.


Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article