VoIP Widget
Let customers speak to your AI agent directly from your website — no phone number needed.
What is the VoIP Widget?
The VoIP Widget is a small embeddable call button you add to your website with a single line of code. When a visitor clicks it, a floating call panel appears. They click "Call Now," allow microphone access, and are instantly connected to your BLEUM AI agent through their browser — no phone call, no app download.
After the call ends, the panel shows a post-call summary including the call duration, number of turns, sentiment trajectory, average response time, and an AI-generated summary of what was discussed. It's a complete support experience without the customer ever leaving your page.
What the Widget Includes
One-Click Calling
Visitors click "Call Now" and connect instantly. No phone number, no hold music, no queue.
Live Transcript
Caller and agent speech appears in real time as conversation bubbles during the call.
Mute Button
Callers can mute and unmute their microphone mid-call without ending the conversation.
Post-Call Summary
After every call, the panel shows duration, turns, sentiment, avg response time, and an AI summary.
Setting Up the Widget
Step 1 — Create a widget in your admin
Navigate to Phone Numbers → VoIP Widgets in your admin. Click New Widget and configure:
- Name — What the widget header shows to visitors (e.g. "BLEUM Support").
- VoIP Endpoint — Which of your VoIP lines the widget calls. This determines which Welcome flow and procedures handle the call.
- Allowed Domains — The website domains where this widget is permitted to load. Requests from unlisted domains are blocked for security.
Step 2 — Copy the embed code
After saving, copy the embed snippet from the widget's detail page. It looks like this:
<script src="https://api.bleum.ai/public/widget/bleum-widget.js" data-publishable-key="bleum_pk_YOUR_KEY_HERE" defer></script>
Step 3 — Add it to your website
Paste the snippet before the closing </body> tag on any page where you want the widget to appear. No other configuration is needed — the widget loads automatically and floats in the bottom-right corner.
How It Works for Visitors
A floating "Call us now" button appears in the corner of your page. Clicking it opens the call panel.
Their browser requests microphone permission. Once granted, the call connects to your AI agent within seconds.
The AI greets the caller and handles the conversation. The visitor sees a live transcript of both sides of the call. They can mute themselves or end the call at any time.
When the call ends, the panel transitions to a call summary showing duration, turns, sentiment, avg response time, and an AI-generated summary of what was discussed from the caller's perspective.
Post-Call Summary Details
After every widget call, visitors see a summary panel with four metrics and an AI-written summary:
| Metric | What It Shows |
|---|---|
| Duration | Total call length from connect to disconnect. |
| Turns | How many times the caller spoke during the call. |
| Sentiment | Whether the caller's mood improved, declined, or stayed stable over the call. |
| Avg Response | Average time from the end of the caller's turn to the end of the AI's reply. |
The AI summary is written from the caller's perspective — it describes what was asked and what was resolved in plain, friendly language. Hover over any metric label to see a tooltip explaining what it measures.
Domain Security
Each widget has an Allowed Domains list. The widget will only load and make calls when embedded on a domain in that list. This prevents your widget from being used on unauthorized sites. Always add the exact domains where you plan to embed the widget — including subdomains if needed (e.g. both yoursite.com and www.yoursite.com).
Browser Requirements
The widget uses WebRTC for the call connection and the browser's microphone API. It works best on:
- Chrome (recommended)
- Edge
- Firefox
Safari has partial support but may have microphone permission issues on some versions. The widget will not work on browsers that block WebRTC or on managed corporate devices with restrictive network policies.
Common Questions
Yes. You can create multiple widgets, each with a different name, VoIP endpoint, and allowed domain list. For example, you could have one widget for your main support site and another for a specific product's help pages, each routing to a different set of procedures.
Yes. Every widget call is logged in Reporting with a full transcript, duration, and sentiment data. The caller identifier shows as a widget session ID rather than a phone number.
Yes. Widget calls go through the same AI pipeline as phone calls and are billed the same way.
Yes. If your procedures include an escalation action and a phone number is configured in your Escalation Flow, the AI can transfer the caller to a human agent. The widget caller will be connected to the configured phone number via a standard outbound call.
The widget uses your brand color (configured in your BLEUM settings) for the header and buttons. The name displayed in the panel header comes from the widget's Name field. Further visual customization is available on higher-tier plans.