Website widget

The Foan widget puts a "Talk to us now" button on your website. A visitor clicks it, gives microphone permission, and is talking to your agent in seconds — no phone number required, no app install.

Where to find it

Each agent has a Widget tab in agent settings. The Widget tab shows you a snippet to copy. Two flavours:

  • Floating button — drops a corner button on every page.
  • Inline embed — renders inside any container you put the snippet in.

The snippet

<script src="https://foan.me/widget.js"
        data-agent-id="YOUR_AGENT_ID"
        data-mode="floating"
        async></script>

That's it. No build step, no React peer dep, no auth.

Customising it

Three things you can tweak from the Widget tab:

  • Button label — defaults to "Talk to us". Change to "Book a survey", "Speak to support", whatever.
  • Position — bottom-right (default), bottom-left, or inline.
  • Theme — light, dark, or auto.

What happens on a click

The widget opens a small panel, requests microphone permission, and connects directly to the same Foan agent that handles your phone calls. The conversation is logged into Call history the same way a phone call is, with one difference — the source is recorded as widget instead of phone.

Same agent. Same voice. Same knowledge base. Same integrations.

Pricing

Widget calls are billed at the same per-minute rate as phone calls. There's no separate widget plan or per-domain limit.

Common questions

Does it work on mobile browsers? Yes — Safari iOS and Chrome Android both support WebRTC microphone access. The widget falls back gracefully on browsers that don't.

What about visitors who don't want to talk? The panel includes a "leave a message" option that captures a written enquiry instead.

Can I disable it on certain pages? Yes — add data-disable-on="/legal,/privacy" to the script tag.

Embedding in an iframe? Works, but the parent page needs allow="microphone" on the iframe element.

Last updated 7 May 2026