Skip to main content

What are widgets?

Widgets let you embed a Sonara voice agent directly on your website. Visitors can interact with your agent without leaving your site - no phone number required.

Widget types

TypeDescription
Iframe embedA full agent experience embedded in an iframe on your page
Chat widgetA floating button that opens a voice/chat interface
Demo linkA shareable URL that anyone can use to test your agent

Adding a widget to your website

1

Open your agent

Navigate to the agent you want to embed.
2

Click Export / Widget

Open the widget export dialog from your agent’s settings.
3

Choose widget type

Select the type of widget you want (iframe, chat widget, or demo link).
4

Configure options

Customize the widget appearance and behavior:
  • Widget size/variant (tiny, compact, full)
  • Branding and colors
  • Terms and conditions link (optional)
5

Copy the embed code

Copy the generated embed code and paste it into your website’s HTML.

Example embed code

<!-- Sonara Voice Agent Widget -->
<iframe
  src="https://app.heysonara.com/talk-to-agent/YOUR_AGENT_ID"
  width="400"
  height="600"
  frameborder="0"
  allow="microphone"
></iframe>
Make sure to include allow="microphone" in the iframe attributes - the agent needs microphone access for voice conversations.

Widget variants

  • Tiny - Minimal footprint, just a microphone button
  • Compact - Small widget with basic controls
  • Full - Full-featured interface with transcript and controls
Demo links are the fastest way to share your agent. Anyone with the link can start a conversation - no website integration needed. Great for:
  • Sharing with stakeholders for review
  • Quick testing on mobile devices
  • Customer demos and presentations
Widgets and demo links are available on the Basic plan and above.