Stay organized with collections
Save and categorize content based on your preferences.
CCAI Platform mobile and web SDKs allow for an image to be displayed
when interacting with agents using chat or voice calls. The avatar can be set
by an administrator or each user can set their own avatar.
Avatar are images that are uploaded but need to be of a certain specification.
Images must be PNG or JPG, 512px square or larger.
Agent avatar visibility
The visibility of the agent avatar is specific to the SDK being used:
For mobile SDK, avatar are displayed:
During chat sessions.
On call sessions.
Rating screen.
For web SDK, avatar are displayed:
During chat sessions.
Administrator configuration
Administrators can set a default image for all avatars in the environment and
choose if that image is locked and can't be changed.
Adding a default avatar
A default avatar can be configured. To configure a default:
In the CCAI Platform portal, go to Settings > Operation Management.
Navigate to the Default Avatar section.
Click Choose Image.
Select an image file,
Adjust image and click Crop.
If you would like to lock the default avatar and overwrite any
custom images that users have uploaded, click Overwrite all other
uploaded Avatars with default."
Click Save avatar setting to save your changes.
Agent - custom avatar upload
Based on administrator configured settings, the option for a user to upload
their own avatar may or may be available.
From the CCAI Platform portal, click the avatar in the upper-right.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-25 UTC."],[[["\u003cp\u003eCCAI Platform SDKs support image avatars for agents during chat and voice interactions, with mobile SDKs also showing avatars on the rating screen.\u003c/p\u003e\n"],["\u003cp\u003eAvatar images must be in PNG or JPG format and be at least 512px square.\u003c/p\u003e\n"],["\u003cp\u003eAdministrators can set a default avatar for all users and lock it, overwriting any custom user-uploaded images.\u003c/p\u003e\n"],["\u003cp\u003eAdministrators can configure a default avatar by navigating to \u003cstrong\u003eSettings\u003c/strong\u003e > \u003cstrong\u003eOperation Management\u003c/strong\u003e in the CCAI Platform portal, and uploading and cropping the desired image.\u003c/p\u003e\n"],["\u003cp\u003eUsers may have the option to upload their own custom avatar through the "My Profile" section if the administrator allows it.\u003c/p\u003e\n"]]],[],null,["# Custom and default agent avatars\n\nCCAI Platform mobile and web SDKs allow for an image to be displayed\nwhen interacting with agents using chat or voice calls. The avatar can be set\nby an administrator or each user can set their own avatar.\n\nAvatar are images that are uploaded but need to be of a certain specification.\n\n- Images must be PNG or JPG, 512px square or larger.\n\nAgent avatar visibility\n-----------------------\n\nThe visibility of the agent avatar is specific to the SDK being used:\n\n- For mobile SDK, avatar are displayed:\n\n - During chat sessions.\n\n - On call sessions.\n\n - Rating screen.\n\n- For web SDK, avatar are displayed:\n\n - During chat sessions.\n\nAdministrator configuration\n---------------------------\n\nAdministrators can set a default image for all avatars in the environment and\nchoose if that image is locked and can't be changed.\n\n### Adding a default avatar\n\nA default avatar can be configured. To configure a default:\n\n1. In the CCAI Platform portal, go to **Settings** \\\u003e **Operation Management**.\n\n2. Navigate to the Default Avatar section.\n\n3. Click **Choose Image**.\n\n4. Select an image file,\n\n5. Adjust image and click **Crop**.\n\n6. If you would like to lock the default avatar and overwrite any\n custom images that users have uploaded, click **Overwrite all other\n uploaded Avatars with default.**\"\n\n7. Click **Save avatar setting** to save your changes.\n\nAgent - custom avatar upload\n----------------------------\n\nBased on administrator configured settings, the option for a user to upload\ntheir own avatar may or may be available.\n\n1. From the CCAI Platform portal, click the avatar in the upper-right.\n\n2. Click **My Profile**.\n\n3. Click the **Choose file** button.\n\n4. Adjust the image as needed in the edit screen.\n\n5. Click **Crop** to save the image selection.\n\n6. Click Upload Image to save."]]