> ## 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.

# Choose How to Embed Vida

> Embed one Agent interaction on a website or place the complete Vida customer application inside your product.

Vida supports two different embed experiences. Choose based on what the person should be able to do.

| Experience         | Use it for                                                                                           |
| ------------------ | ---------------------------------------------------------------------------------------------------- |
| **Agent embed**    | Let a website visitor call or chat with one published Agent.                                         |
| **Vida app embed** | Give an authenticated reseller customer access to the complete Vida application inside your product. |

## Embed one Agent

Use the Agent embed when a public website needs a call or chat button.

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

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

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

* `data-target` is the published Agent username.
* `data-type` is `call` or `chat`.
* `data-number` can optionally direct a mobile call through the phone dialer.

Test microphone permission, browser compatibility, mobile behavior, and the Agent's live
configuration before adding the embed to production traffic. See [Embed your Agent](/docs/sharing/embed)
for the full implementation.

## Embed the complete Vida application

Eligible resellers can place the Vida application inside their product. Your trusted backend maps
the signed-in user to the correct Vida customer organization, creates a one-time authentication
token, and returns the short-lived token to the frontend. The frontend loads `/app/embed` on the
reseller's Vida domain.

Never place a long-lived Vida API token in browser code, storage, or an iframe URL. See
[Embed the Vida app](/docs/enablement/embed_app) for the authentication and onboarding flow.

## Brand and verify the experience

Use the intended white-label domain and review:

* logo, color, labels, links, and support destinations
* login, logout, and account switching
* microphone and camera permissions where used
* mobile and desktop layout
* customer access boundaries
* billing, onboarding, and deep links

The Agent embed and full application embed solve different problems. Do not give an unauthenticated
website visitor a customer application session when one public Agent interaction is sufficient.