Key-only embed bootstrap for @voicethere/client
September 25, 2026 · release
@voicethere/client 0.9.0
@voicethere/client 0.9.0 adds CDN bootstrap for the floating embed: pass only your client API key (vtc_…) and mode, and the browser loads bootstrap.json from the VoiceThere CDN (keyed by a hash of the key). That document carries projectId, the sessions API base, and optional published widget appearance — without putting secrets in public JSON.
What changes for integrators
- Production:
createVoiceThereWidgetAsync({ clientKey, mode: "chat" })— no inlineprojectId,apiBase, orconfigUrlrequired when bootstrap is available. - Staging / custom sessions host: add
apiBaseso the client pairs with the staging CDN. - Legacy: inline
projectId,apiBase, andconfigUrlcontinue to work.
The dashboard Access embed snippet is pinned to 0.9.0 and uses the key-only shape on production hosts.
Try it
- Docs: Embed widget designer (Key-only embed section)
- API reference: npm client — Embed widget
- Browser notes: Browser client
npm install @voicethere/client@0.9.0
Keep your site origins on Access → Allowed web origins so browser sessions can call the sessions API with your client key. See Browser CORS origins.