Skip to main content
A Floating orb lets a website visitor start a voice conversation with an assistant in the browser.

​
Before you begin

Have an assistant with a published voice agent and access to edit the website’s HTML or custom-code section. Publish the page over HTTPS and allow microphone permission; browser microphone access requires a secure context. A phone number is not required solely to start this browser conversation; phone calling and transfer tasks can have their own requirements.

​
Create and install the orb

  1. Open Widgets in the assistant’s account.
  2. Select Create widget.
  3. Choose Floating orb.
  4. Enter a name for the widget.
  5. Select Create widget.
  6. Select the assistant that should answer.
  7. Set the orb’s appearance, including its color and icon.
  8. Select Save changes.
  9. Select Get Code.
  10. Copy the generated script into the website’s custom-code or HTML area.
  11. Publish the website.
Keep the generated script URL, assistant ID, and account ID together. If you change the assistant or settings included in the script, copy the updated code into the website.

​
Orb settings

The orb editor offers AI Model (the assistant selector), Icon, and Color. Choose an assistant from the current account, an icon from the icon picker, and a color. The generated snippet includes the assistant and account IDs plus the icon, color, theme, and orb size. Copy fresh code after changing settings; the snippet carries those values to your website. The default generated orb is 90 pixels across. Placement inside a page section uses the optional data-container attribute described below; it does not change the assistant assignment.

​
Test on the published website

  1. Open the published page in a browser.
  2. Select the orb.
  3. Allow microphone access when prompted.
  4. Speak a short request.
  5. Confirm the expected assistant responds with audible speech.
  6. End the conversation.
Repeat on the device types your visitors use. A visible orb confirms the embed loaded; hearing and completing a conversation confirms the voice path works.

​
Optional: place the orb inside a section

The orb floats over the page by default. To place it inside a section, add this container before your generated script:
Add data-container="voice-orb-slot" to the opening script tag in your generated code. Keep its existing URL and account/assistant attributes. The container ID and data-container value must match, and the container must exist before the script runs. Publish the page and confirm the orb stays within that section at both desktop and mobile widths.

​
Troubleshooting

For a widget that combines text and voice, see Voice-enabled chat widget.