Website Agents

The in-browser call reuses the same voice pipeline as phone calls: the browser captures the mic, streams 8 kHz μ-law audio over a WebSocket, and plays the agent's audio back — no phone number required.

Open a Website agent → Widget tab. Choose the mode, customize color/position/greeting, then copy one of three snippets (script tag, iframe, or React component):

<!-- Script tag -->
<script>
  window.CustomwebAgent = { agentId: "YOUR_AGENT_ID", type: "both" };
</script>
<script src="https://agents.customweb.ai/widget/v1.js" async></script>

A few seconds after a visitor lands, the launcher can pop a small bubble with your greeting message to invite a conversation. It shows at most once per browser session, has a close (×) button, and auto-dismisses after 7 seconds so it never lingers over your page's own content.

Toggle it on/off per agent from Widget tab → Customization → Auto-greeting bubble. It's on by default and re-copying any embed snippet after changing it picks up the new setting.

The widget only runs on domains you allow-list (Widget tab → Allowed Domains). Requests from any other origin are rejected. Leave it empty to allow any site (not recommended). Entries match by host, so `https://example.com/path` and `example.com` are equivalent, and subdomains of an allow-listed domain are accepted.

The public website-chat endpoint is rate-limited per agent + visitor IP to keep costs predictable:

Exceeding a limit returns HTTP 429. Voice calls are additionally gated by your token balance.