@claracom/convai-widget-embed
v1.0.2
Published
Drop-in build of @elevenlabs/convai-widget-embed with Clara footer (same ElevenLabs UI + ConvAI behavior).
Maintainers
Readme
@claracom/convai-widget-embed
Same bundle as @elevenlabs/convai-widget-embed (ElevenLabs ConvAI widget UI and session). Only the default “Powered by” link is changed: ElevenAgents → Clara, default https://elevenlabs.io/agents → https://www.askclara.co.
This is not the separate clara-convai-widget UI—it is the vendor minified dist/index.js with a tiny string patch (scripts/build-fork.mjs).
Use
Webhook API (production): swiftclinic-webhook-api prebuild builds this package and copy-widget.js writesdist/public/clara-convai-widget-embed.js. It is served at /public/clara-convai-widget-embed.js.
Clara Admin’s widget cleaner defaults to {NEXT_PUBLIC_WEBHOOK_API_URL}/public/clara-convai-widget-embed.js.
npm / CDN (optional):
<elevenlabs-convai agent-id="agent_…"></elevenlabs-convai>
<script
src="https://unpkg.com/@claracom/[email protected]/dist/index.js"
async
type="text/javascript"
></script>override-link on the element still overrides the href when set.
First-time: npm org @claracom
- On npmjs.com, ensure the
claracomorganization exists and your npm user can publish scoped packages under@claracom(or change thenameinpackage.jsonto a scope you own). - Ensure your npm user is a member of that org with permission to publish packages.
Publish (local)
cd clara-convai-widget-embed
npm install
npm login # if not already logged in
npm publish --access publicScoped packages must use --access public on the first publish (publishConfig.access is already set).
Publish (GitHub Actions)
- Create an npm Access Token (type: Automation or Publish) at npmjs.com/settings/tokens.
- In the repo: Settings → Secrets and variables → Actions → add
NPM_TOKEN(user or org token with publish rights to@claracom). - Run workflow Publish @claracom/convai-widget-embed (Actions tab → workflow_dispatch).
After upstream changes
When ElevenLabs ships a new convai-widget-embed, bump devDependencies["@elevenlabs/convai-widget-embed"], run npm install, run build, fix scripts/build-fork.mjs if minified strings moved, then semver-bump this package and publish again.
Legal
ElevenLabs package is MIT. This package redistributes a modified build; keep their license notice in your product docs as appropriate.
