> For the complete documentation index, see [llms.txt](https://dataqueue.gitbook.io/voicehub-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dataqueue.gitbook.io/voicehub-docs/agent-design-and-usage/avatar-calls.md).

# Avatar Calls

We’ve introduced **Avatar Calls**, a new conversation mode in addition to **Text**, **Voice**, and **Text‑Voice** calls.

Avatar Calls allow you to represent your agent with a visual avatar during conversations, creating a more engaging and human‑like experience for end users.

### What Is an Avatar Call?

An **Avatar Call** is a conversation mode where the agent is represented by a visual avatar that speaks and interacts with users, instead of using voice-only or text-only interactions.

You can:

* Choose from built‑in default avatars
* Upload and manage your own custom avatars
* Test avatar calls directly inside your workspace
* Configure widgets to use avatar calls
* Customize the avatar theme used by the widget

<figure><img src="/files/CPv7pSo3Mlz8Hi68ZVpY" alt=""><figcaption></figcaption></figure>

### Managing Avatars

#### Accessing Avatar Settings

To manage avatars for an agent:

* Go to **Agents**
* Select your agent
* Navigate to **Build → Avatar Settings**<br>

Here you’ll find:

* A list of **default avatars**
* Your **custom avatars**
* The option to add new avatars

<figure><img src="/files/xgCoRcpbIJ8MLCmXEPEu" alt=""><figcaption></figcaption></figure>

#### Adding a New Avatar

To add a custom avatar:

1. Click **Add Avatar**
2. Fill in the following fields:
   * **Name** – A friendly name for the avatar
   * **Identity** – The avatar identity used by the agent
   * **Avatar Image** – Upload an image for the avatar<br>

**Avatar Image Requirements**

For best results, the uploaded image should meet the following criteria:

* Clear, good‑quality photo of a **real person**
* Face must be **fully visible and unobstructed**
* Minimum resolution: **128 × 128 pixels**
* Avoid images that are:
  * Too close or overly zoomed
  * Too distant
  * Partially hidden or cropped

Once saved, the avatar will be available for use by the agent.

<figure><img src="/files/4aZ1e4kXqsswsZytkaDL" alt=""><figcaption></figcaption></figure>

### Testing an Avatar Call

You can test avatars directly inside your workspace:

1. Go to your **Agent**
2. Click **Start Call**
3. Select **Start Avatar Call**

This allows you to verify:

* Avatar appearance
* Audio quality
* Overall user experience before publishing

<figure><img src="/files/eGgaHm3qzgIWy49YZwtx" alt=""><figcaption></figcaption></figure>

### Using Avatars in the Widget

#### Enabling Avatar Calls in the Widget

To configure your widget to use avatar calls:

1. Go to **Widget Settings**
2. Open **Conversation Mode**
3. Select **Avatar Call**

Once enabled, the widget will use avatar calls instead of voice or text modes.

<figure><img src="/files/UGEyg3bmQogvPZWVDKL3" alt=""><figcaption></figcaption></figure>

#### Changing the Avatar Theme

You can also customize the avatar’s visual style:

1. Go to **Widget Settings**
2. Navigate to **Avatar Theme**
3. Choose your preferred customization

Theme changes are applied immediately and affect how the avatar appears to end users.

### Summary

With Avatar Calls, you can:

* Add a visual identity to your agents
* Upload and manage custom avatars
* Test avatar interactions inside your workspace
* Enable avatar calls in widgets
* Customize the avatar theme

This feature helps create more engaging and interactive conversations for your users.

<br>