Skip to main content
The Avatar Embed Widget lets you drop your Digital Twin’s animated, talking avatar onto any website. Visitors click the launcher, grant microphone access, and speak with the avatar — no Pria account, no login. Your Digital Twin stays the brain (instructions, knowledge vault, configured tools); the avatar handles voice and video.
The widget requires an Anam avatar configured on the Digital Twin (avatar, voice, intro message). Set that up first — see Anam Avatar.
Cost warning. Every anonymous visitor conversation consumes the Digital Twin’s pooled credits. Always restrict the origin allowlist and set sensible usage limits before going live.

​
How it works

Visitor's browser → widget loader → Pria public embed endpoint → avatar session
       (embed key only)                  (origin-checked)        (your Twin answers)
  • The browser only ever holds a public embed key and a short-lived session token kept in memory — nothing is written to cookies or local storage, and no server API keys or Pria app credentials are involved.
  • Sessions are anonymous — no per-user memory or conversation history is created.
  • The avatar’s answers come from your Digital Twin’s configured conversation model and knowledge, restricted to read-only tools (e.g. searching the Twin’s documents). The widget cannot trigger actions like sending email.

​
Create an embed (admin)

1

Open Avatar Embeds

In the Admin dashboard, open your Digital Twin instance and go to the Avatar Embeds section. It confirms your Anam avatar/voice binding — if it warns that no avatar is configured, finish the Anam setup first.
2

Create a new embed

Click New embed and fill in:
  • Name — for your own reference.
  • Allowed origins (required) — exact scheme://host[:port] values, one per line (e.g. https://example.com, http://localhost:3000). No wildcards, no paths. Only pages served from these origins can use the widget.
  • Display — title, greeting, theme, accent color, launcher label, placeholder image.
  • Limits — sessions per day, turns per session, session duration, concurrent sessions, and a daily credit ceiling.
3

Copy the embed key and snippets

Saving generates a browser-safe embed key. The Snippets panel on each embed row gives you copy-paste install code for both the script tag and the React component.

​
Install the widget

​
Script tag (any site)

<script src="https://pria.praxislxp.com/avatar-widget/v1/loader.js"
        data-embed-key="YOUR_EMBED_KEY"
        data-mount="#pria-avatar"
        data-api-base-url="https://pria.praxislxp.com/api/public/avatar/embed"
        async></script>
<div id="pria-avatar"></div>
The loader adds a single window.PriaAvatar global and one scoped stylesheet. Multiple widgets per page are supported when each has its own mount element. You can also mount imperatively: 
window.PriaAvatar.mount({ embedKey: 'YOUR_EMBED_KEY', mount: '#pria-avatar' });

​
React component

import { PriaAvatarWidget } from '@praxis/avatar-widget';

<PriaAvatarWidget
  embedKey="YOUR_EMBED_KEY"
  apiBaseUrl="https://pria.praxislxp.com/api/public/avatar/embed"
  theme="light"          // 'light' | 'dark'
  mode="launcher"        // 'launcher' (floating button) | 'inline' (embedded panel)
  onSessionStart={() => {}}
  onSessionEnd={() => {}}
  onError={(e) => {}}
/>

​
Lifecycle controls

From the Avatar Embeds admin panel you can manage each embed at any time:
ActionEffect
Rotate keyIssues a new embed key (update your site’s snippet)
Disable / EnableTemporarily turns the embed off/on
RevokePermanently invalidates the key
DeleteRemoves the embed configuration
Disable and revoke take effect on the visitor’s next request — fail-closed.

​
Billing behaviour

Each completed voice turn is billed server-side against the institution’s pooled credits the moment the turn finishes. If a visitor closes the tab mid-conversation, completed turns are already accounted for and abandoned sessions are closed automatically — nothing is double-charged. The per-embed daily credit ceiling caps worst-case spend.

​
Troubleshooting

SymptomFix
Widget shows an error immediatelyCheck the embed key is correct, the embed is enabled, and avatar embedding is enabled for the Digital Twin
403 Forbidden in the network tabThe page’s origin isn’t in the Allowed origins list — entries must match exactly (scheme, host, port)
Avatar never connectsVerify the Anam avatar/voice binding on the Digital Twin and the Anam account status
Sessions end abruptlyYou may be hitting the per-embed limits (turns per session, session duration, daily credit ceiling)