Summary
This is a symptom-based troubleshooting guide for when your LiveAvatar integration breaks. It covers the most common failure modes: silent avatars (usually missing context_id in FULL mode), garbled audio (wrong PCM format in LITE), auth header mixups between endpoints, and dropped WebSocket events. The format is practical, each section starts with "most likely cause" and gives you a checklist or quick fix. Particularly useful is the side-by-side comparison of FULL vs LITE event systems, since mixing them is apparently a frequent mistake. If you're building against HeyGen's LiveAvatar API and hitting weird behavior with no clear error messages, this will save you hours of guessing.
Install to Claude Code
npx -y skills add heygen-com/liveavatar-agent-skills --skill liveavatar-debug --agent claude-codeInstalls into .claude/skills of the current project.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Files
SKILL.md
Select a file.
Featured
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
