> ## Documentation Index
> Fetch the complete documentation index at: https://docs.talking-avatar.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Share and embed

> Let people call your agent from a link, a website widget or an iframe.

Open the agent's **Share & embed** tab.

## Access

* **Taking calls:** switch it off to stop every call: its share link, embeds and private links. Switch it on again at any time.
* **Who can call:**
  * **Public:** anyone with its link, or on a site with your embed.
  * **Private:** only people you give a link to. Links expire, and you make them in the dashboard or from your server. See [Private agents](https://docs.talking-avatar.dev/voice-agents/private-agents.md).

Click **Save changes** after changing access.

## Share link

A public agent has a page where anyone can talk to it, with no sign-in:

```text theme={null}
https://app.talking-avatar.dev/agent/AGENT_ID
```

Click **Copy link** to copy it, or **Open** to try it. Send it by email or chat, or link to it from your site.

## Embed on your website

Choose **Widget** or **Iframe**, then click **Copy code**.

**Widget**

A button in the corner of every page. The call opens in a panel above it. Paste it before `</body>`:

```html theme={null}
<script src="https://app.talking-avatar.dev/embed.js" data-agent="AGENT_ID" async></script>
```

Optional attributes:

| Attribute | Default | Description |
| - | - | - |
| `data-agent` | required | The agent's ID |
| `data-label` | `Talk to us` | The button's text |
| `data-position` | right | `left` puts the button at the bottom left |
| `data-token` | | A private agent's link token. See [Private agents](https://docs.talking-avatar.dev/voice-agents/private-agents.md#embed-a-private-agent). |

The panel is up to 400 × 640 pixels and fits smaller screens. Clicking the button again (**Close**) closes the panel and ends the call.

**Iframe**

The agent inside your page, wherever you put it:

```html theme={null}
<iframe
  src="https://app.talking-avatar.dev/agent/AGENT_ID?embed=1"
  allow="microphone; autoplay"
  style="width:100%;height:640px;border:0;border-radius:16px"
></iframe>
```

`?embed=1` makes the page fill the iframe. Keep `allow="microphone; autoplay"`: without it, the browser blocks the microphone and the agent's voice.

> [!NOTE]
>
> Calls always run on the agent's own call page: the share link, or that page inside the widget or iframe. You can size and place it, but there's no API to start a call from your own interface.

## Branding

Without the [Remove watermark](https://docs.talking-avatar.dev/dashboard/billing.md#remove-watermark) plan, the call page shows a *Powered by Talking Avatar* link and the avatar's video shows a small watermark. With it, both are gone.

## Protect your balance

Every call is billed to your account, whoever makes it. To keep costs in check:

* Set a [monthly spending limit](https://docs.talking-avatar.dev/dashboard/billing.md#monthly-spending-limit).
* Keep the [maximum call length](https://docs.talking-avatar.dev/voice-agents/conversation-settings.md#maximum-call-length) as short as the conversation needs.
* Make the agent [private](https://docs.talking-avatar.dev/voice-agents/private-agents.md) if only specific people should call it.

Each caller can also only start a limited number of calls to the same agent in an hour and in a day. Past that, they see *Call limit reached* and can try again later.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.