Troubleshooting

Find the failing step first: loading the character, sending a message, hearing a reply or publishing a change.

Start with these checks

  1. Open the character and select Test conversation in the right dock (or Test conversation on Characters), then send a typed question.
  2. If text works, select Preview selected voice and settings on Language & voice, then test the microphone separately.
  3. If the test works but your website does not, check the character’s visibility, the published scene and the website code on Channels › Publish.
  4. Read the exact error before changing providers. Check your quota in the plan menu of the top bar and the balance of any provider account you connected.

The background or camera is different

Scene edits are saved to a draft automatically, but visitors only see them after you publish. If the toolbar says Saved · Scene not published, select Publish, then reopen the visitor page. To check the draft first, open Channels › Publish preview and use Preview unsaved scene. The Floating Companion website template shows the character without its scene, so your website stays visible behind it; compare with Scene Window, which shows the character with its saved environment.

Look and scene guide · Publish and embed

The avatar does not load or animate correctly

For a Character Studio character, wait until Opening Character Studio… finishes, then close the tool you edited so the look is saved (Saving the look…); the stage reloads afterwards. If Characters still shows an old picture, select Refresh gallery image in the editor toolbar. For an uploaded model, check Identity & model › Model settings: the model file must be reachable, uploads are limited to 100 MB, and a GLB needs a compatible skeleton for body animation and facial morph targets for facial animation. If hands intersect the body, try another motion in Scene & motion › Idle, talk & listen; clothes and body proportions affect how a motion fits.

A message gets no reply

Check the visible connection status and error. On Mind & knowledge › Core AI, verify the LLM Provider and Model. Open the plan menu in the top bar: when Quota units this month is used up, new replies are refused with a quota error until the quota resets or you change plans. Try a short typed message with a known working character to isolate the problem. A scene loading successfully does not prove that the conversation service is available.

Audio or microphone fails

Use HTTPS, allow the microphone and interact with the page once to unlock audio. Check the mute button, device audio output and browser permissions. If replies arrive as text but stay silent, play Preview selected voice and settings on Language & voice and check the voice provider and its key. Follow voice and microphone troubleshooting.

The site guide does not speak or recognise a page

Open the character, then Scene & motion › Experience and its Site guide section. Check the website address, current-page awareness, spoken help and indexed pages. Select Save experience, then Publish experience; publishing the character does not publish the Experience. A browser can require a visitor tap before spoken help plays. Spoken help for a page is remembered for the visitor’s browser-tab session, so it does not repeat on every return; test in a new browser tab on the connected website. See the complete setup.

A tab is locked or a character cannot be created

A padlock on an editor tab (LiveFace 2D, Mindview, Narrative, FaceID, Phone or WhatsApp) means your plan does not include it; the tooltip names the plan that does, and selecting the tab opens Plan & Quota. If New character shows You have reached your character limit, delete a character you no longer need or select See plans. Clone character counts against the same limit. The plan menu in the top bar shows how much of each limit you have used. Plans and quota

WhatsApp messages get no answer

Open Channels › WhatsApp in the top bar. If it says WhatsApp Business is not connected yet, open My workspace › Settings › WhatsApp Business, select Test the connection and Connect the webhook, and give the number to a character under Numbers and characters. On that character, open Channels › WhatsApp in the editor and check that it is Enabled. A character with a realtime voice model (Gemini Live or OpenAI Realtime) cannot answer on WhatsApp; choose another model in Core AI. In the inbox, a conversation marked An operator answers waits for a person: select Hand back to the bot to let the character reply again. WhatsApp only allows replies within 24 hours of the guest’s last message. WhatsApp guide

Academy questions

IssueCheck
Q&A asks for a pageVerify that the selected lesson type is Soru-cevap. Pages, prewritten questions and board content are optional in that mode.
A student cannot download a PDFCheck processing status, teacher access and whether the source is shared for download or belongs to the assigned lesson.
A quiz waits instead of solving itselfThe student answers the question first. The lesson then evaluates the answer and continues; it is not an automatic answer reveal.
Another AI report cannot be generated todayEach teacher can generate one report per student per day. The previous report remains available; use the next allowed generation time shown in Academy.
The student has time with another teacherPackage balances belong to the selected teacher. Check the balance for the teacher whose avatar the student is opening.

Teacher guide · Student guide

What to send to support

Use support and community for the appropriate channel. Do not post keys or private records in public places.

Updated . Your available options depend on the character and your plan.

IAMX AI STUDIO