Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.eolasflow.ai/llms.txt

Use this file to discover all available pages before exploring further.

Add an AI voice assistant to any website. Visitors click a floating widget to start a voice conversation directly in their browser — no phone number needed, no app to install. The widget is powered by the same real-time AI engine as your VoiceFlows.

​
How It Works

When a visitor clicks the widget button, their browser connects directly to the AI assistant you configured in your VoiceFlow. The full flow:
  1. You create an inbound VoiceFlow — defines the assistant, system prompt, tools, and behavior
  2. Generate a widget key — ties the embed code to that specific VoiceFlow
  3. Add the embed snippet to your website HTML
  4. Visitor clicks the widget — a floating button appears on your page
  5. Browser captures audio via WebRTC — no plugin or download required
  6. AI handles the conversation in real-time, just like a phone call

​
Setting Up the Widget

1

Create or open a VoiceFlow

Go to VoiceFlows in the dashboard. Create a new inbound VoiceFlow or open an existing one. The widget will use this VoiceFlow’s assistant, system prompt, and tools.
2

Open the Widget section

Inside the VoiceFlow settings, find the Widget section in the sidebar or settings panel.
3

Generate a Widget Key

Click Generate Widget Key. A unique key is created and bound to this VoiceFlow. The widget key controls which assistant answers, what it knows, and what tools it can use.
4

Copy the embed code

Click Copy Embed Code to copy the script snippet to your clipboard. You will paste this into your website in the next step.
Each VoiceFlow has its own widget key. If you want different assistants on different pages, generate a separate key for each VoiceFlow.

​
Embedding on Your Website

1

Open your website's HTML

Open the HTML file or template for the page where you want the widget to appear.
2

Paste the script tag

Paste the copied embed code just before the closing </body> tag. It looks similar to this:
<!-- EolasFlow Voice Widget -->
<script
  src="https://widget.eolasflow.ai/widget.js"
  data-widget-key="YOUR_WIDGET_KEY"
  async
></script>
3

Save and publish

Save the file and deploy your website. The widget appears as a floating button in the bottom-right corner of the page by default.
4

Verify

Open the page in your browser and confirm the widget button is visible. Click it to start a test conversation.
Add the widget to specific, high-intent pages — product pages, pricing pages, the contact page — rather than every page on your site. This focuses conversations where they matter most.

​
Widget Configuration

You can customize the widget’s appearance and behavior from the Widget section of your VoiceFlow settings:
SettingDescription
PositionWhere the button appears on the page (bottom-right, bottom-left)
ColorsButton and accent colors — defaults to your VoiceFlow brand settings
Greeting messageWhat the AI says as soon as the visitor connects
Button labelOptional text shown next to the widget button
The AI assistant, system prompt, knowledge base, and tools all come from the linked VoiceFlow. To change how the AI behaves, update the VoiceFlow configuration — the widget reflects those changes automatically.

​
Testing the Widget

Use the Widget Preview page in the dashboard to test before deploying to your live site. The preview simulates the exact experience visitors will have, including audio, latency, and the greeting message. Test the full conversation flow — not just the opening — before going live.

​
Browser Requirements

BrowserSupport
ChromeRecommended
FirefoxSupported
SafariSupported
EdgeSupported
When a visitor clicks the widget, their browser asks for microphone permission. Visitors must grant access for the conversation to work. Most modern browsers handle this automatically with a small permission prompt.

​
Use Cases

Customer Support

Place the widget on product pages or an FAQ page. The AI answers common questions instantly, without a support agent needing to be available.

Lead Qualification

Add the widget to landing pages. The AI qualifies visitors by asking about their needs, budget, and timeline — and hands off warm leads to your team.

Appointment Booking

On service pages, the AI can book appointments directly when the Planner integration is connected to your VoiceFlow.

​
Best Practices

Test the widget end-to-end before deploying. Run through the full conversation yourself — including edge cases — so you know how the AI responds to common visitor questions.
Write a clear, friendly greeting so visitors know they are speaking with an AI assistant. Transparency builds trust and sets the right expectations for the conversation.
Enable Knowledge Retrieval in your VoiceFlow so the AI can answer product-specific questions accurately. Without it, the AI relies only on its system prompt.
Your website must use HTTPS for the widget to function. Browsers only allow microphone access on secure connections. HTTP pages will not be able to capture audio.

​
Next Steps

VoiceFlows

Create and configure the VoiceFlow that powers your widget

Assistants

Customize the AI assistant’s personality and instructions

Softphone

Test your AI assistant directly from the browser before deploying