“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
- 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
- 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)
Last modified on October 8, 2026
