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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://dataqueue.gitbook.io/voicehub-docs/agent-design-and-usage/avatar-calls.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.