> ## Documentation Index
> Fetch the complete documentation index at: https://anam.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshoot ElevenLabs Agents

> Resolve ElevenLabs signed URL failures, connection problems, missing Director Notes, client-tool issues, and avatar playback errors.

**"Failed to get ElevenLabs signed URL"**

* Verify `ELEVENLABS_API_KEY` is set and valid
* Confirm the `agentId` matches an agent in your ElevenLabs dashboard
* Check that your ElevenLabs plan includes Conversational AI access

**Avatar connects but no conversation starts**

* The signed URL may have expired. Create the session token right before the client needs it, not minutes in advance
* Verify the ElevenLabs agent is active and not paused in the dashboard

**Director Notes status stays "waiting"**

* Confirm the avatar is a Cara 4 avatar and `avatarModel` is set to `cara-4`
* Select Eleven v4 Turbo, Eleven v4, or v3 Conversational in ElevenLabs and prompt the agent to emit one of the [recognized tags](/docs/integrations/elevenlabs/director-notes)
* Check the response transcript in ElevenLabs to confirm the LLM produced the tag
* Confirm the Anam engine build includes the ElevenLabs Director Notes aliases

**Client tool status stays "ready"**

* Confirm the tool type is **Client** in ElevenLabs
* Match the registered tool and parameter names exactly; they are case-sensitive
* Enable **Wait for response** if the agent needs to receive the handler's returned string

**"Anam API error: 400" when creating the session token**

* Check that `avatarId` is valid. Find available avatars at [lab.anam.ai/avatars](https://lab.anam.ai/avatars)
* Make sure the `elevenLabsAgentSettings` object includes both `signedUrl` and `agentId`

**Avatar lips not syncing / no audio**

* Anam matches the agent's output audio format automatically. If you hit this, check the ElevenLabs agent configuration and make sure it's using a supported voice model

**Session recordings not appearing in Anam Lab**

* Recordings are generated after the session ends. Allow a few minutes for processing
* Check the session completed cleanly (the client called `stopStreaming()` or the connection closed normally)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.