# widget-embedding

widget-embedding guides the integration of ElevenLabs voice conversation widgets into web projects, handling visual styles, mobile layouts, and secure access.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 78316 repo stars
- Author: calesthio
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/calesthio/OpenMontage/tree/HEAD/.agents/skills/agents/references/widget-embedding.md
- Updated: 2026-10-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/widget-embedding

## What it does

This subagent assists with embedding the `<elevenlabs-convai>` custom element into web pages. It supplies patterns for script injection, configuring orb color schemes, swapping avatar icons, and adjusting status captions.

It also details JavaScript methods like `startConversation()` and `endConversation()` alongside Shadow DOM custom properties for responsive sizing. Frontend setups include component snippets tailored for React, Vue, and Next.js.

Direct agent identifiers function solely with unauthenticated public bots: private setups strictly require your backend to issue signed URLs.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/agents/widget-embedding.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/widget-embedding.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/widget-embedding.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/calesthio/OpenMontage/tree/HEAD/.agents/skills/agents/references/widget-embedding.md

## When to use it
- Embed an interactive ElevenLabs voice assistant button on a web page
- Style the floating widget with custom colors and avatar images
- Trigger conversations programmatically using JavaScript event listeners
- Pass secure signed URLs to private voice agents from a backend API

## Example prompts
- Embed the ElevenLabs voice widget with a custom start button and hidden default container
- Show me how to fetch a signed URL in Python and supply it to the conversational widget
- Create a Vue component that registers the convai script and embeds the agent element

## Similar
- [agents](https://affpapa.org/en/nevibecode/skills/agents.md) — skill · 14700 installs
- [flutter-add-widget-preview](https://affpapa.org/en/nevibecode/skills/flutter-add-widget-preview.md) — skill · 40000 installs
- [platform-lightning-type-widget-coordinate](https://affpapa.org/en/nevibecode/skills/platform-lightning-type-widget-coordinate.md) — skill · 3400 installs
- [text-to-speech](https://affpapa.org/en/nevibecode/skills/text-to-speech.md) — skill · 22900 installs
- [voice-ai-development](https://affpapa.org/en/nevibecode/skills/sickn33-voice-ai-development.md) — skill · 972 installs
- [pp-elevenlabs](https://affpapa.org/en/nevibecode/skills/pp-elevenlabs.md) — skill · 165 installs

From the same set: [calesthio/openmontage](https://affpapa.org/en/nevibecode/by/calesthio/openmontage.md) — 101 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
