Skip to main content
“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