> 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="https://1583580785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVRUgVLmtuyNEZUgZ8LYH%2Fuploads%2F3d0R5QAMEr4zkzTFbokD%2Favatar_call.png?alt=media&amp;token=6df3327a-91e0-4bfe-ad9c-74353a85b01e" 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="https://1583580785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVRUgVLmtuyNEZUgZ8LYH%2Fuploads%2FGz0xHIptmGRFEjF1C2zV%2Favatar_settings.png?alt=media&amp;token=f2ca5dd0-5a3a-47e4-89c8-6679c035fccb" 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="https://1583580785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVRUgVLmtuyNEZUgZ8LYH%2Fuploads%2FtUeSfqcPboVeH2nDyA01%2Fadd_avatar.png?alt=media&amp;token=ff96d615-3ab1-4fa1-8fe7-43b870bd6945" 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="https://1583580785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVRUgVLmtuyNEZUgZ8LYH%2Fuploads%2FuvGo3WVCTJLtScL3MGyh%2FScreenshot%20From%202025-12-14%2010-24-14.png?alt=media&amp;token=3c45bb2d-5c97-43b9-b436-69fba0800ef9" 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="https://1583580785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVRUgVLmtuyNEZUgZ8LYH%2Fuploads%2FvaNDyTjMZRazYIfG0TCG%2Favatar_widget.png?alt=media&amp;token=6816c792-5859-4e67-bd02-330f6e46e865" 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>