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

# Embed Your Agent

> Add a call or chat button for one published Vida Agent to a website.

Use the Agent embed to let website visitors call or chat with one published Vida Agent. This is
different from embedding the complete authenticated Vida application.

## Add the embed

```html theme={null}
<button class="vida-button" data-vida-button data-target="AGENT_USERNAME" data-type="call">
  Call
</button>

<button class="vida-button" data-vida-button data-target="AGENT_USERNAME" data-type="chat">
  Chat
</button>

<script src="https://vida.io/embed/button/v1/script.js" defer></script>
```

Replace `AGENT_USERNAME` with the selected Agent's published username.

## Configure the button

* `data-target` is required and identifies the published Agent username.
* `data-type` is required and must be `call` or `chat`.
* `data-number` is optional. On supported mobile devices, it can send a call through the phone
  dialer instead of browser voice.

Style the button with your own CSS. Keep the `data-vida-button` attribute so the embed script can
attach the intended behavior.

## Test before launch

* Confirm the Agent username and live configuration.
* Test call and chat separately when you expose both.
* Verify microphone permission and browser behavior.
* Test desktop and mobile layouts.
* Inspect the resulting conversation and reporting values.
* Confirm escalation, transfer, and external actions.

If you need authenticated customers to manage Agents and settings inside your product, use
[Embed the Vida app](/docs/enablement/embed_app) instead.