import { CodeBlock } from '../views/docs/CodeBlock';
import { CodeTabs } from '../views/docs/CodeTabs';
import { Callout, Prose, PropTable, GetStartedCTA } from '../views/docs/prose';
## WebRTC Widget
Embed a Guava voice agent on your website so visitors can start a voice conversation directly from the browser. The WebRTC audio widget is a drop-in ``}
/>
### Complete standalone page
If you don't have a page yet, here's a full HTML file you can use as a starting point:
My Voice Agent
`}
/>
### Script tag attributes
### Widget states
State
Behavior
User action
idle
Ready to call — green indicator
Click to call
connecting
Pulsing animation, clicks disabled
Wait
active
Call in progress — audio-reactive visuals
Click to hang up
error
Red indicator — connection failed
Click to retry
No configuration needed. The widget is entirely self-contained — it injects its own HTML and CSS (scoped under `[data-guava-widget]` so it won't conflict with your page styles), wrapped in an IIFE with no global variables. Works on any page with a modern browser.
### Generating a WebRTC code via SDK
Instead of obtaining a WebRTC code from the Guava dashboard, you can generate one programmatically with `client.create_webrtc_agent()`. This is useful when you need to create codes on-the-fly or control their TTL.
new MyCallController(logger),\n);`, filename: "generate_code.ts" }}
/>
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ttl` | `datetime.timedelta \| None` | No | How long the WebRTC code should remain valid. If omitted, the server default TTL applies. |
**Returns:** `str` — a WebRTC code (e.g. `grtc-...`) that can be passed to `listen_inbound(webrtc_code=...)` or used as a `?webrtc_code=` query parameter in the browser widget.
Raises an HTTP error (via `check_response`) if the API request fails.