“Start the conversation from this site.” (403)
- The route only accepts browser requests from a page on the same origin, including the scheme and port. Call it from your own site
- If a proxy in front of your app changes the
Host header, set APP_ORIGIN to your public origin, such as https://example.com
“Couldn’t verify this request. Try again.” (401)
- Each start gets a new ticket that works once, within two minutes. Click Start again
- Check that
SESSION_SECRET is set, at least 32 characters, and the same on every server instance
- If you run several instances, keep redeemed tickets in a shared store such as Redis
“Couldn’t connect to the ElevenLabs agent.”
- Check the server logs for the ElevenLabs status code
- Verify
ELEVENLABS_API_KEY is set and valid
- Confirm
ELEVENLABS_AGENT_ID 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 supports Cara-4.1 Express and
avatarModel is set to cara-4.1-express
- 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
“Couldn’t create the Anam session.”
- Check the server logs for the Anam status code
- Check that
ANAM_AVATAR_ID 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 November 20, 2026